Developer 5 min read

How to Test Verification of Payee in a Sandbox

A Verification of Payee integration is only as good as the way it handles the unhappy paths. Here's a practical test plan that exercises every outcome in a sandbox before you switch to production.

By Verification of Payee EU · powered by RoxPay

Key takeaways

  • Test all four outcomes, not just match: close match, no match and not applicable.
  • Include error paths — invalid IBAN, missing name, timeouts — in your test plan.
  • Use a sandbox with deterministic test data so each outcome is reproducible.

It's tempting to integrate Verification of Payee, see a match come back, and call it done. But the value of VoP is in the moments when the answer isn't a clean match — and those are exactly the cases a quick test skips. A proper sandbox plan covers them all.

Test every outcome

A sandbox should let you reproduce each scheme outcome on demand, usually by sending specific test names or IBANs. Make sure your UI and your code do the right thing for each one.

  • Match (MTCH) — confirm the payment can proceed cleanly.
  • Close match (CMTC) — confirm you surface the suggested verified name to confirm or correct.
  • No match (NMTC) — confirm you show a clear warning and don't auto-proceed.
  • Not applicable (NOAP) — confirm you handle 'couldn't verify' gracefully, not as an error.

Don't forget the error paths

Beyond the four outcomes, test what happens with a malformed IBAN, a missing payee name, an expired credential and a timeout. These are where fragile integrations break in production.

Keep tests deterministic

Use a sandbox with documented, deterministic test data so a given input always returns the same outcome. That makes your integration tests repeatable in CI and means a failure points to a real regression, not a flaky responder.

From sandbox to production

Once every outcome and error path behaves correctly, going live is usually just switching the base URL and credentials. RoxPay provides a sandbox with test cases for each outcome, so you can validate the full flow before pointing at production.

FAQ

Frequently asked

In a sandbox you trigger it with specific test data (a name that partially matches the account holder). Confirm your UI shows the suggested verified name for the payer to confirm or correct.

All four outcomes (match, close match, no match, not applicable) plus error paths: invalid IBAN, missing name, expired credentials and timeouts.

Once every outcome and error path is handled correctly, switch the base URL and credentials to production. The contract stays the same, so no code changes are needed.

Validate VoP before go-live

Talk to RoxPay about a sandbox with test cases for every Verification of Payee outcome.