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.
Você também pode usar este recurso apenas para criar clientes e métodos de pagamento em massa sem fazer solicitações de pagamento. Para fazer isso, basta omitir os campos Referencia Única cliente e Importe a cobrar no seu CSV. A Belvo criará os clientes e métodos de pagamento, e você poderá fazer solicitações de pagamento em uma data posterior.
Antes de fazer qualquer solicitação de pagamento, você deve:
- Obter consentimento explícito dos seus usuários, autorizando você a debitar fundos de suas contas.
- Manter evidências documentadas desse consentimento.
Com a Belvo, você pode fazer isso de duas maneiras:
- Carregando os consentimentos em massa usando nosso recurso de Upload de Consentimentos em Massa.
- Usando nossa Consent API para criar consentimentos programaticamente. Para facilitar as coisas no início, experimente usar nossa Coleção Postman de Débito Direto no México para carregar os consentimentos.
Para fazer 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.
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 importação.
Validação Completa do ArquivoAssim 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á). Uma vez que tudo estiver confirmado, o status será definido como ready_to_send e você poderá prosseguir para o próximo passo.
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. Uma vez que o status for processado, seus pagamentos serão realizados de acordo com o registro e os horários de pagamento do país.
Existe um modelo específico que você deve preencher para poder usar este recurso (você pode encontrar a versão mais atualizada do modelo na tela de Importação em Lote). Na tabela abaixo, descrevemos cada um dos campos que você precisa preencher.
Se você estiver debitando fundos de uma empresa, basta adicionar o nome dela nas colunas Primer nombre e Apellidos.
Você também pode usar este recurso apenas para criar clientes e métodos de pagamento em massa sem fazer nenhuma solicitação de pagamento. Para fazer isso, basta omitir os campos Referencia Única cliente e Importe a cobrar no seu CSV. A Belvo criará os clientes e métodos de pagamento, e você poderá fazer solicitações de pagamento em uma data posterior.
| 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 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 | Pode ser omitido para apenas criar clientes e métodos de pagamento. Para fazer solicitações de pagamento, você deve incluí-lo. | Sua referência interna para a solicitação de pagamento. | Não pode ter mais de 80 caracteres. |
| Importe a cobrar | 6000 | Pode ser omitido para apenas criar clientes e métodos de pagamento. Para fazer solicitações de pagamento, você deve incluí-lo. | O valor a ser solicitado. Para o México, será em Pesos Mexicanos (MXP). | O valor a cobrar 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. | – |
* 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.
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. |
Você pode fornecer até 50000 (cinquenta mil) linhas em um único arquivo.
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.
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.
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.
Não, o recurso de importação em lote não suporta a atualização de informações pessoais existentes para seus clientes.
Podem 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.
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.