Skip to main content
POST
/
api
/
v1
/
org
/
balance
/
topup
curl --request POST \
  --url https://sandbox.api.afriex.com/api/v1/org/balance/topup \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "amount": 500,
  "currency": "USD"
}
'
{
  "data": {
    "status": "SUCCESS",
    "type": "DEPOSIT",
    "sourceAmount": "100",
    "sourceCurrency": "USD",
    "destinationAmount": "100",
    "destinationCurrency": "USD",
    "destinationId": "",
    "customerId": "",
    "transactionId": "69d6005dab82306f11b03360",
    "meta": {},
    "createdAt": "2026-04-08T07:14:37.568Z",
    "updatedAt": "2026-04-08T07:14:37.568Z"
  }
}
Credits the business wallet with the specified amount and currency.
This endpoint is only available in the sandbox/staging environment and will return a 403 Forbidden response in production. Use it during integration development to top up your test balance without making real transfers.

Authorizations

​
x-api-key
string
header
required

Static business API key from the dashboard

Body

application/json
​
amount
number<double>
required

A positive number representing the amount to credit.

Example:

500

​
currency
string
required

Uppercase 3-letter ISO 4217 currency code (e.g. USD, NGN, GBP). Must be a supported Afriex currency.

Example:

"USD"

Response

Balance successfully topped up. Returns the created transaction record.

​
data
object