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.
- 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:
No seu painel de Débito Direto:
Vá para Exportações de Pagamentos.
Clique em Criar.
No pop-up Exportar Pagamentos:
- Selecione Extratos (conciliar).
- Escolha o intervalo de datas para o relatório.
- Filtre quais movimentos você deseja incluir (recomendamos Todos).
- Clique em Criar.
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:
- Um crédito em sua conta (pelos fundos retirados da conta do seu cliente).
- 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:
- Um crédito em sua conta (pelos fundos retirados da conta do seu cliente).
- Um débito de sua conta (a taxa de processamento para o pagamento).
- 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:
No seu painel de Débito Direto:
Vá para Exportações de Pagamento.
Clique em Criar.
No pop-up Exportar Pagamentos:
- Selecione Métodos de Pagamento.
- Escolha o intervalo de datas para o relatório.
- Filtre quais status dos seus métodos de pagamento você deseja incluir (recomendamos Todos).
- Clique em Criar.
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.
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:
No seu painel de Débito Direto:
Vá para Exportações de Pagamento.
Clique em Criar.
No pop-up Exportar Pagamentos:
- Selecione Solicitações de Pagamento.
- Escolha o intervalo de datas para o relatório.
- Filtre quais status das suas solicitações de pagamento você deseja incluir (recomendamos Todos).
- Clique em Criar.
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. |