交易退款接口
通过此接口发起H5、PC、APP钱包支付退款接口，完成钱包支付退款操作，退款状态调用退款查询或对接退款异步通知接口获取。只有次日能发起退款，当日交易参考撤销接口。
业务请求参数
| 字段名称 | 字段key | 必填 | 格式 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 定值：order.refund |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 原商户订单号 | orderId | M | String(1,40) | |
| 商户退款单号 | refundId | M | String(1,40) | |
| 退款金额 | refundAmount | M | Number(22) | 退款币种为原支付单币种，单位为币种的最小单位，退款金额等于支付金额时为全额退款 |
| 退款交易结果通知地址 | refundNotifyUrl | O | String(1,256) | 退款交易结果后台通知地址，可传入，可在后台配置 |
| 原平台订单号 | transId | O | String(1,60) | |
| 退款原因 | reason | O | String(1,60) | 退款原因 |
请求示例报文
json
{
"appId": "000110011816681",
"funcode": "order.refund",
"version": "1.0.0",
"orderId": "f1e3Ceb6-4393-24Cf-a3b8-cF8988aecCA3",
"refundId": "bc431e8f-e62F-BE9F-1df5-B6D3d38Dc09C",
"refundAmount": "100",
"reason": "test refund",
"refundNotifyUrl": "http://127.0.0.1:10800/testNotify"
}接口同步返回
| 字段名称 | 字段key | 必填 | 类型 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 定值：order.refund |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 原商户订单号 | orderId | M | String(1,40) | |
| 商户退款单号 | refundId | M | String(1,40) | |
| 退款金额 | refundAmount | M | Number(1,22) | |
| 退款状态 | refundStatus | M | String(1,10) | |
| 原平台订单号 | transId | O | String(1,60) | |
| 平台退款订单号 | refundTransId | M | String(0,64) | |
| 响应时间 | responseTime | M | String(14) | |
| 响应码 | responseCode | M | String(1,16) | 参见 交易响应码 |
| 响应信息 | responseMsg | N | String(1,200) | 参见 交易响应码 |
| 错误码 | errorCode | M | String(1,16) | 请求失败时返回 参见 交易错误码 |
| 错误信息 | errorMsg | M | String(200) | 请求失败时返回 参见 交易错误码 |
返回示例报文
json
{
"appId": "000110011816681",
"funcode": "order.refund",
"orderId": "f1e3Ceb6-4393-24Cf-a3b8-cF8988aecCA3",
"refundAmount": "100",
"refundId": "bc431e8f-e62F-BE9F-1df5-B6D3d38Dc09C",
"refundStatus": "refunding",
"refundTransId": "2401081039176494201",
"responseCode": "success",
"responseMsg": "请求成功",
"responseTime": "20240108103917",
"version": "1.0.0"
}