Environments
Con nuestro producto de Débito Directo, tienes acceso a dos entornos para pruebas y pagos en el mundo real:
Sandbox
Realmente recomendamos que mientras estés integrando con Belvo, comiences con el entorno Sandbox y luego procedas a Producción.
Disponible para:
- 🟢 Pagos (Débito Directo México)
Usa nuestro entorno Sandbox para construir tu integración. En este entorno, puedes:
- Usar nuestra herramienta de Importaciones Masivas sin código para simular pagos por lotes.
- Usar nuestra API para crear Customers, Payment Methods, Generate Agreements, y Payment Requests.
- Usar nuestras herramientas de Reportes para ver cómo funciona el proceso de conciliación.
Todo lo que necesitas para comenzar con el entorno Sandbox es registrarte en el portal Sandbox y verificar tu dirección de correo electrónico. Después de eso, dependiendo de tus necesidades, puedes:
- Seguir nuestra guía dedicada Importación Masiva de Pagos por Débito Directo (Sin Código) para comenzar con pagos simulados.
- Generar algunas sandbox API keys y Configurar un Débito Directo (API).
Actualizaciones de estado del Sandbox
Para imitar situaciones del mundo real, hemos proporcionado los siguientes flujos para métodos de pago y solicitudes:
Métodos de Pago
Al crear un método de pago, establece el bank a mx_santander.
Solicitudes de pago
Al realizar solicitudes de pago, dependiendo del flujo que desees probar, necesitarás proporcionar diferentes palabras clave como valor para el campo reference.
| Flujo | Referencia | Resultado |
|---|---|---|
| Éxito | successful | La solicitud de pago sigue estos estados: initial -> processing -> successful. |
| Fallido | failed | La solicitud de pago sigue estos estados: initial -> processing -> failed. |
| Contracargo | chargeback | La solicitud de pago sigue estos estados: initial -> processing -> successful->chargeback. |
| Predeterminado | (en blanco) | La solicitud de pago sigue estos estados: initial -> processing -> successful. |
Producción
Disponible para:
- 🟢 Pagos (Domiciliación Bancaria México)
Nuestro entorno de Producción te dará acceso a pagos reales hacia y desde cuentas utilizando la plataforma de Domiciliación Bancaria.
Después de haber probado tu integración en el entorno Sandbox y estés listo para pasar a producción, necesitarás contactar a nuestro equipo de soporte para acceder a nuestro entorno de Producción. Nuestro equipo de soporte se pondrá en contacto contigo para programar una reunión solo para asegurarse de que tus necesidades estén satisfechas, y luego solo necesitarás pasar por un proceso de certificación con uno de nuestros ingenieros para asegurarte de que tu integración esté funcionando de manera óptima.
Una vez que tu integración esté certificada, todo lo que necesitarás hacer es registrarte en el portal de Producción y verificar tu correo electrónico. Después de esto, si estás utilizando nuestra API necesitarás:
- Generar algunas claves de API de producción.
- Cambiar tus claves de API de Sandbox en tu código por las claves de API de Producción.
- Cambiar la URL base a la que haces solicitudes de api.sandbox.directdebit.belvo.com a api.directdebit.belvo.com.
- Configurar tu URL de webhook de producción.
Claves de API y Autenticación
Generar Claves API
Para obtener tus claves API:
- Inicia sesión en tu Portal de Débito Directo. (Inicio de Sesión Sandbox | Inicio de Sesión Producción)
- Ve a Desarrolladores -> Claves API. (Claves API Sandbox | Claves API Producción)
- Haz clic en Generar Claves API.
- Guarda tu Clave Secreta y Contraseña Secreta (solo se mostrarán una vez).
- Después de guardar y descargar tu clave secreta y contraseña, haz clic en Hecho.
✅ Tus claves API se han generado exitosamente.
Autenticación
Después de obtener tu Secret Key y Secret Password, proporciónalos en los encabezados correspondientes cada vez que realices una solicitud a un endpoint protegido.
curl --request <the_method> \
--url https://api.sandbox.directdebit.belvo.com/<the_endpoint>
--header 'api-key-id: <Your secret-key-id>' \
--header 'api-key-secret: <Your secret-password>'