Skip to content
Última actualización

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.

Importante: Acuerdos de usuario (consentimiento)

Antes de realizar cualquier solicitud de pago, debes:

  1. Obtener el consentimiento explícito de tus usuarios, autorizándote a debitar fondos de sus cuentas.
  2. Mantener evidencia documentada de este consentimiento.

Instrucciones

Para cargar pagos de débito directo en masa:

  1. En tu panel de control de Débito Directo, ve a PagosImportaciones de Pagos (Sandbox | Producción).

  2. Haz clic en Importar.

  3. En la pantalla de Seleccionar importación, haz clic en Descargar Plantilla.

  4. 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).

  5. 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.

  6. Verifica que la salida en la pantalla de Seleccionar importación sea correcta y haz clic en Subir importación.

  7. 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.

  8. 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

¿Deseas debitar fondos de un negocio?

Si estás debitando fondos de un negocio, simplemente agrega su nombre en ambas columnas de Primer nombre y Apellidos.

CampoEjemploRequeridoDescripciónValidación
Primer nombreIncredibleEl primer nombre de tu cliente.No más de 50 caracteres.
ApellidosPhantomEl apellido de tu cliente.No más de 50 caracteres.
Tipo de IDmx_curpEl 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. IDPHI740220IÑ0El número de identificación asociado con el tipo de ID.El número debe corresponder con el tipo de ID.
Teléfono+526351994215NoEl 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).
Emailg.champion@supermail.comLa dirección de correo electrónico de tu cliente.Debe ser un correo electrónico válido.
Cuenta CLABE o Tarjeta014893080663470004El 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 bancarioMonthly car paymentNoUna descripción para mostrar en el estado de cuenta bancario de tu cliente.No más de 80 caracteres.
Referencia Única clienteDebito 89000982349Sí*Tu referencia interna para la solicitud de pago.No más de 80 caracteres.
Importe a cobrar6000Sí*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_banxicoSolo 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 contrato8789-02342-XRTNoTu referencia para el préstamo asociado con la solicitud de pago.No más de 50 caracteres.
Monto total del préstamo946.65NoEl monto total del préstamo.
Fecha de contrato2024-05-28NoLa fecha del contrato del préstamo, en formato YYYY-MM-DD.
Cantidad de pagos12NoEl número total de cuotas del préstamo.
Fecha de pago2025-03-28NoLa fecha de vencimiento de la cuota a pagar, en formato YYYY-MM-DD.
Número de este pago10NoEl número de cuota que se está pagando.
Importe de este pago502.57NoEl 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:

EstadoDescripción
validatingEl estado inicial de cualquier archivo subido. Aquí verificamos el resto de tu archivo en busca de errores.
failedEl archivo tiene errores y no puede ser importado. Por favor, revisa los errores y vuelve a subir el archivo.
ready_to_sendHemos verificado tu archivo y no tiene errores. Ahora puedes enviarlo para su procesamiento.
processingCreamos 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.
processedLos 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:

  1. 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.
  2. 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.