Un método de pago es la cuenta bancaria que tú (o tu usuario) registras para que los fondos puedan ser retirados de ella. Para retirar fondos del método de pago, necesitarás crear una solicitud de pago.
Si estás usando nuestra función de Batch Imports, creamos automáticamente el método de pago durante el proceso.
Cuando creas un método de pago, pasará por el siguiente flujo para ser:
active: La institución financiera confirma los detalles de la cuenta bancaria y puedes retirar fondos de ella.error: La institución financiera no pudo confirmar la cuenta bancaria y no puedes retirar fondos de ella.

Puedes crear un método de pago utilizando cualquiera de nuestros:
- Dashboard
- API
- Importaciones por lotes
Si estás utilizando nuestra funcionalidad de Importaciones por lotes, el Método de Pago se crea automáticamente. Para más información, consulta nuestro artículo dedicado a la Importación Masiva de Pagos Directos.
Para crear un método de pago usando nuestro panel:
En tu panel de Débito Directo:
Ve a Métodos de Pago.
Haz clic en Crear.

En la ventana emergente Crear Método de Pago;
- Selecciona el Cliente al que se relaciona este método de pago.
- Selecciona el Banco donde se encuentra la cuenta del cliente.
- Selecciona el tipo de Cuenta: Ahorros para una cuenta CLABE, o Tarjeta de Débito para un número de tarjeta de débito.
- Proporciona el identificador de la cuenta: si seleccionaste Ahorros, ingresa la CLABE del cliente; si seleccionaste Tarjeta de Débito, ingresa el número de tarjeta de débito.
- Proporciona tu Referencia interna para este método de pago.
- Haz clic en Crear.

Ahora necesitarás obtener el Consentimiento de tu usuario para que la cuenta sea debitada. Para más información, consulta nuestro artículo dedicado al Consentimiento.
Para crear un método de pago usando nuestra API, solo necesitas hacer una solicitud POST para Crear un método de pago con el siguiente payload:
{
"customerId": "0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c",
"accountType": "savings",
"accountNumber": "445566790",
"bank": "mx_bancoppel",
"reference": "SAVINGS_445566790"
}| Parámetro | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
customerId | string (uuid) | Sí | El ID generado por Belvo para el cliente. | 0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c |
accountType | string (enum) | Sí | El tipo de cuenta bancaria o tarjeta. Puede ser savings (una cuenta CLABE) o debit_card (un número de tarjeta de débito). | savings |
accountNumber | string | Sí | El número de cuenta bancaria o de tarjeta de débito. Para savings, proporciona el número de cuenta CLABE; para debit_card, proporciona el número de tarjeta de débito. | "445566790" |
bank | string (enum) | Sí | La institución financiera donde se mantiene la cuenta bancaria. Para una lista completa de instituciones disponibles, consulta nuestro artículo dedicado a Instituciones. | mx_bancoppel |
reference | string | Sí | Tu referencia interna para el método de pago. | SAVINGS_445566790 |
El valor checking (también visto como checkings) para accountType está obsoleto y ya no debe usarse. Usa savings para una cuenta CLABE o debit_card para un número de tarjeta de débito.
Ahora necesitarás obtener el Consentimiento de tu usuario para que la cuenta sea debitada. Para más información, consulta nuestro artículo dedicado a Consentimiento.
En el diagrama a continuación, te proporcionamos los estados por los que puede pasar un método de pago. Si has implementado webhooks, recibirás una notificación para los estados indicados en púrpura.
Estado inicial cuando se crea el método de pago.
| Transiciones a | Disparador/Evento |
|---|---|
|
|
El método de pago está pendiente de confirmación por parte del cliente. Esto se puede hacer enviando un acuerdo generado por nuestro recurso de API de Acuerdos.
| Transiciones a | Disparador/Evento |
|---|---|
|
|
El método de pago está programado para ser enviado a la institución financiera para ser confirmado.
| Transiciones a | Disparador/Evento |
|---|---|
|
|
La institución financiera está evaluando el método de pago.
| Transiciones a | Disparador/Evento |
|---|---|
|
|
El método de pago está activo y los fondos pueden ser retirados.
Nota: El estado puede cambiar a inactive si el propietario cancela o elimina el método de pago dentro de su institución financiera.
| Transiciones a | Disparador/Evento |
|---|---|
Estado final - no hay más transiciones (ver la nota arriba respecto al estado inactive). |
La institución financiera no pudo confirmar el registro de la cuenta bancaria (generalmente debido a que el propietario proporcionó información incorrecta de la cuenta bancaria o un error en la institución financiera). El método de pago no puede ser utilizado.
| Transiciones a | Disparador/Evento |
|---|---|
| Estado final - no más transiciones |
El cliente ha cancelado su cuenta bancaria o ha eliminado su acuerdo para el método de pago dentro de su institución financiera. El método de pago no se puede usar.
| Transiciones a | Disparador/Evento |
|---|---|
| Estado final - no hay más transiciones |