发起退款
退款
发起退款
收银台退款接口 V2 版本,支持原路退、指定退等多种退款方式。
POST
发起退款
概述
本页说明POST /v2/standard/order/refund 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。
说明
- 认证方式使用 GatePay 标准签名请求头。
- 本页展示普通商户接口。
refundRequestId是商户侧退款请求唯一标识,查询退款详情时请使用该字段。refundBearType按数值枚举传入。- 商户后台手工发起的退款进度以后台展示为准,不应与 API 回调行为混为一谈。
- 对退款实现,建议同时保存
refundRequestId、原订单业务标识与查询结果,方便后续对账。 - 通用签名规则请参见 /api-reference/version/100/cn/common/securityAndSignature。
请求头
商户客户端ID
示例:
"mZ96D37oKk-HrWJc"
签名
时间戳(毫秒)
示例:
"1695611256106"
随机数
示例:
"1260554069"
请求体
application/json
发起退款 请求参数
商户退款ID
示例:
"202508271923022"
订单ID
示例:
"35214673103159414"
退款金额
示例:
"0.018"
退款原因
示例:
"bourne-test"
退款方式 1:原路退 2:指定退
退款支付方式 1:Gate 2:Web3
退款至用户id
示例:
"10002"
退款地址
退款网络
退款承担类型 1:需商家承担 2:需用户承担
退款备注
是否需要触发退款结果通知;true 表示按商户配置的回调地址发送通知
退款是否限制次数
退款币种
示例:
"USDT"
发起退款的流水id
退款发起的源头 0:订单 1:流水

