Skip to main content
POST
Validate an NGN bank account
Validate the account number with an institution code or institution name before creating an NGN recipient. Successful validation returns the resolved institution and account holder name:

Authorizations

X-Key-Id
string
header
required

This selects the registered RSA public key. Also send X-Timestamp, X-Idempotency-Id and X-Digital-Signature.

Headers

X-Key-Id
string
required

Also send X-Timestamp, X-Idempotency-Id and X-Digital-Signature. Sign the exact raw request bytes.

Example:

"prod-2026-02"

Path Parameters

storeId
string<uuid>
required

Body

application/json
accountNumber
string
required
Example:

"0123456789"

bankCode
string
required

Institution code or institution name

Example:

"058"

Response

Validation result

valid
boolean
required
Example:

true

bank
object
account_name
string
Example:

"SIMULATED HOLDER 1540"

message
string
provider
object
providerError
object