Modelos Operativos
Descripción General
La plataforma Passport PaaS soporta múltiples modelos de jerarquía de comercios para adaptarse a diferentes estructuras comerciales y operativas. Este documento describe los tres modelos más comunes utilizados por las organizaciones y sus clientes: Modo Sucursal de Comercio, Semicentralizado y Agregador.
Modelos de Comercio Soportados
Modo Sucursal de Comercio
En este modelo, los comercios tienen la flexibilidad de seleccionar una sola cuenta o cuentas individuales para cada una de sus sucursales. Por ejemplo, como se ilustra a continuación, un comercio puede operar bajo una marca principal y, al mismo tiempo, gestionar cada sucursal de forma diferenciada, con cada ubicación vinculada a su propia cuenta de comercio dedicada.
Este enfoque permite una administración y reporte financiero a la medida, garantizando que cada sucursal pueda operar de forma autónoma mientras sigue siendo parte de la marca principal.
Diagrama Modelo Descentralizado
Ejemplo: Modelo Descentralizado
- Cada sucursal de comercio se incorpora como una entidad independiente.
- Cada sucursal cuenta con su propia cuenta de comercio y flujo de liquidación.
- Es útil cuando cada ubicación opera de manera independiente y requiere autonomía en reportes, conciliación y operaciones.
Notas de Implementación
- Crear una entidad de comercio por ubicación utilizando el endpoint Crear Cliente.
- Vincular una cuenta de comercio dedicada usando Vincular Cuenta.
- Para Crear Llave Bre-B que será vinculada a la cuenta y los Códigos QR para compras en tienda o en línea.
- Los Webhooks se pueden configurar por cuenta para notificaciones en tiempo real (próximamente).
Modelo Semicentralizado (Gestionado por Plataforma)
En este modelo, el proveedor de la plataforma, como un gateway de pagos, tiene la capacidad de acceder y administrar cuentas de comercio a través de múltiples sucursales o distintos clientes.
Diagrama Modelo Semicentralizado
Ejemplo: Modelo Semicentralizado
- El proveedor de la plataforma administra las cuentas de comercio en nombre de uno o varios clientes.
Notas de Implementación
- El proveedor de la plataforma utiliza sus credenciales para incorporar comercios o subcomercios.
- Las cuentas de comercio aún se crean por sucursal.
- Los Webhooks se pueden configurar por cuenta para notificaciones en tiempo real (próximamente).
- Crear una entidad de comercio usando el endpoint Crear Cliente.
- Crear Llave Bre-B que será vinculada a la(s) cuenta(s) y los Códigos QR para compras en tienda o en línea.
- Vincular una cuenta de comercio dedicada usando Vincular Cuenta.
Modelo Agregador
En este modelo, una única entidad de comercio, como una pasarela de pagos (Agregador), es responsable de administrar internamente múltiples cuentas de pago. Aunque solo se crea una entidad cliente con su propio perfil, el sistema permite la creación de una o más cuentas de comercio.
Diagrama Modelo Agregador
Ejemplo: Modelo Agregador
- Una única entidad de comercio, denominada Agregador, administra múltiples cuentas de pago dentro de su estructura interna.
- Es utilizado frecuentemente por marketplaces o super-apps.
Notas de Implementación
- Solo se crea una entidad cliente (su propio perfil).
- Se pueden crear una o más cuentas de comercio.
Implicación en la Experiencia del Usuario
En el modelo Bre-B, al iniciar un pago, ya sea por parte del cliente o del usuario final que realiza un pago hacia su cliente, un paso crítico es la Resolución de la Llave, la cual se ejecuta automáticamente por la plataforma Passport PaaS.
Este proceso devuelve los detalles del titular de la cuenta (ver el objeto breb_resolved_key a continuación):
{ "breb_resolved_key": { "second_last_name": "Rodriguez", "identification_type": "CC", "account_type": "SAVINGS", "account_number": "03693105175", "first_name": "Alberto", "second_name": "Daniel", "first_last_name": "Benhumea", "identification_number": "000000HUGO0001001" }, "payment": { "breb_recipient_id": "8960ab35-0510-496f-970e-32073e99c13e", "account_id": "5acacacf-23e5-434a-af80-4a91aafc1612", "amount": { "currency": "COP", "value": "100000" }, "id": "626927cc-7caa-4f9e-8bf2-18bb2aa34f4d", "reference": "Cafe - Juan Valdez tienda abc", "status": "PENDING" }}- Se utiliza para mostrar, dentro de la aplicación bancaria del usuario, los detalles del pago de un servicio, incluyendo la información del titular de la cuenta, garantizando la transparencia requerida por la red Bre-B.
Dependiendo del Modelo Operativo utilizado, los detalles presentados al usuario pueden variar.
- Por ejemplo, en el modelo agregador, se mostrarán los datos de la pasarela de pagos o Agregador, en lugar de la información del comercio.
- Como resultado, los usuarios no tendrán acceso directo a los datos del comercio al que están pagando.