A Verification of Payee (VoP) verifica que o nome num pagamento corresponde ao titular da conta por trás do IBAN antes de o dinheiro se mover. Ao abrigo do Regulamento da UE dos Pagamentos Instantâneos é obrigatória para as transferências em euros, mas a integração em si não tem de ser complexa. Com a RoxPay resume-se a um punhado de passos.
1. Obtenha credenciais sandbox
Comece por solicitar chaves API sandbox. A sandbox espelha o comportamento de produção com dados de teste, para que construa e verifique o seu fluxo sem tocar em contas reais ou clientes verdadeiros.
2. Chame o endpoint de verificação
Envie o nome do beneficiário e o IBAN para um único endpoint. A RoxPay encaminha a verificação para o esquema e banco corretos, normaliza a resposta e devolve um resultado claro — não gere você as ligações bancárias individuais.
Um endpoint, cobertura total
Em vez de integrar cada banco ou esquema separadamente, chama um único endpoint da RoxPay e obtém resultados normalizados sobre as contas alcançáveis na SEPA.
3. Trate os quatro resultados
- Correspondência: nome e titular concordam — deixe o pagamento prosseguir.
- Correspondência parcial: quase exata (ex. abreviatura) — mostre o nome sugerido e deixe o pagador confirmar.
- Sem correspondência: os nomes diferem — avise o pagador antes de continuar.
- Verificação não possível: o banco não pôde responder — explique e deixe o pagador decidir.
4. Desenhe a experiência do pagador
A chamada técnica é apenas metade do trabalho. Mapeie cada resultado numa UI clara e não alarmante para que os pagadores percebam o que fazer. Uma correspondência parcial deve sugerir o nome verificado; uma sem correspondência deve avisar sem bloquear de todo os pagamentos legítimos.
5. Entre em produção
Assim que o seu fluxo tratar todos os resultados e tiver feito testes de carga face a picos realistas, troque as chaves sandbox pelas de produção. A monitorização e o registo da RoxPay ajudam-no a observar a integração nos dias após o go-live.