# Relatórios

O recurso de Exportação de Pagamentos da Belvo permite que você extraia informações sobre seus:

- Extratos (para reconciliação)
- Métodos de Pagamento
- Solicitações de Pagamento


Neste guia, vamos orientá-lo sobre como gerar cada tipo de relatório e explicar quais informações você pode extrair de cada um deles.

## Statements

O relatório de Statements é ideal para quando você deseja realizar a reconciliação com seus dados. O relatório mostrará **todos** os movimentos de cobrança, taxa, chargeback e retirada que ocorreram em sua conta Belvo para um determinado período.

Glossário
- Uma **cobrança** é quando o dinheiro foi creditado (depositado) em sua conta Belvo devido a uma retirada bem-sucedida da conta do seu cliente.
- Uma **taxa** é quando o dinheiro foi debitado de sua conta para o processamento de um pagamento.
- Um **chargeback** é quando uma cobrança anteriormente bem-sucedida foi contestada pelo seu cliente, e a Belvo debitou esse valor de sua conta.
- Uma **retirada** é quando o saldo de sua conta Belvo foi transferido para sua conta bancária.


### Gerando um relatório de extrato

Para gerar um relatório de todos os movimentos na sua conta Belvo:

1. No seu painel de Débito Direto:
  1. Vá para **Exportações de Pagamentos**.
  2. Clique em **Criar**.
2. No pop-up Exportar Pagamentos:
  1. Selecione **Extratos (conciliar)**.
  2. Escolha o intervalo de datas para o relatório.
  3. Filtre quais movimentos você deseja incluir (recomendamos **Todos**).
  4. Clique em **Criar**.


Feito!
Seu relatório será gerado em poucos minutos. Assim que for gerado com sucesso, você poderá baixá-lo usando o botão **Clique para baixar** na coluna **Arquivo**.

#### Campos do relatório

O relatório gerado terá as seguintes colunas, com cada linha no relatório sendo um movimento separado:

| Coluna do Extrato | Descrição | Exemplo |
|  --- | --- | --- |
| **id** | O ID único do movimento. | `8e8954e6-c9cb-4ede-b163-2f392f041df6` |
| **createdDate** | A data em que o movimento ocorreu, no formato `YYYY-MM-DD`. | `2024-05-03` |
| **type** | O tipo de movimento. Pode ser: `credit` (dinheiro depositado na sua conta) `debit` (dinheiro retirado da sua conta)  | `credit` |
| **reason** | A razão para o `type` do movimento. Pode ser: `charge` (dinheiro foi retirado com sucesso da conta de um usuário) `fee` (a taxa pelo processamento do pagamento) `chargeback` (um débito na sua conta devido a um chargeback do seu cliente) `withdrawal` (transferências da conta Belvo para sua conta bancária real) | `charge` |
| **amount** | O valor do movimento. | `270.00` |
| **currency** | A moeda do movimento. | `mxn` |
| **paymentRequestId** | O ID da solicitação de pagamento associada. | `37a2d810-8ecb-4111-acb2-c80c164ea789` |
| **reference** | Sua referência interna para a solicitação de pagamento. | `J-7609S-776` |
| **customerName** | O nome do seu cliente. | `Juan Carlos Hernandez Garcia` |
| **customerDocumentType** | O tipo de documento de identificação do seu cliente. | `mx_rfc` |
| **customerDocumentNumber** | O número de identificação para o tipo de documento. | `HEGJ820506M10` |
| **paymentMethodType** | O tipo de método de pagamento. | `bank_account` |
| **accountNumber** | O número da conta do seu cliente. | `002665000000000001` |


#### Movimentações de extrato

Uma única solicitação de pagamento terá entre dois e três movimentos em um determinado extrato. Por exemplo:

**Cenário de sucesso (sem chargeback)**

No exemplo abaixo, onde os fundos foram retirados com sucesso da conta de um cliente e depositados em sua conta Belvo, você pode ver que há duas entradas:

1. Um crédito em sua conta (pelos fundos retirados da conta do seu cliente).
2. Um débito de sua conta (a taxa de processamento para o pagamento).


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


**Cenário de sucesso (com chargeback)**

No exemplo abaixo, onde os fundos foram retirados com sucesso da conta de um cliente, depositados em sua conta Belvo, mas retirados de sua conta devido a um chargeback iniciado pelo seu cliente, você pode ver que há três entradas:

1. Um crédito em sua conta (pelos fundos retirados da conta do seu cliente).
2. Um débito de sua conta (a taxa de processamento para o pagamento).
3. Um débito de sua conta devido a um chargeback (pelo valor da cobrança 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 Pagamento

Relatórios de Métodos de Pagamento fornecem uma visão geral de todas as contas bancárias que você registrou para seus clientes e seu status, permitindo que você obtenha uma visão rápida de quais métodos de pagamento estão ativos, ainda pendentes de confirmação e falharam.

### Gerando um relatório de métodos de pagamento

Para gerar um relatório de todos os métodos de pagamento na sua conta Belvo:

1. No seu painel de Débito Direto:
  1. Vá para **Exportações de Pagamento**.
  2. Clique em **Criar**.
2. No pop-up Exportar Pagamentos:
  1. Selecione **Métodos de Pagamento**.
  2. Escolha o intervalo de datas para o relatório.
  3. Filtre quais status dos seus métodos de pagamento você deseja incluir (recomendamos **Todos**).
  4. Clique em **Criar**.


Concluído!
Seu relatório será gerado em alguns minutos. Assim que for gerado com sucesso, você poderá baixá-lo usando o botão **Clique para baixar** na coluna **Arquivo**.

#### Campos do relatório

O relatório gerado terá as seguintes colunas, com cada linha no relatório sendo um método de pagamento separado:

| Coluna do Método de Pagamento | Descrição | Exemplo |
|  --- | --- | --- |
| **id** | ID único da Belvo para o método de pagamento. | 4b14e571-89b0-4d80-838e-282ecc4fcfca |
| **createdDate** | A data em que o método de pagamento foi criado, no formato `YYYY-MM-DD`. | 2024-06-05 |
| **lastUpdatedDate** | A data em que o método de pagamento foi atualizado pela última vez (por exemplo, uma mudança de status), no formato `YYYY-MM-DD`. | 2024-06-05 |
| **customerDocumentType** | O tipo de documento de identificação do cliente. | mx_rfc |
| **customerDocumentNumber** | O número do documento de identificação do cliente. | HEGJ820506M10 |
| **accountBank** | A instituição onde a conta é mantida. | mx_citi_banamex |
| **accountType** | O tipo de conta. | savings |
| **accountNumber** | O número da conta. | 002665000000000001 |
| **reference** | Sua referência interna para o método de pagamento. |  |
| **status** | O status do método de pagamento. | pending_activation |
| **failedReason** | Se o método de pagamento falhou, a razão para a falha. Para uma lista completa de razões que podem ser retornadas, veja nosso artigo dedicado a erros. |  |
| **failedMessage** | Se o método de pagamento falhou, a mensagem explicando a falha. Para uma lista completa de mensagens que podem ser retornadas, veja nosso artigo dedicado a erros. |  |


## Solicitações de Pagamento

Relatórios de Solicitação de Pagamento fornecem uma visão geral de todas as solicitações de pagamento que você criou para seus clientes e seu status, permitindo que você obtenha uma visão rápida de quais solicitações de pagamento estão ativas, ainda pendentes de confirmação e falharam.

Solicitações de Pagamento vs Extratos
Relatórios de Solicitação de Pagamento mostram apenas as alterações individuais de solicitação de pagamento para o período de tempo. No entanto, podem haver situações em que uma solicitação de pagamento seja bem-sucedida, mas dentro de 90 dias seu cliente inicia um chargeback, que não aparecerá no relatório inicial.
Para ver os movimentos completos que influenciam seu saldo, recomendamos fortemente que você use o relatório de Extratos

### Gerando um relatório de solicitação de pagamento

Para gerar um relatório de todas as solicitações de pagamento na sua conta Belvo:

1. No seu painel de Débito Direto:
  1. Vá para **Exportações de Pagamento**.
  2. Clique em **Criar**.
2. No pop-up Exportar Pagamentos:
  1. Selecione **Solicitações de Pagamento**.
  2. Escolha o intervalo de datas para o relatório.
  3. Filtre quais status das suas solicitações de pagamento você deseja incluir (recomendamos **Todos**).
  4. Clique em **Criar**.


Feito!
Seu relatório será gerado em poucos minutos. Assim que for gerado com sucesso, você poderá baixá-lo usando o botão **Clique para baixar** na coluna **Arquivo**.

#### Campos do relatório

O relatório gerado terá as seguintes colunas, com cada linha no relatório sendo uma alteração de status de solicitação de pagamento separada:

| Coluna de Solicitação de Pagamento | Descrição | Exemplo |
|  --- | --- | --- |
| **id** | ID único da Belvo para a solicitação de pagamento. | 017d5c0a-2aee-496f-b938-dcb848f7348b |
| **createdDate** | A data em que a solicitação de pagamento foi criada, no formato `YYYY-MM-DD`. | 2024-06-05 |
| **lastUpdatedDate** | A data em que a solicitação de pagamento foi atualizada pela última vez (por exemplo, uma alteração de status), no formato `YYYY-MM-DD`. | 2024-06-05 |
| **customerDocumentType** | O tipo de documento de identificação do cliente. | mx_rfc |
| **customerDocumentNumber** | O número do documento de identificação do cliente. | HEGJ820506M10 |
| **accountBank** | A instituição onde a conta está mantida. | mx_citi_banamex |
| **accountType** | O tipo de conta. | savings |
| **accountNumber** | O número da conta. | 002665000000000001 |
| **reference** | Sua referência interna para a solicitação de pagamento. | `J-7609S-776` |
| **displayReference** | A descrição que será exibida na plataforma bancária do seu cliente quando o pagamento for processado. |  |
| **amount** | O valor da solicitação de pagamento (em MXN) | 500 |
| **status** | O status da solicitação de pagamento. | initial |
| **failedReason** | Se a solicitação de pagamento falhar, a razão para a falha. Para uma lista completa de razões que podem ser retornadas, consulte nosso artigo dedicado a erros. |  |
| **failedMessage** | Se a solicitação de pagamento falhar, a mensagem explicando a falha. Para uma lista completa de mensagens que podem ser retornadas, consulte nosso artigo dedicado a erros. |  |