curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v2/standard/order/refund \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"prepayId": "1991810932510167040",
"refundRequestId": "lux202511x093726",
"refundAmount": "0.018",
"refundReason": "test"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"refundRequestId": "lux202511x093725",
"refundGateId": "35803047115358215",
"prepayId": "1991810932510167040",
"orderAmount": "1.1",
"refundAmount": "0.018",
"errMsg": "",
"orderCurrency": "USDT",
"payCurrency": "USDT",
"payAmount": "0.018"
}
}对已支付订单发起退款,订单须为完成支付状态。
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v2/standard/order/refund \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"prepayId": "1991810932510167040",
"refundRequestId": "lux202511x093726",
"refundAmount": "0.018",
"refundReason": "test"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"refundRequestId": "lux202511x093725",
"refundGateId": "35803047115358215",
"prepayId": "1991810932510167040",
"orderAmount": "1.1",
"refundAmount": "0.018",
"errMsg": "",
"orderCurrency": "USDT",
"payCurrency": "USDT",
"payAmount": "0.018"
}
}商户在Gate商户后台注册应用时分配的clientId
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
请求签名。GatePay通过此签名来确定此请求是否合法
请求生成时的UTC时间戳,milliseconds。请注意,GatePay不处理收到请求时间与这个时间戳差距大于10秒钟的请求
"1672905655498"
随机字符串,字符符合HTTP Header头部的规范,建议长度在32个字符以内,字符串组成为数字和字母
"9578"
被代理的机构账户id
"2124538349"
商户退款 ID,由商户生成唯一并保证小于 32 字节
32订单 ID,订单须为完成支付状态才能发起退款
退款金额
退款原因
退款方式:1 原路退 2 指定退
退款支付方式:1 Gate 2 Web3
退款至用户 id,Gate 方式时必填
退款网络,Web3 时必填
退款承担类型:1 商家承担 2 用户承担
退款备注
退款金额类型:1 全部退 2 部分退
是否需要通知
退款是否限制次数
退款币种
发起退款的流水 id
退款发起的源头:0 订单 1 流水