本接口为新增一笔退款的订单,并不会修改原来的订单状态。
订单退款接口需要私钥签名。
请求数据acsii排序,key=val方式连接,商户退款私钥加密,转16进制,放入sign字段。
如果商户没有设置商户退款公钥,默认123456。
测试接口地址:https://114.242.25.239:8200/common/doRefund
请求参数
字段名称 | 请求方式 | 必填 | 数据类型 | 长度 | 说明 |
orderNum | post | 三选一 | string | 18 | 原订单号 |
streamNo | post | string | 32 | 原开发者流水号 | |
waOrderNum | post | string | 32 | 原微信/支付宝流水号 | |
refundStreamNo | post | false | String | 32 | 开发者退款流水号 |
amt | post | true | int | 20 | 退款金额(以分为单位,没有小数点) |
refundPass | post | false | string | 10 | 主管密码,对密码进行md5加密,默认为123456 |
attach | post | false | string | 200 | 附加信息,异步通知接口或查询时原样返回 |
terminalSn | post | false | string | 20 | 商户终端设备号,如pos的sn |
divideDetail | post | false | string | 255 | 分账明细(例:[{“merchantNo”:”003020051110111″,”amount”:”2″},{“merchantNo”:”003020051110112″,”amount”:”1″}]) |
返回参数
字段名称 | 必填 | 数据类型 | 长度 | 说明 |
amt | true | int | 32 | 退款金额(以分为单位,没有小数点) |
orderNum | true | string | 18 | 退款订单号 |
tradeState | True | int | 1 | 订单状态: 6退款申请中7退款完成8退款被拒绝 |
originalOrderNum | true | string | 18 | 原订单号 |
返回示例
{
“message”: “退款申请成功”,
“retCode”: “SUCCESS”,
“sign”: “XXXXXXXXXXXXXXXXXXX”,
“data”: {
“amt”: “1”,
“orderNum”: “416589087516917760”,
“originalOrderNum”: “416587267486777344”,
“tradeState”: “6”
}
}
失败返回示例
{“message”:”可退金额不足”,”retCode”:”FAILED”}