POST
/
merchants
/
accounts
/
topup
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/merchants/accounts/topup" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "X-Organisation-Id: FYH0NTVW0DXK" \
  --header "X-Merchant-Account-Number: 35253486" \
  --header "Accept-Language: en" \
  -d '{
    "merchantAccountNumber": 35253486,
    "connectorId": 550044,
    "topupAmount": 1000000,
    "createdBy": "johndoe@example.com"
  }'
"Merchant account topup is successful"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <Token>, where <Token> is your access token.

Headers

​
X-Organisation-Id
string
required

The organization identifier

​
X-Merchant-Account-Number
string
required

The merchant account number

​
Accept-Language
string
default:en

Preferred language for the response

Body

application/json
​
merchantAccountNumber
integer
required

Required string length: 8

Required range: 10000000 <= x <= 99999999
Example:

35253486

​
connectorId
integer
required

The connector ID for the transaction. See Get Connectors for available values.

Example:

550044

​
topupAmount
number
required

The amount to add to the merchant's balance

Required range: 0.01 <= x <= 5000000000
Example:

1000000

​
createdBy
string<email>
required

Email address of the user initiating the topup

Example:

"johndoe@example.com"

Response

200 - text/plain

Success Response (200)

The response is of type string.

Example:

"Merchant account topup is successful"