A name check asks the bank or operator who owns an account. Run it before the first payout to any new recipient and show the name to your user.
A payout to a real account that belongs to the wrong person is not something Payve can reverse. The name check is your chance to catch a mistyped account number.
Two endpoints cover everything on this page:

List institutions

GET /v1/payouts/institutions?country=NG&type=bank
string
default:"NG"
Two-letter country code: NG, GH or KE.
string
bank or mobile_money. Leave it out to get both in one list.
Every item carries a type, so you can tell the two kinds apart in one list.
Use bankCode in a name check and in a payout.
Nigeria has no mobile money operators in this list. Payouts to Nigeria go to bank accounts only.
Cache the list for a few hours. Do not hard-code bank codes: fetch them, so new banks appear without a release.

Check an account

GET /v1/payouts/validate-account
string
required
bank or mobile_money.
string
default:"NG"
Two-letter country code.
string
The bank account number. Required when type is bank.
string
The bank’s code from the institutions list. Required when type is bank.
string
The mobile money number. Required when type is mobile_money.
string
The operator’s name from the institutions list. Required when type is mobile_money.
A request that leaves out a field its type needs is refused with 422.
Response · 200
accountName can be null when the bank returns no name. Treat that as “not confirmed”, not as a pass.A Nigerian account number must be exactly 10 digits. Anything else returns 422 validation_invalid_beneficiary without asking the bank.

Use the result

1

Show the name

Display accountName exactly as returned.
2

Ask your user to confirm

Let them say “yes, that is who I am paying” before you create the payout.
3

Send the payout

Put the confirmed name in beneficiary.holderName.
Do not auto-reject on a name that differs slightly from what your user typed. Banks abbreviate, reorder and truncate names. Show the bank’s version and let a person decide.

In the sandbox

Name checks return made-up names. The same account number always returns the same name. Some account numbers trigger scripted results. See Test in the sandbox.

When it fails