Exchange Rate

Description: Provides PAPSS foreign exchange conversion rates for supported currency corridors.

Use Case

Called before payment initiation to:

• Display expected beneficiary amount.
• Calculate exchange conversion.
• Estimate transaction value.

Sample Request

Request Parameters

POST {base_url} /api/v1/epapss/exchange-rate

curl `{base_url} /api/v1/epapss/exchange-rate`
  -H "subscription-key: 2df8a91s8d7a1"
  -H "X-client-Id: 432987234"
  -H "Content-Type: application/json"
  -d '{
    "sourceCountry": "NG",
    "destinationCountry": "GH",
    "amount": 5000
  }
'

Sample Response

Sample Success Response

POST {base_url} /api/v1/epapss/exchange-rate

{
  "message": "Exchange rate retrieved successfully",
  "status": "Success",
  "data": {
    "rateTimestamp": "2026-06-22T15:47:14Z",
    "usdToSenderCurrencyRate": 1405.0,
    "usdToReceiverCurrencyRate": 11.4343,
    "senderToReceiverCurrencyRate": 0.0081375,
    "senderAmount": 12000.0,
    "receiverAmount": 97.65,
    "usdExchangeAmount": 8.54,
    "senderCurrencyFeeAmount": 1405.0,
    "usdFeeAmount": 1.0
  }
}