Supported Currencies

Supported currencies, currency codes (ISO 4217), subunits, transaction minimums, and market availability.

Copy linkOverview

Paystack makes use of the ISO 4217 format for currency codes. When sending an amount to the API, it must be sent in the subunit of that currency.

Sending an amount in subunits simply means multiplying the base amount by 100. For example, if a customer is supposed to make a payment of NGN 100, you would send 10000 = 100 * 100 in your request.

In some markets, multiple currencies are supported, each with their own transaction fees and minimum amounts.

Copy linkCurrency codes and subunits

Currency CodeCurrency NameSubunitSubunit NameTransaction MinimumAvailability
NGNNigerian Naira100Kobo₦ 50.00Nigeria
USDUS Dollar100Cent$ 2.00Kenya and Nigeria
GHSGhanaian Cedi100Pesewa₵ 0.10Ghana
ZARSouth African Rand100CentR 1.00South Africa
KESKenyan Shilling100CentKsh. 3.00Kenya
XOFWest African CFA Franc-NoneXOF 1.00Côte d'Ivoire

Copy linkWorking with subunits

Copy linkBasic calculation

To convert an amount to its subunit representation:

amount_in_subunits = amount_in_base_currency × 100

Examples:

  • NGN 100 → 10000
  • USD 50 → 5000
  • GHS 25.50 → 2550
  • ZAR 1,000 → 100000

Copy linkAPI request example

When making a payment request, always use the subunit amount:

{
  "email": "[email protected]",
  "amount": 10000,
  "currency": "NGN"
}

This represents a payment of ₦100.

Copy linkSpecial case: XOF (West African CFA Franc)

Important: While there is no subunit for XOF, developers must still multiply the amount by 100 regardless. This doesn't imply that the amount can have a fractional part. If we notice a fractional part during processing, we ignore the fractional part.

Example:

{
  "email": "[email protected]",
  "amount": 10000,
  "currency": "XOF"
}

This represents a payment of XOF 100. The fractional part (if any) will be ignored during processing.

Copy linkTransaction minimums

Each currency has a minimum transaction amount. Attempts to process transactions below these minimums will be rejected with a validation error.

  • NGN: ₦ 50.00 (5,000 kobo)
  • USD: $ 2.00 (200 cents)
  • GHS: ₵ 0.10 (10 pesewa)
  • ZAR: R 1.00 (100 cents)
  • KES: Ksh. 3.00 (300 cents)
  • XOF: XOF 1.00 (100 units)

Copy linkMulti-currency support

Paystack enables merchants in specific markets to accept payments in multiple currencies. This allows:

  • Customers to pay in their preferred currency
  • Merchants to expand their market reach across borders
  • Better pricing with market-specific transaction fees

To learn more about enabling international payments and multi-currency support for your integration, see the Enabling International Payments article in our support documentation.

Copy linkCurrency in API responses

Currency information is included in API responses for transactions and other operations. For example, a transaction response will include:

{
  "status": true,
  "message": "Authorization URL created",
  "data": {
    "amount": 10000,
    "currency": "NGN",
    "reference": "7PVGX8MEk85tgeEpVDtD"
  }
}

Always reference the currency field in responses to determine which currency a transaction was processed in.