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": "35214673103159414",
"refundRequestId": "202508271923022",
"refundAmount": "0.018",
"refundReason": "bourne-test"
}
'{
"code": "000000",
"data": {
"refundRequestId": "202508271923022",
"refundGateId": "1991045981847818240",
"prepayId": "35214673103159414",
"orderAmount": "10",
"refundAmount": "0.018",
"errMsg": "",
"orderCurrency": "USDT",
"payCurrency": "USDT",
"payAmount": "0.018"
},
"status": "SUCCESS",
"errorMessage": ""
}收银台退款接口 V2 版本,支持原路退、指定退等多种退款方式。
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": "35214673103159414",
"refundRequestId": "202508271923022",
"refundAmount": "0.018",
"refundReason": "bourne-test"
}
'{
"code": "000000",
"data": {
"refundRequestId": "202508271923022",
"refundGateId": "1991045981847818240",
"prepayId": "35214673103159414",
"orderAmount": "10",
"refundAmount": "0.018",
"errMsg": "",
"orderCurrency": "USDT",
"payCurrency": "USDT",
"payAmount": "0.018"
},
"status": "SUCCESS",
"errorMessage": ""
}Documentation Index
Fetch the complete documentation index at: https://docs.gate.com/llms.txt
Use this file to discover all available pages before exploring further.
POST /payment/open/institution/v2/standard/order/refund 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。
X-GatePay-On-Behalf-Of。refundRequestId 是商户侧退款请求唯一标识,查询退款详情时请使用该字段。refundBearType 与 refundAmountTypeFull 按数值枚举传入。refundRequestId、原订单业务标识与查询结果,方便后续对账。商户客户端ID
"mZ96D37oKk-HrWJc"
签名
时间戳(毫秒)
"1695611256106"
随机数
"1260554069"
必填代理归属请求头。请填写本次请求的发起方账户 ID;在机构代理商户 API 中通常填写目标子账户 ID,在机构代扣与划转接口中可填写机构账户 ID 或子账户 ID。
发起退款 请求参数
商户退款ID
"202508271923022"
订单ID
"35214673103159414"
退款金额
"0.018"
退款原因
"bourne-test"
退款方式 1:原路退 2:指定退
退款支付方式 1:Gate 2:Web3
退款至用户id
"10002"
退款网络
退款承担类型 1:需商家承担 2:需用户承担
退款备注
退款金额类型 1:全部退 2:部分退
是否需要触发退款结果通知;true 表示按商户配置的回调地址发送通知
退款是否限制次数
退款币种
"USDT"
发起退款的流水id
退款发起的源头 0:订单 1:流水