Skip to main content
POST
Register a bank account
Registration does three things in one call: it confirms the account number with the bank, stores the account against your business, and issues the on-chain addresses that pay it: address on Solana, and evmAddress on the EVM chains (Ethereum, Base, BNB Smart Chain, Monad and Arc, all at the same address). The call is idempotent per bank account. If the same bank code and account number have already been registered — by you or by anyone else on Paj — the existing record is returned unchanged, with the same addresses. There is no error and no duplicate. evmAddress can be missing for a short time after registration if issuing it was delayed; address is always present. Look the account up again with GET /pub/v2/bank-account a little later to get it.
Confirmation is a live call to the banking rail, so this endpoint is slower than the other two. Register accounts ahead of time rather than in a hot path like a checkout screen.
Use the returned accountName — it comes from the bank, not from your input — to let the user confirm they typed the right account number before you show them an address to pay. See Bank account addresses for what happens once funds reach the address. To follow a transfer to the address through to the payout, subscribe to its signature on the deposit socket.

Authorizations

x-api-key
string
header
required

Body

application/json
bankCode
string
required

Bank's code

Example:

"000016"

accountNumber
string
required

User's bank account number

Example:

"0025635480"

Response

The registered bank account

id
string
required

id

Example:

"someRANDOMid"

accountName
string
required

User's bank acount name

Example:

"John Doe"

accountNumber
string
required

User's bank account number

Example:

"0025635480"

bank
string
required

Bank name

Example:

"First Bank"

address
string
required

Solana address that pays this bank account. Any token sent to it on Solana is paid out as naira.

Example:

"FsXpXq8wVTM13NDXxrf2X6PpgJWg9jCxRVuHhtfnojUa"

evmAddress
string

EVM address that pays this bank account: the same address on every supported EVM chain. Absent for a short time after registration if it has not been issued yet.

Example:

"0x4B0897b0513fdC7C541B6d9D7E929C4e5364D2dB"