交易订单退款接口
接口说明
- 该接口用于当日与多日退款,为避免日切,退款接口的调用时间为每天的00:00—23:45;
请求方法
方法名
- fshows.liquidation.pay.refund
请求参数
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
out_trade_no |
String |
特殊必须 |
64 |
渠道方订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的渠道方系统中不重复 |
trade_no |
String |
特殊必须 |
64 |
移动支付平台的订单号,在支付平台中唯一,此参数和服务商订单号不能同时为空 |
out_refund_no |
String |
必须 |
32 |
外部退款号,由渠道方生成,用于标记该退款请求 |
refund_fee |
String |
选填 |
9 |
退款金额。不填写视为全额退款。 |
请求示例
{
"method":"fshows.liquidation.pay.refund",
"app_id":"2016072300007148",
"sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
"version":"1.0"
"content":{
"trade_no":"2017090621163401776323858953",
"out_refund_no":"201612091309737131141"
}
}
返回值
参数 |
类型 |
最大长度 |
描述 |
out_refund_no |
String |
32 |
外部退款号(渠道方退款号) |
refund_no |
String |
32 |
移动支付平台退款号(morp退款号) |
out_trade_no |
String |
64 |
渠道方订单号 |
trade_no |
String |
64 |
移动支付平台的订单号 |
返回值示例
成功返回示例:
{
'return_value': {
'out_refund_no': '9372337512889012460',
'refund_no': '2018112311040202649968722855T',
'out_trade_no': '3559cee6eecc11e88168e0d55e7b31d0',
'refund_status': 'REFUND_SUCCESS',
'trade_no': '2018112311023402672031278483N'
},
'success': True
}
失败返回示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}