---
title: Currency Exchange Guide
permalink: /en/notes/onlinePayment/bestPractices/currencyExchange/
createTime: '2025/03/07 16:01:49'
description: 'Understand transaction currency, exchanged amount, and settlement currency handling rules.'
---

## 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.
:::