Onboarding de Clientes
Descripción General
Esta guía te ayuda a comprender cómo registrar digitalmente nuevos clientes y vincular cuentas financieras para ellos usando la plataforma PaaS de Passport. El proceso es simple y eficaz: permite a tu entidad registrar clientes, vincular cuentas y prepararlos para pagos seguros y en tiempo real.
Al completar estos pasos, tus clientes estarán listos para realizar pagos y crear llaves dentro de nuestra infraestructura Bre-B.
Actualmente estamos mejorando el proceso de onboarding (KYB – Know Your Business). Pronto se solicitarán más datos del negocio. Por ahora, el entorno de Sandbox sigue siendo simple y solo requiere datos básicos para continuar con las pruebas.
Este flujo refleja lo que ocurre hoy en el entorno Sandbox, aunque algunos aspectos aún están en desarrollo. En Producción, el onboarding incluirá requisitos adicionales como declaraciones AML (anti-lavado de dinero) y documentos de respaldo. Estos elementos aún no están implementados ni en Sandbox ni en Producción.
Si gestionas pagos como empresa (especialmente si cuentas con una licencia de pagos), asegúrate de que los datos ingresados del cliente coincidan con la información legal registrada de tu negocio. Este paso equivale a registrar digitalmente tu empresa y te habilita para operar cuentas en el banco patrocinador.
Valor para tu Negocio
- Acelera el registro de clientes y el acceso a servicios financieros.
- Elimina papeleo manual y reduce errores operativos.
- Mejora la experiencia del usuario al incorporar clientes de forma rápida y digital.
Registra tu Cliente
Vincular una Cuenta Bancaria
Una vez generado el ID de Cliente y completados los procesos de vinculación de la cuenta bancaria, ahora se puede llevar a cabo el paso de enlace entre los objetos. Personas jurídicas, solo pueden tener el tipo de cuenta a continuación:
- ORDINARY: Para empresas, sin límites de monto.
Un cliente puede tener múltiples cuentas (relación 1:M).
Valor para tu Negocio
- Ofrece opciones de cuenta adaptadas a las necesidades del cliente.
- Activa el uso inmediato de los servicios financieros al crear cuentas disponibles al instante.
Formato de la Solicitud
- Usa el
idde cliente obtenido en la solicitud de crear cliente tipo Persona Jurídica.
| Parámetro | Descripción |
|---|---|
| entity_customer_id | ID del cliente obtenido en el paso anterior. |
| type | Tipo de cuenta: ORDINARY. |
Ejemplo de la Solicitud
curl --location 'https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/accounts' \--header 'Content-Type: application/json' \--header 'Authorization: TU_TOKEN_DE_ACCESO' \--data '{ "entity_customer_id": "5ae28bc6-49e1-4710-a2d9-7b2f0f488ecb", "type": "ORDINARY"}'Formato de la Respuesta
| Parámetro | Descripción |
|---|---|
| entity_customer_id | ID del cliente vinculado a la cuenta. |
| available_balance | Objeto que representa el saldo disponible. |
| available_balance.currency | Moneda de la cuenta (COP – peso colombiano). |
| available_balance.value | Monto disponible en la cuenta. |
| id | ID único de la cuenta. Necesario para operaciones futuras. |
| number | Número asignado internamente a la cuenta por el banco patrocinador. |
| type | Tipo de cuenta ORDINARY. |
| pending_balance | Objeto con los montos pendientes por liquidar. |
| pending_balance.currency | The currency type of the account (COP - Colombian Peso). |
| pending_balance.value | The monetary value of money in pending status for the account. |
La notación objeto.parámetro hace referencia a la relación jerárquica dentro de una respuesta JSON. Por ejemplo, pending_balance.currency indica el parámetro currency dentro del objeto pending_balance.
Próximos Pasos
Ahora que la cuenta del cliente está creada, el siguiente paso es crear una llave Bre-B, lo que habilita el uso de pagos instantáneos y seguros a través de nuestra infraestructura.
Soporte y Recursos
- Explora la Colección de Postman para ver ejemplos prácticos.
- Contacta a tu representante de Passport o a soporte técnico si necesitas asistencia adicional.