Refund
发起退款请求
步骤 1：发起退款请求
payment.status 为 Captured 时，可以从服务端向 EVO Cloud 以下接口发起 HTTP POST 请求：| 查询参数 | 是否必填 | 说明 |
|---|---|---|
merchantTransID | M | 初始支付的 merchantTransInfo.merchantTransID。 |
| Body 参数 | 是否必填 | 说明 |
|---|---|---|
merchantTransInfo | M | 退款交易的参考信息，包括唯一的 merchantTransID，以及表示您发起请求时间的 merchantTransTime。 |
transAmount | M | 退款的币种和金额。金额必须符合该币种的最小单位规则。 |
initiatingReason | O | 您可在该字段中说明发起本次请求的原因。 |
webhook | O | 接收通知的 URL。传入该参数后，支付成功时将收到 EVO Cloud 的通知。 |
metadata | O | 您可在请求中自定义的参考信息，会在响应中原样返回。 |
1.
refund.status：本次退款的状态，必填，取值可为 Success、Failed 或 Received。如果 refund.status 为 Received，您需要再发起一次 HTTP GET 请求获取本次退款的最终状态（详情请参阅步骤 2），或等待 EVO Cloud 的通知 Webhook。2.
refund.transAmount：退款的币种和金额，必填，从您的请求中原样返回。3.
refund.merchantTransInfo：退款交易的参考信息对象，由您的服务端生成，必填，从您的请求中原样返回。4.
refund.evoTransInfo：退款交易的参考信息对象，由 EVO Cloud 生成，必填。包含 evoTransID、evoTransTime、traceNum（可选），以及部分 PSP（如 Visa 或 Mastercard）的 retrievalReferenceNum。5.
refund.pspTransInfo：退款交易的参考信息对象，由 PSP 生成，可选。包含 pspTransID、pspTransTime 和 authorizationCode。如果 PSP 返回了这些信息，EVO Cloud 会将其转发给您的服务端。6.
refund.billingAmount 和 refund.billingFXRate：用户账单币种及完成金额，以及 refund.transAmount.currency 与 refund.billingAmount.currency 之间的汇率，可选。如果 PSP 返回了这些信息，EVO Cloud 会将其转发给您的服务端。适用于 PSP 进行货币转换的部分电子钱包支付，或您开通 DCC 功能的部分银行卡支付。详情请联系 EVO Cloud 客户经理。7.
refund.convertTransAmount 和 refund.convertTransFXRate：交易发送至 PSP 时，EVO Cloud 根据 transAmount 及 transAmount.currency 到其他币种的汇率计算出的币种和金额，以及 refund.transAmount.currency 与 refund.convertTransAmount.currency 之间的汇率，可选。当您在 EVO Cloud 开通货币转换功能且本次完成使用了货币转换时，会提供该汇率。详情请联系 EVO Cloud 客户经理。步骤 2：查询退款结果
refund.status 为 Received，且您未使用通知 Webhook，可以向 EVO Cloud 查询最终结果。| 查询参数 | 是否必填 | 说明 |
|---|---|---|
merchantTransID | M | 初始退款交易的 merchantTransInfo.merchantTransID。 |
改为发起撤销
result.code 为 B0012，请检查响应报文中 payment.status 的原交易状态。如果为 authorised，说明该笔支付尚未完成，因此无法退款。此时您需要改为发起撤销。详情请参阅 Cancel（撤销） 章节。