Introducción
Con la función de Importación de Pagos de Belvo, puedes realizar fácilmente pagos por débito directo en masa. Todo lo que necesitas hacer es cargar un 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.
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.
Instrucciones
Para cargar pagos de débito directo en masa:
En tu panel de control de Débito Directo, 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 masiva).
Sube tu CSV haciendo clic en el botón Subir en la pantalla de Seleccionar importación.
Nota: 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.
Una 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. 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 procesado, tus pagos se realizarán de acuerdo con los tiempos de registro y pago para el país.
Plantillas de importación masiva de archivos
Para cada país, hay una plantilla específica que debes completar. Puedes encontrar la versión más actualizada de la plantilla en la pantalla de Importación por Lotes.
México
Si estás debitando fondos de un negocio, simplemente agrega su nombre en ambas columnas de Primer nombre y Apellidos.
| 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 | Sí* | Tu referencia interna para la solicitud de pago. | No más de 80 caracteres. |
| Importe a cobrar | 6000 | Sí* | 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 a pagar, 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. | – |
* En la carga inicial, puedes omitir estos campos. Belvo aún creará los clientes y métodos de pago.
** 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.
Estados de los archivos
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 para el país. |
¿Cuál es el número máximo de filas que puedo tener en un solo archivo?
Puedes proporcionar hasta 50,000 (cincuenta mil) filas en un archivo.
¿Cuántos errores se muestran en la pantalla de importación de selección?
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.
¿Tengo que incluir la referencia interna y el monto del pago en la carga inicial?
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.
¿Creas clientes y registras métodos de pago cada vez?
Los clientes y los métodos de pago solo se crean cuando son nuevos. Si es un cliente y método de pago existente, procederemos automáticamente a procesar el pago.
¿Actualizas la información personal existente del cliente?
No, la función de importación por lotes no admite la actualización de la información personal existente de tus clientes.
¿Por qué estoy recibiendo un error que indica que no puedo procesar un archivo?
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 el siguiente archivo pueda serlo.
¿Qué son las filas omitidas?
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.