Um exemplo de Verification of Payee
Como é realmente uma verificação VoP? Eis um exemplo concreto: o pedido que envia, a resposta JSON que recebe e como aparece cada um dos quatro resultados.
Como é uma verificação VoP na prática
Uma verificação Verification of Payee é uma única pergunta em tempo real: este nome pertence a este IBAN? Envia o nome do beneficiário e o IBAN, e o banco respondedor devolve um resultado padronizado antes de o pagamento ser autorizado.
Abaixo, um exemplo simplificado de pedido e resposta. Os nomes exatos dos campos dependem do fornecedor, mas cada resposta VoP corresponde aos mesmos quatro resultados do esquema.
Pedido de exemplo
POST /v1/verification-of-payee
Authorization: Bearer <token>
{
"payee": {
"name": "Maria Rossi",
"iban": "DE89370400440532013000"
}
}{
"outcome": "match",
"matchedName": "Maria Rossi",
"respondingBic": "COBADEFFXXX",
"requestId": "vop_8f3a2c91",
"processedAt": "2026-06-24T10:00:00Z"
}Os quatro resultados, com exemplos
Cada resposta VoP resume-se a um destes quatro resultados.
match
O nome corresponde totalmente ao titular — ex. enviou 'Maria Rossi' e a conta é 'Maria Rossi'.
close match
Quase certo — ex. enviou 'M. Rossi' e o titular é 'Maria Rossi'. O nome verificado é devolvido como sugestão.
no match
O nome não corresponde ao IBAN — ex. 'Acme Lda' numa conta de 'Maria Rossi'. Um forte sinal de fraude.
not possible
A verificação não pôde ser concluída — ex. o banco do beneficiário está indisponível ou o IBAN ainda não tem cobertura.
Experimente com os seus próprios dados
A sandbox da RoxPay permite enviar nomes e IBAN reais e ver exatamente qual o resultado devolvido — a forma mais rápida de perceber o comportamento da VoP antes de integrar.
FAQ
É uma pequena resposta estruturada com o resultado (correspondência, parcial, nenhuma ou não possível) e, para uma correspondência parcial, o nome verificado como sugestão, além do BIC do banco respondedor e uma referência do pedido.
Enviar 'M. Rossi' quando o titular é 'Maria Rossi' devolve normalmente uma correspondência parcial, com 'Maria Rossi' sugerido para o pagador confirmar ou corrigir o nome.
No mínimo o nome do beneficiário e o IBAN. Para pessoas coletivas pode incluir-se um identificador da organização (como NIF ou número de registo) para melhorar a precisão.
Sim. A RoxPay disponibiliza uma sandbox e documentação de API para enviar pedidos de exemplo e inspecionar a resposta de cada resultado antes de entrar em produção.
Veja a API VoP em ação
Obtenha acesso à sandbox e teste pedidos reais nos quatro resultados.