# Informes

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.

Disponibilidad de Generación de Informes
Todos los informes que se generan están disponibles en el panel durante siete días. Después de este período, los informes se eliminan del panel y necesitarás regenerarlos.

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

Glosario
- 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:

1. En tu panel de control de Débito Directo:
  1. Ve a **Exportaciones de Pagos**.
  2. Haz clic en **Crear**.
2. En la ventana emergente de Exportar Pagos:
  1. Selecciona **Statements (reconcile)**.
  2. Elige el rango de fechas para el reporte.
  3. Filtra qué movimientos deseas incluir (recomendamos **Todos**).
  4. Haz clic en **Crear**.


¡Hecho!
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 reporte

El reporte generado tendrá las siguientes columnas, con cada fila en el reporte 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` |
| **lastUpdatedDate** | La fecha en que el movimiento fue actualizado por última vez, en formato `YYYY-MM-DD`. | `2024-05-03` |
| **chargebackDate** | La fecha en que ocurrió un contracargo para este movimiento (si aplica), 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 para el `type` del 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` |
| **paymentRequest** | El ID de la solicitud de pago asociada. | `37a2d810-8ecb-4111-acb2-c80c164ea789` |
| **paymentRequestReference** | Tu referencia interna para la solicitud de pago. | `J-7609S-776` |
| **paymentRequestDisplayReference** | La referencia mostrada a los clientes en su estado de cuenta bancario. | `Monthly Internet Debit - June` |
| **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` |
| **withdrawalId** | El ID del retiro asociado (si el movimiento es un `debit`). | `withdrawal-12380-KLO` |
| **withdrawalCreatedDate** | La fecha en que el retiro asociado fue creado (si el movimiento es un `debit`), en formato `YYYY-MM-DD`. | `2024-05-18` |
| **withdrawalExtra** | Metadatos adicionales asociados con el retiro en formato JSON (si aplica). | `{"internal_note": "This is a sample of a withrawal extra field"}` |
| **accountBank** | El ID de Belvo para la cuenta bancaria del cliente. | `mx_banorte` |
| **paymentRequestStatus** | El estado actual de la Solicitud de Pago asociada. | `successful` |


#### 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:

1. Un crédito a tu cuenta (por los fondos retirados de la cuenta de tu cliente).
2. 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:

1. Un crédito a tu cuenta (por los fondos retirados de la cuenta de tu cliente).
2. Un débito de tu cuenta (la tarifa de procesamiento del pago).
3. 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:

1. En tu panel de control de Débito Directo:
  1. Ve a **Exportaciones de Pagos**.
  2. Haz clic en **Crear**.
2. En la ventana emergente Exportar Pagos:
  1. Selecciona **Métodos de Pago**.
  2. Elige el rango de fechas para el informe.
  3. Filtra qué estados de tus métodos de pago deseas incluir (recomendamos **Todos**).
  4. Haz clic en **Crear**.


¡Hecho!
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.

Solicitudes de Pago vs Estados de Cuenta
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 donde una solicitud de pago sea exitosa, pero dentro de 90 días tu cliente inicie un contracargo, el 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:

1. En tu panel de control de Débito Directo:
  1. Ve a **Exportaciones de Pagos**.
  2. Haz clic en **Crear**.
2. En la ventana emergente Exportar Pagos:
  1. Selecciona **Solicitudes de Pago**.
  2. Elige el rango de fechas para el informe.
  3. Filtra qué estados de tus solicitudes de pago deseas incluir (recomendamos **Todos**).
  4. Haz clic en **Crear**.


¡Hecho!
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 representando un cambio de estado de solicitud de pago por 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 |
| **settlementDate** | La fecha en que los fondos fueron liquidados en la cuenta del comerciante, en formato `YYYY-MM-DD`. | 2024-06-06 |
| **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. |  |