A Verification of Payee é conceptualmente simples: pergunta se um nome corresponde a um IBAN e recebe um resultado padronizado. Mas uma integração robusta depende de compreender cada parte dessa troca e de a alimentar com dados limpos.
O lado do pedido
- Nome do beneficiário: o nome como o espera, idealmente estruturado e limpo.
- IBAN: a conta a verificar.
- Tipo de conta: se o beneficiário é uma pessoa ou uma organização, o que afeta a correspondência.
- Uma referência de pedido ou chave de idempotência para ligar a chamada aos seus registos.
O lado da resposta
- Resultado: correspondência, correspondência parcial, sem correspondência ou não disponível.
- Para uma correspondência parcial, o nome realmente registado, para que o possa mostrar ao pagador.
- Um código de motivo ou estado que dá contexto ao resultado.
- Um identificador para correlacionar com os seus logs e reconciliação.
Lixo à entrada, correspondência fraca à saída
A precisão da correspondência depende da qualidade da entrada. Enviar nomes limpos e bem estruturados e o tipo de conta certo melhora sensivelmente os resultados.
Conceber em torno do modelo
A API de Verification of Payee da RoxPay expõe um modelo claro de pedido/resposta com resultados padronizados e detalhes de apoio, para que a sua integração possa agir sobre os resultados com confiança.