Skip to content
Última actualización

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:

  1. Seguir nuestra guía dedicada Importación Masiva de Pagos por Débito Directo (Sin Código) para comenzar con pagos simulados.
  2. 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
ÉxitosuccessfulLa solicitud de pago sigue estos estados: initial -> processing -> successful.
FallidofailedLa solicitud de pago sigue estos estados: initial -> processing -> failed.
ContracargochargebackLa 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:

  1. Generar algunas claves de API de producción.
  2. Cambiar tus claves de API de Sandbox en tu código por las claves de API de Producción.
  3. Cambiar la URL base a la que haces solicitudes de api.sandbox.directdebit.belvo.com a api.directdebit.belvo.com.
  4. Configurar tu URL de webhook de producción.

Claves de API y Autenticación

Generar Claves API

Para obtener tus claves API:

  1. Inicia sesión en tu Portal de Débito Directo. (Inicio de Sesión Sandbox | Inicio de Sesión Producción)
  2. Ve a Desarrolladores -> Claves API. (Claves API Sandbox | Claves API Producción)
  3. Haz clic en Generar Claves API.
  4. Guarda tu Clave Secreta y Contraseña Secreta (solo se mostrarán una vez).
  5. 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>'