---
# System prepended metadata

title: Verificação de conta na Vindi Pagamentos
tags: [vindi recorrencia]

---

# Verificação de conta na Vindi Pagamentos

###### tags: `vindi recorrencia`

> Para que seja possível adicionarmos um participante em uma transação é obrigatório que este participante tenha uma conta verificada (nivel 5) na vertical de pagamentos. Para garantirmos que consigamos transacionar nós fazemos uma verificação no momento que um participante é cadastrado.

Cada participante tem um status do cadastro, este status reflete em seu estado na vertical de pagamentos, podemos assim garantir que só vamos transacionar se este participante tem conta na Vindi Pagamentos.
**Importante: A verificação é realizada a partir do e-mail informado no ato do cadastro do participante**

Ao cadastrar um participante o sistema de recorrência seu status fica como `Aprovação Pendente (pending_approval)`, assim o sistema automáticamente vai verificar se este email tem uma conta cadastrada e verificada na vertical de pagamentos (estima-se que a verificação pode demorar por volta de 5 minutos).
Se esta conta existir e for verificeada na vertical de pagamentos, seu status será atualizado para `Ativa (active)`, e este participante estará pronto para ser incluido em assinaturas e faturas.
Se esta conta não existir na vertical de pagamentos, seu status será atualizado para `Bloqueado (blocked)`, assim não sendo possível transacionar.

---

## API de solicitação de verificação de um participante

Existe uma nova API onde é possível verificar se um participante tem uma conta ativa na vertical de pagamentos após ele já ter sido cadastrado e estar bloqueado.

Pensando no seguinte cenário:

- Foi cadastrado um participante;
- Quando a Vertical de Recorrência foi verificar este participante em pagamentos foi constatado que ele não tinha uma conta, ou a sua conta não estava verificada (nivel 5);
- Então, naturalmente, o status do participante foi alterado para `Bloqueado (blocked)`;
- Tendo esta informação, o participante regularizou a situação de sua conta na vertical de pagamentos;
- Mesmo ele tendo atualizado sua conta, na vertical de Recorrência sua conta continua bloqueada;

Foi pensando neste cenário que foi desenvolvido o endpoint onde é possível re-verificar esta conta.

O endpoint é o `PUT /api/v1/affiliates/<id>/verify`.

Ao enviar uma requisição para este endpoint, vamos novamente verificar na vertical de pagamentos a conta deste participante, atualizando novamente seu status para `Aprovação Pendente (pending_approval)`, e depois de verificado, para `Ativa (active)` se estiver ativa e verificada, ou voltar para `Bloquado (blocked)` se esta conta continuar não verificada.


### Validações da API de verificação de participante

- Só é possível abrir uma nova verificação para contas que estão BLOQUEADAS;
- Contas já ativas ou com aprovação pendente vão retornar um erro e não vão realizar nenhum processamento;
- A aprovação é verificada de forma ASSINCRONA, ou seja, o sistema irá realizar a verificação após dar a resposta para a chamada, sendo necessário verificar o participante após a chamada da verificação (que estima-se que pode demorar por volta de 5 minutos);