Guía de flujo de instalación
El flujo de instalación es una parte muy importante del recorrido del Comerciante al utilizar las aplicaciones publicadas en la tienda de aplicaciones de Tienda Negocio. Por eso tenemos que asegurarnos de que este paso funcione sin ningún problema.
Por lo tanto, proporcionamos una guía sobre cómo debería funcionar el flujo de instalación de una aplicación en Tienda Negocio.
Requiere aprobación
Cuando se requiere la aprobación del socio para que el Comerciante comience a utilizar la aplicación, normalmente el flujo de instalación pasa por 3 pasos principales: generación del access_token, creación/aprobación de la cuenta y creación de recursos. Veamos más de cerca el diagrama a continuación:
Nota: Es muy importante tener en cuenta que la creación de recursos sólo debe realizarse si se aprueba la cuenta del Comerciante
1. Generación de acceso_token
a) Aceptar permisos: el flujo comienza cuando el comerciante va a la tienda de aplicaciones de Tienda Negocio para instalar la aplicación. Al hacer clic en instalar en la página de detalles de la aplicación, el comerciante será redirigido al administrador, donde deberá aceptar los permisos y continuar con la instalación.
b) GET /redirect_url?code: el Comerciante será redirigido a la URL configurada en la aplicación.
c) POST oauth/app/token: el Socio luego utiliza el authorization_code parámetro para generar el acceso_token.
Nota: Este proceso se detalla con más detalle en el Flujo de autorización .
2. Creación de cuenta
d) Crea una nueva cuenta: en este ejemplo estamos considerando a un comerciante que no tiene una cuenta en la aplicación, por lo que pasará por el flujo de registro donde deberá crear una nueva cuenta.
e) Aprueba cuenta: la aprobación de la cuenta depende enteramente del socio y se realiza de diferentes maneras. Cuando el Comerciante tenga su cuenta aprobada, es importante notificárselo (correo electrónico, sms, etc) para que pueda comenzar a utilizar la Aplicación.
3. Creación de recursos
f) Crea recursos: los recursos varían según el tipo de aplicación. Ejemplo: si es una aplicación de envío, creará un transportista de envío. Si es una aplicación de pagos, creará un proveedor de pagos. Si es una aplicación de marketing, tal vez un script. Aquí es importante asegurarse de que el recurso se cree solo después de que se haya aprobado la cuenta y que el recurso no se cree duplicado (para esto, primero deberá verificar si existe).
Cosas a evitar en el flujo de instalación:
- Crear recursos antes de que el Comerciante tenga su cuenta aprobada: esto causaría confusión, ya que en el administrador el comerciante vería, por ejemplo, creado un transportista o proveedor de pagos, pero no podría utilizarlos, ya que se requiere aprobación previa
- Al finalizar la aprobación, el Comerciante deberá pasar nuevamente por el proceso de instalación: esto genera un paso repetido, ya que el Comerciante ya ha realizado la instalación. Tener que rehacer la instalación puede dar una mala impresión de la integración.
No requiere aprobación
En este caso lo único que cambiaría es que no tendríamos que ejecutar el paso e), ya que no se requiere la aprobación de una cuenta. Por lo tanto, la creación de recursos podría ocurrir inmediatamente después de crear la nueva cuenta.
Algunos socios implementan un flujo aún más simple: la creación y aprobación de cuentas se realizan automáticamente. Los comerciantes no tienen que hacer nada más que aceptar los permisos de la aplicación y la cuenta se genera sin mayor interacción.
