# Introdução

Com o recurso de Importação de Pagamentos da Belvo, você pode facilmente realizar pagamentos por débito direto em massa. Tudo o que você precisa fazer é enviar um CSV com todos os dados necessários sobre seus clientes, e a Belvo criará automaticamente o cliente em nosso sistema, registrará o método de pagamento e, em seguida, processará a solicitação de pagamento.

Importante: Acordos de usuário (consentimento)
Antes de fazer qualquer solicitação de pagamento, você deve:

1. Obter consentimento explícito de seus usuários, autorizando você a debitar fundos de suas contas.
2. Manter evidências documentadas desse consentimento.


## Instruções

Para fazer o upload em massa de pagamentos por débito direto:

1. No seu painel de Débito Direto, vá para **Pagamentos** → **Importações de Pagamento** (Sandbox | Produção).
2. Clique em **Importar**.

3. Na tela Selecionar importação, clique em **Baixar Modelo**.

4. Preencha o CSV baixado com os campos obrigatórios (para mais informações, consulte a seção Modelos de arquivo de importação em massa).
5. Faça o upload do seu CSV clicando no botão **Upload** na tela **Selecionar importação**.
**Nota:** Nosso sistema realizará uma verificação nas primeiras 100 linhas para validar se o CSV carregado possui todos os campos obrigatórios nos formatos corretos. Se o sistema detectar algum problema, você receberá uma lista de erros na tela **Selecionar importação**.

6. Verifique se a saída na tela Selecionar importação está correta e clique em **Upload import**.

7. Assim que você fizer o upload do seu arquivo, definimos o status como **validando** (onde nosso sistema começará a validar o restante do seu arquivo para confirmar que todas as informações estão no formato correto. Se houver algum erro no restante do arquivo, a importação falhará). Assim que tudo for confirmado, o status será definido como **ready_to_send**. Quando o status do arquivo for **ready_to_send**, você pode finalizar o processo clicando em **Enviar** na coluna **Ações**.

8. A Belvo agora processará seu arquivo em segundo plano, criando clientes, registrando os métodos de pagamento e, em seguida, processando os pagamentos. Assim que o status for **processado**, seus pagamentos serão realizados de acordo com os horários de registro e pagamento do país.



## Modelos de arquivo de importação em massa

Para cada país, há um modelo específico que você deve preencher. Você pode encontrar a versão mais atualizada do modelo na tela de Importação em Lote.

### México

Quer debitar fundos de uma empresa?
Se você estiver debitando fundos de uma empresa, basta adicionar o nome dela nas colunas **Primer nombre** e **Apellidos**.

| Campo | Exemplo | Obrigatório | Descrição | Validação |
|  --- | --- | --- | --- | --- |
| Primer nombre | Incredible | Sim | O primeiro nome do seu cliente. | Não pode ter mais de 50 caracteres. |
| Apellidos | Phantom | Sim | O sobrenome do seu cliente. | Não pode ter mais de 50 caracteres. |
| Tipo de ID | mx_curp | Sim | O tipo de ID do seu cliente. Para o México, pode ser `mx_curp` ou `mx_rfc`. | Pode ser apenas `mx_curp` ou `mx_rfc`. |
| No. ID | PHI740220IÑ0 | Sim | O número de ID associado ao tipo de ID. | O número deve corresponder ao tipo de ID. |
| Teléfono | +526351994215 | Não | O número de telefone do seu cliente. Para o México, deve ser prefixado com +52. | O número deve começar com o código de discagem internacional do México (+52). |
| Email | g.champion@supermail.com | Sim | O endereço de email do seu cliente. | Deve ser um email válido. |
| Cuenta CLABE o Tarjeta | 014893080663470004 | Sim | O número da conta bancária ou do cartão de débito. | Deve ter entre 15–19 caracteres e ser de uma das nossas instituições suportadas. |
| Referencia reflejada en extracto bancario | Monthly car payment | Não | Uma descrição para mostrar no extrato bancário do seu cliente. | Não pode ter mais de 80 caracteres. |
| Referencia Única cliente | Debito 89000982349 | Sim* | Sua referência interna para a solicitação de pagamento. | Não pode ter mais de 80 caracteres. |
| Importe a cobrar | 6000 | Sim* | O valor a ser solicitado. Para o México, será em Pesos Mexicanos (MXP). | O valor a ser cobrado do cliente, com até duas casas decimais (por exemplo, `3425.29`). |
| Banco** | mx_banxico | **Apenas para cartões de débito*** | O banco no qual o cartão de débito está registrado. | Por favor, selecione no menu suspenso na planilha. |
| Identificador de contrato | 8789-02342-XRT | Não | Sua referência para o empréstimo associado à solicitação de pagamento. | Não pode ter mais de 50 caracteres. |
| Monto total del préstamo | 946.65 | Não | O valor total do empréstimo. | – |
| Fecha de contrato | 2024-05-28 | Não | A data do contrato de empréstimo, no formato `YYYY-MM-DD`. | – |
| Cantidad de pagos | 12 | Não | O número total de parcelas do empréstimo. | – |
| Fecha de pago | 2025-03-28 | Não | A data de vencimento da parcela a ser paga, no formato `YYYY-MM-DD`. | – |
| Número de este pago | 10 | Não | O número da parcela a ser paga. | – |
| Importe de este pago | 502.57 | Não | O valor da parcela a ser paga. | – |


* No upload inicial, você pode omitir esses campos. A Belvo ainda criará os clientes e métodos de pagamento.

** Se o banco (**Banco**) estiver presente, a cobrança será sempre processada como um cartão de débito. Se não estiver presente, será sempre processada como uma cobrança CLABE.

## Status dos arquivos

Um arquivo enviado passa pelos seguintes status:

| Status | Descrição |
|  --- | --- |
| validating | O estado inicial de qualquer arquivo enviado. Aqui verificamos o restante do seu arquivo em busca de erros. |
| failed | O arquivo contém erros e não pode ser importado. Por favor, verifique os erros e envie o arquivo novamente. |
| ready_to_send | Verificamos seu arquivo e ele não possui erros. Agora você pode enviá-lo para processamento. |
| processing | Criamos quaisquer clientes que ainda não existam em nosso sistema, registramos métodos de pagamento com bancos e, em seguida, enviamos as solicitações de pagamento. |
| processed | Os clientes, métodos de pagamento e solicitações de pagamento foram criados. Os pagamentos serão processados de acordo com os tempos de registro e pagamento para o país. |


## Qual é o número máximo de linhas que posso ter em um único arquivo?

Você pode fornecer até 50.000 (cinquenta mil) linhas em um arquivo.

## Quantos erros você mostra na tela de seleção de importação?

Nosso sistema analisa inicialmente as primeiras 100 linhas do seu arquivo. Isso também permitirá que você verifique o restante do seu arquivo para ver se há outros erros semelhantes.

## Preciso incluir a referência interna e o valor do pagamento no upload inicial?

Não, você pode usar o recurso de importação em lote para apenas carregar uma lista de clientes e seus métodos de pagamento. Em uma data posterior, você pode carregar o mesmo CSV com a referência interna e as informações do valor do pagamento.

## Você cria clientes e registra métodos de pagamento a cada vez?

Clientes e métodos de pagamento são criados apenas quando são novos. Se for um cliente e método de pagamento existentes, prosseguiremos automaticamente para o processamento do pagamento.

## Você atualiza as informações pessoais existentes dos clientes?

Não, a funcionalidade de importação em lote não suporta a atualização de informações pessoais existentes para seus clientes.

## Por que estou recebendo um erro de que não posso processar um arquivo?

Pode haver duas razões para isso:

1. Se você enviou anteriormente um arquivo com alguns dos mesmos clientes e ainda estamos criando os métodos de pagamento ou processando solicitações de pagamento para eles, nosso sistema não permitirá que você adicione novos pagamentos para esse cliente até que tenhamos processado a solicitação anterior.
2. Se você enviar dois arquivos ao mesmo tempo, o arquivo anterior deve ser processado antes que o próximo arquivo possa ser.


## O que são linhas ignoradas?

Linhas ignoradas indicam que não pudemos processar o cliente e o método de pagamento porque há outra solicitação de pagamento ativa no momento do upload. Você pode visualizar solicitações de pagamento que foram ignoradas clicando no botão **Mostrar ignorados** na coluna **Ações**.