Currency Conversion
Copy page
Copy page as Markdown for LLMs
Open in ChatGPT
Ask questions about this page
Open in Claude
Ask questions about this page
Live currency conversion is a feature provided by Amazon Payment Services that allows businesses to dynamically display prices in customers' local currencies. This service seamlessly converts prices stored on your server from your domestic currency into your customers' preferred currency, enhancing their shopping experience.
It's important to highlight that live currency conversion is only active during the shopping phase. Once a customer moves to checkout, the final transaction amount is displayed in your merchant account currency. Optionally, you can also show the equivalent amount in the customer's local currency for added transparency.
Conversion rate will be applied to the customer's transaction, based on their card currency being converted to your settlement currency. This rate is determined at the time of purchase and may include additional fees set by the card issuer, resulting in a final charge that may differ slightly from the estimated amount.
Prerequisites
Before implementing currency conversion, ensure you have:
-
Active Currency Conversion Service
Contact merchantsupport-ps@amazon.com to activate currency conversion for your merchant account. -
Security Credentials
Retrieve your integration credentials from the merchant dashboard:- Log into your Amazon Payment Services account
- Navigate to Merchant Management → Security Settings
- Save the following values:
- Access Code - Authentication token for API requests
- Merchant Identifier - Your unique merchant ID
- SHA Request/Response - Keys for signature calculation
Currency Conversion Integration
Use our currency conversion API to get real-time exchange rates for displaying prices in different currencies.
API Endpoints
https://sbpaymentservices.PayFort.com/FortAPI/paymentApi
Request Sample
{
"access_code": "s4lwuuoY5upZlZY5D6dr",
"amount": "1000",
"service_command": "CURRENCY_CONVERSION",
"currency": "USD",
"converted_currency": "AED",
"language": "en",
"merchant_identifier": "WeVJHPYm",
"signature": "{{signature}}"
}
To calculate the signature, please check the Signature Calculation section.
Before sending the transaction amount
, multiply it by the currency's decimal factor based on its ISO 3-letter code, e.g. AED (2 decimals): 500 AED should be sent in the request as 50000.
Response Sample
{
"amount": "10000",
"response_code": "42000",
"conversion_number": "1111",
"signature": "{{signature}}",
"merchant_identifier": "WeVJHPYm",
"access_code": "s4lwuuoY5upZlZY5D6dr",
"converted_currency": "AED",
"language": "en",
"service_command": "CURRENCY_CONVERSION",
"response_message": "Success",
"converted_amount": "272260",
"currency": "USD",
"status": "42"
}
To get a detailed view of all required and optional fields, see our API reference.
Support
Need assistance with currency conversion implementation? Contact our technical support team at merchantsupport-ps@amazon.com.