Skip to main content
POST
Verify settlement bank account
Verifies and saves the business’s settlement bank account. The returned account name must match the registered owner legal name or contact person.

Authorizations

x-api-key
string
header
required

Merchant API Key (e.g., nexa-prod-... or nexa-test-...)

Headers

x-business-env
enum<string>
default:prod

Target environment selector (live production vs. simulated sandbox).

Available options:
prod,
test

Body

application/json
accountNumber
string
required

Settlement account number (10 digits)

bankCode
string
required

Settlement bank's CBN code (e.g. 058 for GTB)

Response

Settlement bank account successfully verified and configured.

success
boolean
Example:

true

msg
string
Example:

"Bank account verified and saved"

bankAccount
object
businessName
string