Con nuestro producto de Débito Directo, tienes acceso a dos entornos para pruebas y pagos en el mundo real:
Recomendamos encarecidamente que mientras integras con Belvo, comiences con el entorno Sandbox y luego procedas a Producción.
Tenemos una Colección de Postman para Débito Directo en México dedicada que puedes usar para explorar y probar nuestros endpoints de la API de Débito Directo de manera rápida y sencilla. Asegúrate de seguir las instrucciones (especialmente en lo que respecta a bifurcar las variables de entorno y la autenticación) en la descripción de la colección para comenzar.
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, Generar 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 de Débito Directo (Sin Código) para comenzar con pagos simulados.
- Generar algunas claves de API de sandbox y Configurar un Débito Directo (API).
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 en 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, cadena aleatoria, o en blanco | La solicitud de pago sigue estos estados: initial -> processing -> successful. |
| Fallido | failed | La solicitud de pago sigue estos estados: initial -> processing -> failed. |
| Reversión | chargeback | La solicitud de pago sigue estos estados: initial -> processing -> successful->chargeback. |
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.
Para obtener tus claves de 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 de API. (Claves de API Sandbox | Claves de API Producción)
- Haz clic en Generar Claves de 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 de API se han generado con éxito.
Tenemos una Colección de Postman de Débito Directo México dedicada que puedes usar para explorar y probar nuestros endpoints de la API de Débito Directo de manera rápida y sencilla. Asegúrate de seguir las instrucciones (especialmente en lo que respecta a bifurcar las variables de Entorno y la autenticación) en la descripción de la colección para comenzar.
Después de generar tu Secret Key ID 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>'