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 Code | Currency Name | Subunit | Subunit Name | Transaction Minimum | Availability |
|---|---|---|---|---|---|
| NGN | Nigerian Naira | 100 | Kobo | ₦ 50.00 | Nigeria |
| USD | US Dollar | 100 | Cent | $ 2.00 | Kenya and Nigeria |
| GHS | Ghanaian Cedi | 100 | Pesewa | ₵ 0.10 | Ghana |
| ZAR | South African Rand | 100 | Cent | R 1.00 | South Africa |
| KES | Kenyan Shilling | 100 | Cent | Ksh. 3.00 | Kenya |
| XOF | West African CFA Franc | - | None | XOF 1.00 | Cô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.