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:

1. Active Currency Conversion Service
   Contact merchantsupport-ps@amazon.com to activate currency conversion for your merchant account.

2. Security Credentials
   Retrieve your integration credentials from the merchant dashboard:

   1. Log into your Amazon Payment Services account
   2. Navigate to Merchant Management → Security Settings
   3. 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

https://paymentservices.PayFort.com/FortAPI/paymentApi

Request Sample

Currency Conversion Request

{
    "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

Currency Conversion Response

{
    "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 support team at merchantsupport-ps@amazon.com.