Verification of Payee: developer guides
Technical guides for integrating Verification of Payee — the API and response codes, webhooks, latency, idempotency, retries, rate limits and name matching.
27 articles in this topic
Monitoring and Observability for Verification of Payee
A VoP integration can fail quietly: rising latency, a shift in outcomes, a creeping error rate. Good observability catches it before payers feel it.
Verification of Payee Rate Limits and Throughput
A payment run that verifies thousands of payees needs a plan for rate limits and throughput. Here is how to scale Verification of Payee without hitting a wall.
Verification of Payee and Data Residency
Payee verification handles personal data about the people being paid. Where that data is processed and stored matters for GDPR — and for your due diligence.
Load Testing Your Verification of Payee Integration
Your VoP integration needs to hold up at peak, not just in a demo. Here is how to load test it before go-live, what to measure, and how to use the sandbox.
What is an RVM (Routing and Verification Mechanism)?
No bank connects bilaterally to every other PSP in SEPA. An RVM is the service that routes your VoP request to the right responding bank — the plumbing that makes the scheme reachable.
Verification of Payee: Error Handling and Fallback UX
Not every VoP check returns a clean match. Here is how to design error handling and fallback UX for timeouts and 'not available' without blocking or misleading users.
The EPC Directory Service (EDS) explained
Before a VoP request can be routed, something has to say which bank holds the account and which RVM serves it. That something is the EPC Directory Service — the scheme's address book.
Understanding the Verification of Payee Data Model
A clean integration starts with understanding what you send and what you get back. Here is the Verification of Payee request and response data model, explained.
QWAC & eIDAS certificates for Verification of Payee
When one bank asks another about an account holder, both have to prove who they are. VoP does that with QWAC certificates under eIDAS — the same trust model as PSD2 open banking.
Using a Verification of Payee SDK or Client Library
A good SDK turns VoP integration from boilerplate into a few lines of code. Here is what to look for in a Verification of Payee client library.
Securing the Verification of Payee API: mTLS, OAuth and Keys
VoP requests carry names and IBANs, so transport and access security are essential. Here is how mTLS, OAuth and good key hygiene protect your integration.
Verification of Payee: Batch vs Single API Calls
Some VoP use cases need an instant single check; others verify thousands of accounts at once. Here is how to choose between real-time and batch verification.
Caching Verification of Payee Results Safely
Caching VoP outcomes can reduce cost and latency — but a stale result can let fraud through. Here is how to cache payee verification without losing its protective value.
Verification of Payee and ISO 20022 Messaging
VoP scheme messaging builds on ISO 20022, but your integration does not have to. Here is how the standard relates to VoP and where a REST API fits.
Audit Logging for Verification of Payee
A Verification of Payee outcome is only useful later if you logged it well. Here is what to record for each check, how long to keep it, and what to leave out.
Handling Verification of Payee Timeouts and Retries
A slow responding PSP should degrade your checkout gracefully, not break it. Here is a practical pattern for timeouts, retries and the not-available outcome in Verification of Payee.
How to Test Verification of Payee in a Sandbox
You can't test VoP properly by only checking the happy path. Here's how to exercise every outcome — match, close, no match, not applicable — and the error paths before you go live.
Verification of Payee Webhooks and Asynchronous Results
Most Verification of Payee checks return in under a second, but networks fail and some responding banks are slow. Webhooks let you handle asynchronous VoP results cleanly without blocking the payer.
Idempotency and Reconciliation in the Verification of Payee API
Retries happen. Without idempotency you double-count checks; without a correlation id you can't tie results back to payments. Here's how to get both right with one field.
Verifying Companies: Legal Persons and Organisation Identifiers in VoP
Company names are messy — trading names, suffixes, abbreviations. That's why Verification of Payee lets you verify legal persons by an organisation identifier, not just a name.
How Name Matching Works in Verification of Payee
VoP doesn't do exact-string comparison — if it did, every initial and accent would be a no match. Here's what actually happens between the name you send and the outcome you get.
How Fast Is Verification of Payee? Latency and Timeouts
VoP runs at the moment of payment, so speed matters. Here's what latency to expect, what happens on a timeout, and how to keep the experience responsive.
Reducing False Positives in Verification of Payee
If every payment returns a close match, users stop trusting the warning. Here's how to cut false positives in VoP without weakening the real fraud signal.
One VoP Connection vs Integrating Bank by Bank
You could integrate every responding bank yourself. Or you could connect once to the SEPA VoP scheme and reach them all. Here's why coverage, not code, is the real challenge.
Verification of Payee API Response and Error Codes, Explained
MTCH, CMTC, NMTC, NOAP — and the difference between a 'no match' result and an actual error. A developer's reference for handling Verification of Payee API responses cleanly.
Being a Responding PSP in the Verification of Payee Scheme
Most VoP content covers the requesting side — asking 'does this name match this IBAN?'. But compliance often means answering those requests too. Here's what a responding PSP must do.
Integrating the Verification of Payee API: A Developer's Guide
From authentication to handling the four scheme outcomes, here's how to integrate a real-time Verification of Payee API and branch your UI cleanly.
Ready to add Verification of Payee?
From the EPC scheme to a single REST call, RoxPay helps banks, PSPs and businesses go live with VoP before their deadline.