1. Features
Merchant Connect API
  • 版本记录
  • Integration Guide
    • EC Payment
      • Merchant API
        • Overview
        • Payment
        • Payment Methods
        • Response code
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
        • Features
          • Account Status Inquiry (ASI)
          • COF
          • Multi-Currency Transaction
          • Recurring
          • Smart Routing
          • Transaction Retry
          • Payout
          • Authentication
            • 3D Secure
            • FIDO Authentication
            • Authentication only
          • Tokenization
            • Gateway Tokenization
            • Create a gateway token
            • Network Tokenization
            • Pay with gateway token
            • Manage token
            • Network Token update notification
            • Card Based Network Token
    • In-store Payment
      • Merchant API (线下卡支付)
        • ZPK
          • ZPK
        • Payment
          • Payment
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
  • API Explorer
    • API Rules
  • PaymentMethod
    • PaymentMethod
      POST
    • PaymentMethod
      PUT
    • PaymentMethod
      GET
    • PaymentMethod
      DELETE
  • FXRateInquiry
    • FXRateInquiry
      POST
    • FXRateInquiry
      GET
  • Payment
    • Payment
    • Payment
    • Payment
  • Payout
    • Payout
    • Payout
  • Capture
    • Capture
    • Capture
  • Cancel
    • Cancel
    • Cancel
  • Refund
    • Refund
    • Refund
  • Cryptogram
    • Cryptogram
    • Cryptogram
  • CancelOrRefund
    • Cancel or Refund
    • Cancel or Refund
  • Notification
    • Notification for PaymentMethod
    • Notification for Payment
    • Notification for Capture
    • Notification for Cancel
    • Notification for Refund
    • Notification for DataSubmission
    • Notification for MPM Static QR Code
    • Notification for Token Status Update
    • Notification for Settlement
    • Notification for Reversal
    • Notification for Cryptogram
    • Notification for Payout
  • HealthCheck
    • HealthCheck
  • ZPK
    • ZPK
  • 附录
    • Result Code
    • Appendix: Payment Method Variant
    • Appendix: Payment Brands
  • Coupon Write-off
    • Coupon Write-off
  • Coupon Reversal
    • Coupon Reversal
  1. Features

Multi-Currency Transaction

仅适用于线上(EC)场景。
在线上交易中,商户经常面对来自不同国家的用户。交易发生时,用户通常更希望使用本国货币进行交易。因此,EVO Cloud 提供了汇率查询(FX Rate Inquiry)和多币种定价(Multi-Currency Price,MCP)两项功能,以满足商户的需求。

汇率来源设置#

您可以在 EVO Cloud 门户中配置各场景使用的汇率来源。汇率来源分为两类:EVO Cloud 汇率(EVO Cloud FX Rate)和收单机构汇率(Acquirer FX Rate)。
在 EVO Cloud 汇率下,您还可以针对不同卡组织(包括 Visa、Mastercard 和 JCB)指定汇率。此外,EVO Cloud 支持自动选择优惠汇率(Priority FX Rate)。详情请参阅《EVO Cloud 门户用户手册》。
如果您将汇率来源配置为收单机构汇率,请注意,在 EVO Cloud 门户中设置汇率后,最长可能需要等待 5 分钟,才能在 API 调用中使用这些汇率。

汇率查询(FX Rate Inquiry)#

该服务使商户能够获取每日汇率,并据此对商品重新报价。收单机构可以定义汇率来源,或设置自定义汇率及加价(markup)。

汇率来源设置#

您可以在 EVO Cloud 门户中配置汇率查询所使用的汇率来源。汇率来源分为两类:EVO Cloud 汇率和收单机构汇率。在 EVO Cloud 汇率下,您还可以针对不同卡组织(包括 Visa、Mastercard 和 JCB)指定汇率。此外,EVO Cloud 支持自动选择优惠汇率。详情请参阅《EVO Cloud 门户用户手册》。

汇率查询请求#

您可以从服务端向 EVO Cloud 以下接口发起 HTTP GET 请求:
/g2/v1/payment/mer/{sid}/FXRateInquiry
并指定以下额外参数:
参数是否必填说明
baseCurrencyM被转换的原币种代码。
quoteCurrencyM转换后的目标币种代码。
如果汇率来源为 EVO Cloud 汇率,您可以查询任意两种币种之间的汇率。但如果汇率来源为收单机构汇率,您需要先在 EVO Cloud 门户中配置相应汇率,才能通过 API 获取。
以下是不带任何查询参数的请求示例:
响应中的 localToTransFXRate 对象包含汇率信息,字段如下:
1.
baseCurrency:被转换的原币种代码。
2.
quoteCurrency:转换后的目标币种代码。
3.
date:汇率值,精确到小数点后 7 位。
4.
value:汇率处理日期。
详情请参阅*《EVO Cloud API 规范》*。
以下是响应示例:

多币种定价(MCP)#

步骤 1:获取转换后的交易金额#

您可以从服务端向 EVO Cloud 以下接口发起 HTTP POST 请求:
/g2/v1/payment/mer/{sid}/FXRateInquiry
并指定以下额外参数:
参数是否必填说明
merchantTransInfoM汇率查询的参考信息,包括唯一的 merchantTransID,以及表示您发起请求时间的 merchantTransTime。
transAmountM支付转换后的币种。金额必须符合该币种的最小单位规则。
localAmountM支付转换前的币种和金额。金额必须符合该币种的最小单位规则。
如果汇率来源为 EVO Cloud 汇率,您可以查询任意两种币种之间的汇率。但如果汇率来源为收单机构汇率,您需要先在 EVO Cloud 门户中配置相应汇率,才能通过 API 获取。
以下是将 THB 转换为 HKD、获取转换后交易金额的示例:
请求成功时,响应中会包含 transAmount 对象,展示转换后的交易金额和币种。
transAmount 对象详细说明:
1.
fxRateInquiry.status:汇率查询的状态(必填),取值可为 Success 或 Failed。
2.
fxRateInquiry.transAmount:支付经货币转换后的币种和金额(必填)。您需要在步骤 2 的 POST 支付请求中使用相同的币种和金额。
以下是请求成功的响应示例:
您可以从服务端向 EVO Cloud 以下接口发起 HTTP POST 请求:
/g2/v1/payment/mer/{sid}/payment
并指定以下额外参数,发起 MCP 支付。
查询参数
参数是否必填说明
merchantTransIDM初始汇率查询的 merchantTransInfo.merchantTransID。
Body 参数
参数是否必填说明
merchantTransInfoM支付的参考信息,包括唯一的 merchantTransID,以及表示您发起请求时间的 merchantTransTime。
transAmountM支付的币种和金额。金额必须符合该币种的最小单位规则,且必须与 paymentMethod 中指定的金额相同。
paymentMethodM使用 paymentMethod.type 指定支付方式类型,例如电子钱包或银行卡支付,并携带上一步收集的相关支付信息。
transInitiatorM发起交易的设备信息。
storeInfoO补充的门店信息。当您的门店在 EVO Cloud 中配置了多个 MCC 时必填,用于指明本次支付使用的 MCC。
tradeInfoO当 paymentMethod.e-wallet.paymentBrand 为 Alipay 时必填,用于说明本次支付的详细信息。
userInfoO买家的详细信息。如能获取请传入,有助于 EVO Cloud 进行反洗钱和欺诈检测,并提升支付成功率。
validTimeO当 paymentMethod.type 为 e-wallet 时适用,表示订单的有效时间(分钟)。支付只能在该时间之前完成。如有特殊要求,请联系 EVO Cloud 客户经理。
returnURLO用户完成或取消支付后,跳转回您页面的 URL。
webhookO接收通知的 URL。传入该参数后,支付成功时将收到 EVO Cloud 的通知。
metadataO请求中自定义的参考信息,会在响应中原样返回。除 GET 请求外,响应中的 metadata 与请求报文中的相同;GET 响应中的 metadata 与 POST 请求报文中的相同;通知中也会携带 POST 请求中的 metadata。
以下是将 THB 转换为 USD 发起 MCP 支付的示例:
tip
后续步骤取决于支付响应中是否包含 action 对象。详情请参阅 Payment 章节。
上一页
COF
下一页
Recurring
Built with