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.
Antes de fazer qualquer solicitação de pagamento, você deve:
- Obter consentimento explícito de seus usuários, autorizando você a debitar fundos de suas contas.
- Manter evidências documentadas desse consentimento.
Instruções
Para fazer o upload em massa de pagamentos por débito direto:
No seu painel de Débito Direto, vá para Pagamentos → Importações de Pagamento (Sandbox | Produção).
Clique em Importar.
Na tela Selecionar importação, clique em Baixar Modelo.
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).
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.
Verifique se a saída na tela Selecionar importação está correta e clique em Upload import.
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.
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
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). |
| 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:
- 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.
- 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.