> For the complete documentation index, see [llms.txt](https://docs.coda.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coda.co/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codapay/zhi-fu-ye-mian-api-ji-cheng/fa-qi-usd-jiao-yi/usd-hui-tiao-tong-zhi.md).

# USD 回调通知

Coda 回调中的 `TotalPrice` 默认显示本地货币价格。如果合作伙伴需要在回调参数中显示 `InitRequest` 请求的 USD 价格，请通知 Codapay 支持团队进行配置。

以下是对比示例，USD 价格被追加到回调参数的末尾：

{% tabs %}
{% tab title="未配置USDPrice 回调" %}
[https://sample.com/notify/callback?TxnId=6366201293481272797\&OrderId=CodaTest\&TotalPrice=1426935.00&
\
PaymentType=23\&ResultCode=0\&Checksum=bbb4828b8d2a1bafb123a12b55d666f5](<https://sample.com/notify/callback?TxnId=6366201293481272797\&OrderId=CodaTest\&TotalPrice=1426935.00&&#xD;&#xA;PaymentType=23\&ResultCode=0\&Checksum=bbb4828b8d2a1bafb123a12b55d666f5>)
{% endtab %}

{% tab title="已配置USDPrice 回调" %}
[https://sample.com/notify/callback?TxnId=6366201293481272797\&OrderId=CodaTest\&TotalPrice=1426935.00&
\
PaymentType=23\&ResultCode=0\&Checksum=bbb4828b8d2a1bafb123a12b55d666f5\&USDPrice=100.00](<https://sample.com/notify/callback?TxnId=6366201293481272797\&OrderId=CodaTest\&TotalPrice=1426935.00&&#xD;&#xA;PaymentType=23\&ResultCode=0\&Checksum=bbb4828b8d2a1bafb123a12b55d666f5\&USDPrice=100.00>)
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
某些地区使用美元（USD）作为货币单位，因此回调参数中不会出现 `USDPrice`，例如柬埔寨。
{% endhint %}

### **USD 交易发起注意事项**

* 如果合作伙伴在发起请求时指定了 `payType`，我们将以本地货币返回价格。
* 如果未指定 `payType`（或使用 `payType=1` 进行通用 DCB 交易），则响应中不会包含价格。
* 如果合作伙伴使用 Coda 的支付页面API，系统将向用户显示本地货币价格。
* API 具有完全的向后兼容性，合作伙伴只需在 `"price"` 参数中发送 USD 金额，并在 `"currency"` 参数中使用 ISO 代码 `"840"`，即可启用此功能。

#### **关于金额的小数点处理**

* USD 金额可使用两位小数。
* 部分本地货币可能会被四舍五入为最接近的整数值（适用于 印度尼西亚（IDN）、日本（JPN）、缅甸（MMR）、越南（VNM）、老挝（LAO））。
* 其他国家的金额将被四舍五入至两位小数。

#### **不推荐使用 USD 交易的渠道**

* 某些具有特定定价要求的支付渠道（如 马来西亚 Maxis、印度尼西亚 Telkomsel），不建议使用 USD 交易请求。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coda.co/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codapay/zhi-fu-ye-mian-api-ji-cheng/fa-qi-usd-jiao-yi/usd-hui-tiao-tong-zhi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.