DCC

动态货币转换 (DCC) 使国外消费者可以选择以当地货币或本国货币进行支付。您可以使用外汇查询接口获取交易货币与结算货币之间的汇率。

主要流程如下：

首先您需要调用 POST FXRateInquiry 接口查询消费者使用的卡片是否支持 DCC 功能，在您的请求中需要包含但不限于以下参数，字段详情参考 API 文档：

paymentMethod.type：表明支付方式的字段，如果是卡交易则使用 card。

paymentMethod.card：包含消费者卡信息以及终端信息的结构体。当 paymentMethod.type 为 card 时必填。

transAmount：以本地币种标价包含交易金额和交易币种的结构体。

merchantTransInfo：包含商户商户订单号的结构体。

DCC 汇率查询请求报文样例

检查 EVO Cloud 应答中的 FXRateInquiry.status 字段内容。如果字段的值为 Success 则表示消费者使用的卡片支持 DCC 功能，同时您将收到但不限于以下字段，字段详情参考 API 文档：

FXRateInquiry.DCCBillingAmount：包含以卡片扣账币种标价的交易金额和交易币种的结构体。

FXRateInquiry.DCCBillingFXRate：包含将交易币种转换为扣账币种是用到的汇率信息，其中包含了 Markup。

然后您需要在调用 POST Payment 接口发起支付时额外添加以下字段来表明这是一笔 DCC Payment：

origMerchantTransInfo.merchantTransID：原始汇率查询请求的订单号，需要与您在第1步中上送的 merchantTransInfo.merchantTransID 字段一致。

DCCBillingAmount：以卡片扣账币种标价的交易金额和交易币种的结构体。金额和币种需要与您在第2步中收到的 FXRateInquiry.DCCBillingAmount 结构体中的值一致。

transAmount：以本地币种标价包含交易金额和交易币种的结构体。需要与您在第1步中上送的 transAmount 结构体中的值一致。

备注

消费与预授权交易均支持 DCC 功能。

DCC 消费交易请求报文样例

检查 EVO Cloud 应答中的 payment.status 字段内容。如果字段的值为 Captured 则表示交易成功，否则就需要查看 result.code 以及 result.message 来查看交易失败原因。

如果您没有收到来自 EVO Cloud 的应答报文，则需要您调用 GET Payment 来查询交易结果。当收到查询应答时，您同样也需要通过 payment.status 字段内容来判断交易结果，判断方式与第2步一致。如果交易失败，您需要通过 payment.failureCode 以及 payment.failureReason 来查看交易失败原因。

如果您在请求中上送了 webhook，您也可以通过异步通知来获取交易结果。同样也需要通过 payment.status 字段内容来判断交易结果，判断方式与第2步一致。

向消费者展示付款结果。

DCC

DCC#

DCC