Introdução à Validação de Centavo

A validação de centavo é um método que a Belvo utiliza para confirmar que uma conta bancária existe e é de propriedade de um indivíduo ou entidade específica.

O fluxo geral da validação de centavo da Belvo é:

1. Você cria um cliente e um método de pagamento.
2. A Belvo envia um "centavo" usando SPEI para a conta especificada quando você criou o método de pagamento.
3. Um Comprovante Eletrônico de Pagamento (CEP) é gerado para a transação e a Belvo recupera os dados do documento.
4. A Belvo compara as informações do proprietário do CEP com as informações que você forneceu ao criar o cliente para verificar a conta fornecida.

Validação de centavos para Métodos de Pagamento (API)

1. Você cria um cliente.

2. Você cria um Método de Pagamento para o cliente.

3. O status do Método de Pagamento é definido como pending_agreement_acceptance.

4. Uma vez que o acordo é aceito, o status do Método de Pagamento é definido como pending_validation.

5. A Belvo envia o “centavo" para a conta registrada no Passo 2.

6. Um Comprovante Eletrônico de Pagamento (CEP) é gerado para a transação e a Belvo recupera os dados do documento.

7. A Belvo compara o documentType e documentNumber fornecidos no Passo 1 com as informações fornecidas no CEP.

   1. Se as informações forem as mesmas, o status do Método de Pagamento é definido como active.

   2. Se as informações não forem as mesmas, o status do Método de Pagamento é definido como error. Você receberá um payment_method_registration_failed webhook com as seguintes informações de falha:

      Erro de Validação de Centavos

      {
        "eventType": "payment_method_update",
        "eventCode": "payment_method_registration_failed",
        "datetime": "2022-01-01T12:34:56.789Z",
        "details": {
          "id": "3118128a-6792-4b06-bd61-4acf6f6ad6b5", 
          "reference": "your_reference_here",
          "status": "error",
          "failedReason": "account_validation_failed",
          "failedMessage": "Account owner validation was not successful"
        }
      }

Validação de centavos usando Importações em Lote

1. Você envia seu CSV para Importação em Lote de Pagamentos por Débito Direto.
2. Se necessário, a Belvo cria os clientes associados para cada linha do seu CSV.
3. A Belvo cria um Método de Pagamento para cada novo cliente (ou seja, para qualquer cliente que não tenha sido previamente registrado com as mesmas informações).
4. O status do Método de Pagamento é definido como pending_validation.
5. A Belvo envia o “centavo" para a conta registrada na Etapa 3.
6. Um Comprovante Eletrônico de Pagamento (CEP) é gerado para a transação e a Belvo recupera os dados do documento.
7. A Belvo compara o documentType e o documentNumber fornecidos ao criar o cliente com as informações fornecidas no CEP.
   1. Se as informações forem as mesmas, o status do Método de Pagamento é definido como active.
   2. Se as informações não forem as mesmas, o status do Método de Pagamento é definido como failed. Em nossa interface, você verá o motivo da falha (validation_failed) junto com uma mensagem detalhando o motivo da falha (Account owner validation was not successful).

Solicitações de Pagamento com Métodos de Pagamento Adhoc

1. Você cria um cliente (API).

2. Você cria uma Solicitação de Pagamento com um Método de Pagamento Adhoc para o cliente. (API)

3. O status da Solicitação de Pagamento é definido como pending_validation.

4. A Belvo envia o “centavo" para a conta registrada no Passo 2.

5. Um Comprovante Eletrônico de Pagamento (CEP) é gerado para a transação e a Belvo recupera os dados do documento.

6. A Belvo compara o documentType e o documentNumber fornecidos no Passo 1 com as informações fornecidas no CEP.

   1. Se as informações forem as mesmas, o status da Solicitação de Pagamento é definido como initial.

   2. Se as informações não forem as mesmas, o status da Solicitação de Pagamento é definido como failed. Você receberá um webhook payment_request_failed com as seguintes informações de falha:

      {
        "eventType": "payment_request_update",
        "eventCode": "payment_request_failed",
        "datetime": "2022-01-01T12:34:56.789Z",
        "details": {
          "id": "3118128a-6792-4b06-bd61-4acf6f6ad6b5", // O paymentRequestId
          "reference": "your_reference_here",
          "status": "failed",
          "failedReason": "account_validation_failed",
          "failedMessage": "A validação do proprietário da conta não foi bem-sucedida"
        }
      }

-->