Integrations GuidesCurrency Supported

Supported Currencies

This document covers how to retrieve the list of currencies countries and their codes that can be used for payment processing with Chapa API.

When integrating with Chapa, you need to know which currencies are supported for payment processing. This endpoint provides you with a comprehensive list of all supported currencies.

Get Supported Countries and Currencies

Endpoint https://api.chapa.co/v1/currency_supported

Method GET

  • Authorization : Pass your secret key as a bearer token in the request header to authorize this call.
1import requests
2
3url = "https://api.chapa.co/v1/currency_supported"
4
5headers = {
6  'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx'
7}
8
9response = requests.get(url, headers=headers)
10print(response.text)

ℹ️
Refer to our Error Codes page for all responses for this request.

Response Structure

When successful, the API returns a JSON object with the following structure:

{
  "status": "success",
  "currency_code": [
        1,
        2
  ],
  "currency_name": [
        "ETB",
        "USD"
  ]
}

Response Parameters

ParameterTypeDescription
statusstringStatus of the request (always “success” for successful requests)
currency_codearrayArray of supported currency codes (e.g., 1, 2)
currency_namearrayArray of corresponding currency names (e.g., “ETH”, “USD”)

Use Cases

This endpoint is useful for:

  • Dynamic Currency Selection: Populate currency dropdowns in your payment forms
  • Currency Validation: Check if a currency is supported before initiating payments
  • User Experience: Display available payment options to customers
  • Integration Planning: Understand the scope of Chapa’s payment network

Example Implementation

// Fetch supported currencies
const response = await fetch('https://api.chapa.co/v1/currency_supported', {
  headers: {
    'Authorization': 'Bearer YOUR_SECRET_KEY'
  }
});
 
const data = await response.json();
 
// Validate currency before payment
function isCurrencySupported(currencyCode) {
  return data.currency_code.includes(currencyCode);
}
 
// Populate currency dropdown
data.currency_code.forEach((code, index) => {
  const option = document.createElement('option');
  option.value = code;
  option.textContent = `${code} - ${data.currency_name[index]}`;
  currencySelect.appendChild(option);
});

Best Practices

  1. Cache the Response: Since supported currencies don’t change frequently, consider caching the response to reduce API calls.

  2. Error Handling: Always implement proper error handling for cases where the API is unavailable.

  3. Currency Validation: Use this endpoint to validate currency codes before initiating payments to avoid failed transactions.

  4. User Experience: Display currency names along with codes to provide better user experience.

Split PaymentsChapa Receipt