Introducción
En esta guía vas a:
- Crear su cuenta en el Dashboard de Sandbox.
- Generar sus credenciales de API.
- Configurar Postman con su entorno.
- Ejecutar su primera solicitud autenticada.
Registro
Sigue estos pasos para crear tu perfil en la plataforma:
- Regístrate: Haz clic en "Registrarse" en el Tablero de Control de Sandbox.
- Ingresa tus datos: Nombre, Apellido, Correo electrónico, Nombre de tu empresa y una contraseña.
- Verifica tu correo: Revisa tu bandeja de entrada y completa la validación por email.
- Activa la Autenticación Multifactor (MFA): Protege tu cuenta con validación por SMS (pronto estarán disponibles más métodos de MFA).
- Ingresa el NIT de tu empresa: Asegúrate de que esté configurado y sea válido.
- Una vez ingreses el NIT, tendrás acceso completo al Dashboard.
Registro en el Sandbox
Tras completar el registro, el sistema tardará entre 5 y 10 segundos en configurar tu entorno.
🔒 Nota de seguridad: Actualmente la MFA es obligatoria vía SMS. Se habilitarán otras opciones en futuras actualizaciones.
Generación de Credenciales API
Puedes generar tus credenciales de API directamente desde el Dashboard. Estas llaves se usan para autenticar tus solicitudes a los endpoints de Passport.
¿Cómo obtener tus llaves API?
- En el Dashboard, ve a Platform.
- Abre API Key y copia el valor.
- Abre API Secret y copia el valor.
- Guarda ambas llaves en un lugar seguro y no las compartas.
No expongas tu API Secret en repositorios, logs o aplicaciones del lado del cliente. Trátala como una contraseña.
Obtención de la Clave API
Configuración de Postman
Para facilitar la integración, Passport ofrece una colección de Postman que puedes usar de inmediato para explorar las APIs.
Fork de la colección y variables de entorno
- Haz fork de la colección a tu cuenta de Postman para acceder a las últimas solicitudes.
- Haz fork del entorno para importar la configuración necesaria.
Copiando la Colección
Configura las Variables de Entorno
Una vez que hagas fork del entorno, ingresa tus credenciales API en las siguientes variables:
api_keyapi_secret
Estas variables almacenan tus credenciales de autenticación y automatizan las solicitudes, haciendo tu flujo de trabajo más eficiente.
Revisión de las Variables de Entorno
Explorando Casos de Uso
La colección de Postman incluye flujos reales como:
✅ Vincular Clientes
✅ Vincular Cuentas
✅ Crear Llaves Bre-B
✅ Gestionar Llaves Bre-B
✅ Crear Destinatarios de Pagos
✅ Iniciar Pagos a través de la infraestructura Bre-B
✅ Creación de Códigos QR
Pasos Siguientes
¡Todo listo! Con tu entorno de Sandbox configurado, explora nuestras guía de implementación en la siguiente sección y empieza a construir con Passport hoy mismo. 🚀