Modelos Operativos
Descripción General
La plataforma Passport PaaS admite múltiples modelos de jerarquía de comercios para ajustarse a distintas estructuras comerciales y operativas. Este documento describe tres modelos comunes utilizados por las organizaciones y sus clientes: Modo Sucursal del Comercio, Semidescentralizado (gestionado por la plataforma) y Agregador.
Tabla Resumen
| Modelo | Titular de la Cuenta | Qué ve el pagador como titular (Resolución de Llave Bre-B) |
|---|---|---|
| Modo Sucursal del Comercio | Cada sucursal/ubicación | El nombre de la sucursal/comercio |
| Semidescentralizado | Comercio por marca; la plataforma puede gestionar de forma central | La marca del comercio |
| Agregador | Entidad Agregadora | Entidad Agregadora |
Estos modelos son ejemplos; puedes combinarlos según tu estructura operativa y estrategia.
Resolución de Llave
La resolución de llave es un paso obligatorio durante el pago en Bre-B. Sucede cuando se inicia el pago, ya sea mediante una transacción Llave-a-Llave o a través de códigos QR:
- Cuando el pagador introduce la Llave Bre-B en su app bancaria, la llave se resuelve y se muestran los datos del titular para dar transparencia sobre el destino de los fondos.
- Cuando se escanea el código QR en la app bancaria del pagador, Bre-B requiere una Llave vinculada al QR; al resolverse la llave, se muestran los datos del titular de la cuenta.
El modelo operativo afecta la experiencia del usuario porque los datos del titular de la cuenta se envían al pagador.
Modelos de Comercio Soportados
Modo Sucursal de Comercio
En este modelo, los comercios pueden elegir una única cuenta o cuentas individuales por cada subcomercio/sucursal. Por ejemplo, un comercio puede operar bajo una marca principal y administrar cada sucursal de forma independiente, donde cada ubicación está vinculada a su propia cuenta de comercio. Esto permite una gestión y reportes financieros personalizados, de modo que cada sucursal opere de forma autónoma dentro de la marca.

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)
El proveedor de la plataforma (p. ej., un gateway de pagos) puede acceder y gestionar cuentas de comercio a través de varias sucursales o 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 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
Una única entidad de comercio, como un gateway de pagos (Agregador), gestiona múltiples cuentas de pagointernamente. Aunque se crea una sola entidad de cliente con su propio perfil, el sistema permite crear 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.