---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/guide/bestPractices/currencyExchange/index.md
description: >-
  The Currency Exchange Guide introduces the specifications for handling
  transactions in different currencies in PingPongCheckout. When the displayed
  currency differs from the actual payment currency, a currency exchange
  operation is required. The document provides currency exchange request
  parameter examples, credit card and APM display examples, and explains key
  parameters in asynchronous notifications such as `currency` and
  `exchangedCurrency`. Developers are reminded that exchange rate fluctuations
  may cause amount discrepancies.
---
## Background

PingPongCheckout supports different transaction currencies for different payment methods. When the displayed transaction currency differs from the actual transaction currency, we need to perform a currency exchange operation.

## Terminology

1. Display amount, currency: The transaction currency requested in the order interface, as shown in the "Currency Exchange Request Parameters" image
2. Actual amount, currency: The transaction currency actually supported by PingPongCheckout under the current payment method, which is the amount and currency the user actually needs to pay

<br/>

## Currency Exchange Request Parameter Example
For example, the pricing currency displayed on the merchant website is USD, but the user's actual payment currency is HKD. The interface parameters are as shown in the image.

<v4-iImage :src="$withBase('/v4/guide/currencyexchangeapi.jpg')" name="Currency Exchange Request Parameters"></v4-iImage>

## Credit Card Display Example

<v4-iImage :src="$withBase('/v4/guide/creditexchange.jpg')" name="Currency Exchange"></v4-iImage>

## APM Display Example

<v4-iImage :src="$withBase('/v4/guide/currencyexchange.png')" name="Currency Exchange"></v4-iImage>

## Asynchronous Return Example

As shown in the asynchronous notification image, the `currency` parameter represents the display amount and currency, while the `exchangedCurrency` parameter represents the currency after exchange. For more details, please visit <a href="/en/notes/notify/payment/notify/" target="_blank">Asynchronous Notification API</a>.

<v4-iImage :src="$withBase('/v4/guide/notify.jpg')" name="Asynchronous Notification Example"></v4-iImage>

::: note Note
It should be noted that if payment is not completed for a long time, there may be situations where the displayed amount differs from the actual payment amount due to exchange rate fluctuations. We currently provide the following <a href="/en/notes/appendix/exchange/" target="_blank">currency exchange pairs</a>.
If business requirements need to configure exchange rules beyond the list, please consult technical support staff.
:::