Reporting
La función de Exportaciones de Pagos de Belvo te permite extraer información sobre tus:
- Estados de cuenta (para conciliación)
- Métodos de Pago
- Solicitudes de Pago
En esta guía te explicaremos cómo generar cada tipo de informe y qué información puedes extraer de cada uno.
Statements
El informe de Statements es ideal para cuando deseas realizar la conciliación con tus datos. El informe te mostrará todos los movimientos de cargo, tarifa, contracargo y retiro que ocurrieron en tu cuenta de Belvo durante un período determinado.
- Un cargo es cuando se acreditó (depositó) dinero en tu cuenta de Belvo debido a un retiro exitoso de la cuenta de tu cliente.
- Una tarifa es cuando se debitó dinero de tu cuenta por procesar un pago.
- Un contracargo es cuando un cargo previamente exitoso fue impugnado por tu cliente, y Belvo debitó esa cantidad de tu cuenta.
- Un retiro es cuando el saldo de tu cuenta de Belvo fue transferido a tu cuenta bancaria.
Generar un reporte de estado de cuenta
Para generar un reporte de todos los movimientos en tu cuenta de Belvo:
En tu panel de control de Débito Directo:
Ve a Exportaciones de Pagos.
Haz clic en Crear.
En la ventana emergente de Exportar Pagos:
- Selecciona Statements (reconcile).
- Elige el rango de fechas para el reporte.
- Filtra qué movimientos deseas incluir (recomendamos Todos).
- Haz clic en Crear.
Tu reporte se generará en unos minutos. Una vez que se haya generado con éxito, podrás descargarlo usando el botón Hacer clic para descargar en la columna Archivo.
Campos del informe
El informe generado tendrá las siguientes columnas, con cada fila en el informe siendo un movimiento separado:
| Columna del Estado de Cuenta | Descripción | Ejemplo |
|---|---|---|
| id | El ID único del movimiento. | 8e8954e6-c9cb-4ede-b163-2f392f041df6 |
| createdDate | La fecha en que ocurrió el movimiento, en formato YYYY-MM-DD. | 2024-05-03 |
| type | El tipo de movimiento. Puede ser: credit (dinero depositado en tu cuenta) debit (dinero retirado de tu cuenta) | credit |
| reason | La razón del type de movimiento. Puede ser: charge (dinero fue exitosamente retirado de la cuenta de un usuario) fee (la tarifa por procesar el pago) chargeback (un débito de tu cuenta debido a un contracargo de tu cliente) withdrawal (transferencias de la cuenta de Belvo a tu cuenta bancaria real) | charge |
| amount | El monto del movimiento. | 270.00 |
| currency | La moneda del movimiento. | mxn |
| paymentRequestId | El ID de la solicitud de pago asociada. | 37a2d810-8ecb-4111-acb2-c80c164ea789 |
| reference | Tu referencia interna para la solicitud de pago. | J-7609S-776 |
| customerName | El nombre de tu cliente. | Juan Carlos Hernandez Garcia |
| customerDocumentType | El tipo de identificación de tu cliente. | mx_rfc |
| customerDocumentNumber | El número de identificación para el tipo de documento. | HEGJ820506M10 |
| paymentMethodType | El tipo de método de pago. | bank_account |
| accountNumber | El número de cuenta de tu cliente. | 002665000000000001 |
Movimientos de estado de cuenta
Una sola solicitud de pago tendrá entre dos y tres movimientos en un estado de cuenta dado. Por ejemplo:
Escenario exitoso (sin contracargo)
En el extracto de ejemplo a continuación, donde los fondos fueron retirados exitosamente de la cuenta de un cliente y depositados en tu cuenta de Belvo, puedes ver que hay dos entradas:
- Un crédito a tu cuenta (por los fondos retirados de la cuenta de tu cliente).
- Un débito de tu cuenta (la tarifa de procesamiento del pago).
| id | createdDate | type | reason | amount | reference | paymentRequestId |
|---|---|---|---|---|---|---|
| 8f3d5cda... | 2024-05-03 | credit | charge | 320.00 | J-7609S-776 | 3baedc06... |
| 8851b7e0... | 2024-05-03 | debit | fee | 4.00 | J-7609S-776 | 3baedc06... |
Escenario exitoso (con contracargo)
En el extracto de ejemplo a continuación, donde los fondos fueron retirados exitosamente de la cuenta de un cliente, depositados en tu cuenta de Belvo, pero retirados de tu cuenta debido a que tu cliente inició un contracargo, puedes ver que hay tres entradas:
- Un crédito a tu cuenta (por los fondos retirados de la cuenta de tu cliente).
- Un débito de tu cuenta (la tarifa de procesamiento del pago).
- Un débito de tu cuenta debido a un contracargo (por el monto del cargo inicial)
| id | createdDate | type | reason | amount | reference | paymentRequestId |
|---|---|---|---|---|---|---|
| 8f3d5cda... | 2024-05-03 | credit | charge | 270.00 | J-8710T-887 | ad54dbb0... |
| 8851b7e0... | 2024-05-03 | debit | fee | 4.00 | J-8710T-887 | ad54dbb0... |
| 12a93426... | 2024-05-23 | debit | chargeback | 270.00 | J-8710T-887 | ad54dbb0... |
Métodos de Pago
Los informes de Métodos de Pago te proporcionan una visión general de todas las cuentas bancarias que has registrado para tus clientes y su estado, permitiéndote obtener una visión rápida de qué métodos de pago están activos, aún pendientes de confirmación y fallidos.
Generar un informe de métodos de pago
Para generar un informe de todos los métodos de pago en tu cuenta de Belvo:
En tu panel de control de Débito Directo:
Ve a Exportaciones de Pagos.
Haz clic en Crear.
En la ventana emergente Exportar Pagos:
- Selecciona Métodos de Pago.
- Elige el rango de fechas para el informe.
- Filtra qué estados de tus métodos de pago deseas incluir (recomendamos Todos).
- Haz clic en Crear.
Tu informe se generará en unos minutos. Una vez que se haya generado con éxito, podrás descargarlo usando el botón Hacer clic para descargar en la columna Archivo.
Campos del informe
El informe generado tendrá las siguientes columnas, con cada fila en el informe siendo un método de pago separado:
| Columna del Método de Pago | Descripción | Ejemplo |
|---|---|---|
| id | ID único de Belvo para el método de pago. | 4b14e571-89b0-4d80-838e-282ecc4fcfca |
| createdDate | La fecha en que se creó el método de pago, en formato YYYY-MM-DD. | 2024-06-05 |
| lastUpdatedDate | La fecha en que el método de pago fue actualizado por última vez (por ejemplo, un cambio en el estado), en formato YYYY-MM-DD. | 2024-06-05 |
| customerDocumentType | El tipo de documento de identificación del cliente. | mx_rfc |
| customerDocumentNumber | El número de documento de identificación del cliente. | HEGJ820506M10 |
| accountBank | La institución donde se mantiene la cuenta. | mx_citi_banamex |
| accountType | El tipo de cuenta. | savings |
| accountNumber | El número de cuenta. | 002665000000000001 |
| reference | Tu referencia interna para el método de pago. | |
| status | El estado del método de pago. | pending_activation |
| failedReason | Si el método de pago falló, la razón del fallo. Para una lista completa de razones que pueden ser devueltas, consulta nuestro artículo dedicado a errores. | |
| failedMessage | Si el método de pago falló, el mensaje que explica el fallo. Para una lista completa de mensajes que pueden ser devueltos, consulta nuestro artículo dedicado a errores. |
Solicitudes de Pago
Los informes de Solicitudes de Pago te proporcionan una visión general de todas las solicitudes de pago que has creado para tus clientes y su estado, permitiéndote obtener una visión rápida de cuáles solicitudes de pago están activas, aún pendientes de confirmación y fallidas.
Los informes de Solicitudes de Pago solo muestran los cambios individuales de las solicitudes de pago para el período de tiempo. Sin embargo, puede haber situaciones en las que una solicitud de pago sea exitosa, pero dentro de los 90 días tu cliente inicie un contracargo, lo cual no aparecerá en el informe inicial. Para ver los movimientos completos que influyen en tu saldo, te recomendamos encarecidamente que utilices el informe de Estados de Cuenta
Generar un informe de solicitud de pago
Para generar un informe de todas las solicitudes de pago en tu cuenta de Belvo:
En tu panel de control de Débito Directo:
Ve a Exportaciones de Pagos.
Haz clic en Crear.
En la ventana emergente Exportar Pagos:
- Selecciona Solicitudes de Pago.
- Elige el rango de fechas para el informe.
- Filtra qué estados de tus solicitudes de pago deseas incluir (recomendamos Todos).
- Haz clic en Crear.
Tu informe se generará en unos minutos. Una vez que se haya generado con éxito, podrás descargarlo usando el botón Hacer clic para descargar en la columna Archivo.
Campos del informe
El informe generado tendrá las siguientes columnas, con cada fila en el informe siendo un cambio de estado de solicitud de pago separado:
| Columna de Solicitud de Pago | Descripción | Ejemplo |
|---|---|---|
| id | ID único de Belvo para la solicitud de pago. | 017d5c0a-2aee-496f-b938-dcb848f7348b |
| createdDate | La fecha en que se creó la solicitud de pago, en formato YYYY-MM-DD. | 2024-06-05 |
| lastUpdatedDate | La fecha en que se actualizó por última vez la solicitud de pago (por ejemplo, un cambio de estado), en formato YYYY-MM-DD. | 2024-06-05 |
| customerDocumentType | El tipo de documento de identificación del cliente. | mx_rfc |
| customerDocumentNumber | El número de documento de identificación del cliente. | HEGJ820506M10 |
| accountBank | La institución donde se mantiene la cuenta. | mx_citi_banamex |
| accountType | El tipo de cuenta. | savings |
| accountNumber | El número de cuenta. | 002665000000000001 |
| reference | Tu referencia interna para la solicitud de pago. | J-7609S-776 |
| displayReference | La descripción que se mostrará en la plataforma bancaria de tu cliente cuando se procese el pago. | |
| amount | El monto de la solicitud de pago (en MXN) | 500 |
| status | El estado de la solicitud de pago. | initial |
| failedReason | Si la solicitud de pago falló, la razón del fallo. Para una lista completa de razones que se pueden devolver, consulta nuestro artículo dedicado a errores. | |
| failedMessage | Si la solicitud de pago falló, el mensaje que explica el fallo. Para una lista completa de mensajes que se pueden devolver, consulta nuestro artículo dedicado a errores. |