# 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:

```json 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", // [!code highlight]
    "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:

```json
{
  "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"
  }
}
```


-->