---
title: 换汇说明
permalink: /notes/zh/onlinePayment/bestPractices/currencyExchange/
createTime: '2025/03/07 16:01:49'
description: '说明展示币种与支付币种不一致时的换汇处理方式，覆盖请求参数、通知字段和汇率波动注意事项。'
---

## 背景

PingPongCheckout 不同的支付方式支持不同的交易币种，当客户展示的交易币种与实际交易币种不一致时，那么我们需要进行换汇操作。

## 名词解释

1. 展示金额、币种：下单接口中请求的交易币种，如图"换汇请求参数"所示
2. 实际金额、币种：当前支付方式下，PingPongCheckout 实际支持的交易币种，即用户实际需要支付的金额和币种

<br/>

## 换汇请求参数示例
例如商户网站中显示的计价币种为 USD，用户实际支付币种为 HKD。那么接口传参如图所示。

<v4-iImage :src="$withBase('/v4/guide/currencyexchangeapi.jpg')" name="换汇请求参数"></v4-iImage>

## 信用卡展示示例

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

## APM 展示示例

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

## 异步返回示例

异步通知中如图所示，其中的`currency`参数是展示金额、币种，`exchangedCurrency` 参数代表换汇后币种，如需查看详情，请前往<a href="/notes/zh/notify/payment/notify/" target="_blank">异步通知API</a>。

<v4-iImage :src="$withBase('/v4/guide/notify.jpg')" name="异步通知示例"></v4-iImage>

::: note 提示
需要的注意的是如果长时间没有完成支付，那么有可能出现因为汇率波动导致展示金额与实际支付金额不一致的情况。我们目前提供以下<a href="/notes/zh/appendix/exchange/" target="_blank">换汇币种对</a>。
如果有业务需要配置列表以外的换汇规则请咨询技术支持人员。
:::