Con la función de Importación de Pagos de Belvo, puedes realizar pagos por débito directo en masa de manera sencilla. Solo necesitas cargar un archivo CSV con todos los datos requeridos sobre tus clientes, y Belvo creará automáticamente el cliente en nuestro sistema, registrará el método de pago y luego procesará la solicitud de pago.
También puedes usar esta función para simplemente crear clientes y métodos de pago en masa sin realizar solicitudes de pago. Para hacer esto, simplemente omite los campos Referencia Única cliente e Importe a cobrar en tu CSV. Belvo creará los clientes y métodos de pago, y podrás realizar solicitudes de pago en una fecha posterior.
Antes de realizar cualquier solicitud de pago, debes:
- Obtener el consentimiento explícito de tus usuarios, autorizándote a debitar fondos de sus cuentas.
- Mantener evidencia documentada de este consentimiento.
Con Belvo, puedes hacer esto de las siguientes maneras:
- Cargando los consentimientos en masa usando nuestra función de Carga Masiva de Consentimientos.
- Usando nuestra API de Consentimiento para crear consentimientos de manera programática. Para facilitar las cosas al principio, intenta usar nuestra Colección de Postman para Débito Directo en México para cargar los consentimientos.
Para cargar pagos por domiciliación bancaria en masa:
En tu panel de control de Domiciliación Bancaria, ve a Pagos → Importaciones de Pagos (Sandbox | Producción).
Haz clic en Importar.
En la pantalla de Seleccionar importación, haz clic en Descargar Plantilla.
Llena el archivo CSV descargado con los campos requeridos (para más información, consulta la sección de Plantillas de archivo de importación en masa).
Sube tu CSV haciendo clic en el botón Subir en la pantalla de Seleccionar importación.
Nuestro sistema realizará una verificación en las primeras 100 filas para validar si el CSV subido tiene todos los campos requeridos en los formatos correctos. Si el sistema detecta algún problema, recibirás una lista de errores en la pantalla de Seleccionar importación.
Verifica que la salida en la pantalla de Seleccionar importación sea correcta y haz clic en Subir importación.
Validación Completa del ArchivoUna vez que subas tu archivo, establecemos el estado a validando (donde nuestro sistema comenzará a validar el resto de tu archivo para confirmar que toda la información está en el formato correcto. Si hay algún error en el resto del archivo, la importación fallará). Una vez que todo esté confirmado, el estado se establecerá en ready_to_send y podrás proceder al siguiente paso.
Cuando el estado del archivo sea ready_to_send, puedes finalizar el proceso haciendo clic en Enviar en la columna de Acciones.
Belvo ahora procesará tu archivo en segundo plano, creando clientes, registrando los métodos de pago y luego procesando los pagos. Una vez que el estado sea processed, tus pagos se realizarán de acuerdo con los tiempos de registro y pago del país.
Hay una plantilla específica que debes completar para poder usar esta función (puedes encontrar la versión más actualizada de la plantilla en la pantalla de Importación Masiva). En la tabla a continuación, describimos cada uno de los campos que necesitas completar.
Si estás debitando fondos de un negocio, simplemente agrega su nombre en ambas columnas Primer nombre y Apellidos.
También puedes usar esta función para simplemente crear clientes y métodos de pago en masa sin realizar ninguna solicitud de pago. Para hacer esto, simplemente omite los campos Referencia Única cliente e Importe a cobrar en tu CSV. Belvo creará los clientes y métodos de pago, y podrás realizar solicitudes de pago en una fecha posterior.
| Campo | Ejemplo | Requerido | Descripción | Validación |
|---|---|---|---|---|
| Primer nombre | Incredible | Sí | El primer nombre de tu cliente. | No más de 50 caracteres. |
| Apellidos | Phantom | Sí | El apellido de tu cliente. | No más de 50 caracteres. |
| Tipo de ID | mx_curp | Sí | El tipo de ID de tu cliente. Para México, esto puede ser mx_curp o mx_rfc. | Solo puede ser mx_curp o mx_rfc. |
| No. ID | PHI740220IÑ0 | Sí | El número de identificación asociado con el tipo de ID. | El número debe corresponder con el tipo de ID. |
| Teléfono | +526351994215 | No | El número de teléfono de tu cliente. Para México, debe estar precedido por +52. | El número debe comenzar con el código de marcación internacional de México (+52). |
| g.champion@supermail.com | Sí | La dirección de correo electrónico de tu cliente. | Debe ser un correo electrónico válido. | |
| Cuenta CLABE o Tarjeta | 014893080663470004 | Sí | El número de cuenta bancaria o tarjeta de débito. | Debe tener entre 15 y 19 caracteres y ser de una de nuestras instituciones compatibles. |
| Referencia reflejada en extracto bancario | Monthly car payment | No | Una descripción para mostrar en el estado de cuenta bancario de tu cliente. | No más de 80 caracteres. |
| Referencia Única cliente | Debito 89000982349 | Puede omitirse para solo crear clientes y métodos de pago. Para realizar solicitudes de pago, debes incluirlo. | Tu referencia interna para la solicitud de pago. | No más de 80 caracteres. |
| Importe a cobrar | 6000 | Puede omitirse para solo crear clientes y métodos de pago. Para realizar solicitudes de pago, debes incluirlo. | El monto a solicitar. Para México, será en Pesos Mexicanos (MXP). | El valor a cobrar al cliente, hasta dos decimales (por ejemplo, 3425.29). |
| Banco* | mx_banxico | Solo para tarjetas de débito* | El banco en el que está registrada la tarjeta de débito. | Por favor selecciona del menú desplegable en la hoja de cálculo. |
| Identificador de contrato | 8789-02342-XRT | No | Tu referencia para el préstamo asociado con la solicitud de pago. | No más de 50 caracteres. |
| Monto total del préstamo | 946.65 | No | El monto total del préstamo. | – |
| Fecha de contrato | 2024-05-28 | No | La fecha del contrato del préstamo, en formato YYYY-MM-DD. | – |
| Cantidad de pagos | 12 | No | El número total de cuotas del préstamo. | – |
| Fecha de pago | 2025-03-28 | No | La fecha de vencimiento de la cuota que se está pagando, en formato YYYY-MM-DD. | – |
| Número de este pago | 10 | No | El número de cuota que se está pagando. | – |
| Importe de este pago | 502.57 | No | El monto de la cuota que se está pagando. | – |
* Si el banco (Banco) está presente, el cargo siempre se procesará como una tarjeta de débito. Si no está presente, siempre se procesará como un cargo CLABE.
Un archivo subido pasa por los siguientes estados:
| Estado | Descripción |
|---|---|
validating | El estado inicial de cualquier archivo subido. Aquí verificamos el resto de tu archivo en busca de errores. |
failed | El archivo tiene errores y no puede ser importado. Por favor, revisa los errores y vuelve a subir el archivo. |
ready_to_send | Hemos verificado tu archivo y no tiene errores. Ahora puedes enviarlo para su procesamiento. |
processing | Creamos cualquier cliente que aún no exista en nuestro sistema, registramos métodos de pago con los bancos y luego enviamos las solicitudes de pago. |
processed | Los clientes, métodos de pago y solicitudes de pago han sido creados. Los pagos se procesarán de acuerdo con los tiempos de registro y pago del país. |
Puedes proporcionar hasta 50000 (cincuenta mil) filas en un archivo.
Nuestro sistema analiza inicialmente las primeras 100 filas de tu archivo. Esto también te permitirá verificar el resto de tu archivo para ver si hay otros errores similares.
No, puedes usar la función de importación por lotes para simplemente cargar una lista de clientes y sus métodos de pago. En una fecha posterior, puedes cargar el mismo CSV con la información de la referencia interna y el monto del pago.
Los clientes y los métodos de pago solo se crean cuando son nuevos. Si es un cliente y un método de pago existente, procederemos automáticamente a procesar el pago.
No, la función de importación por lotes no admite la actualización de la información personal existente de tus clientes.
Podría haber dos razones detrás de esto:
- Si anteriormente subiste un archivo con algunos de los mismos clientes y todavía estamos creando los métodos de pago o procesando solicitudes de pago para ellos, nuestro sistema no te permitirá agregar nuevos pagos para ese cliente hasta que hayamos procesado la solicitud anterior.
- Si subes dos archivos al mismo tiempo, el archivo anterior debe ser procesado antes de que se pueda procesar el siguiente archivo.
Las filas omitidas indican que no pudimos procesar al cliente y el método de pago porque hay otra solicitud de pago activa en el momento de la carga. Puedes ver las solicitudes de pago que fueron omitidas haciendo clic en el botón Mostrar omitidos en la columna Acciones.