Add Payment Account

POST

/api/v1/merchants/payment-accounts

Add a new payment account for the merchant

Supports:

Bank accounts (requires: account_number, bank_name, account_holder_name)

Mobile money (requires: phone_number, network_provider)

Each merchant can have multiple accounts per currency, but only one primary per currency.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/merchants/payment-accounts' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currency_code": "NGN",
    "account_type": "bank_account",
    "is_primary": false,
    "account_number": "8061693852",
    "bank_name": "Moniepoint",
    "account_holder_name": "Adam Umar"
}'

Response Example

200 - Example 1

{}

Modified at 2025-10-20 09:43:53

Update Branding

Get Payment Accounts