NUBAN Banks

The NUBAN Banks API allows you to manage the list of banks and verify bank accounts across the different Nigerian payment channels that Asyncpay supports.

Fetch Banks

get

This endpoint fetches all the NUBAN banks that the payment gateways Asyncpay has integrated supports.

Authorizations
AuthenticationstringRequired
Responses
chevron-right
200Success
application/json
get
/v1/payouts/nuban/banks
200Success

Fetch Banks in Payment Channel

get

This endpoint limits the list to a specific payment channel and only returns the banks that the specified payment channel supports.

Authorizations
AuthenticationstringRequired
Path parameters
PaymentChannelSlugstringRequired

The slug of the payment channel whose supported banks you want to fetch

Example: paystack
Responses
chevron-right
200Success
application/json
get
/v1/payouts/nuban/banks/{PaymentChannelSlug}

Find Supported Payment Channels

get

This endpoint checks for the payment channels that supports a bank code.

Authorizations
AuthenticationstringRequired
Path parameters
bankCodestringRequired

The bank code of the bank you want to check supported payment channels for

Responses
chevron-right
200Success
application/json
get
/v1/payouts/nuban/banks/{bankCode}/supported-payment-channels
200Success

Verify Bank Account

post

This endpoint verifies the validity of a bank account using the account number, bank code, and payment channel.

This verification step is recommended before initiating a NUBAN payout. It helps confirm the account details are correct and retrieve the account holder’s name to ensure accurate payouts.

Authorizations
AuthenticationstringRequired
Body
account_numberstringRequired

The account number you want to verify

bank_codestringRequired

The code of the bank

payment_channelstring · nullableOptional

The slug of the payment channel you want Asyncpay to use to verify this bank account. If this field isn't provided, Asyncpay would select one for you from your available payment channels.

Responses
chevron-right
200Success
application/json
post
/v1/payouts/nuban/banks/verify-account
200Success

Last updated