根据原交易商户订单号、订单号或渠道支付流水号进行退款,支持部分退款。
特别说明:
1、存在优惠抵扣、积分和钱包的非分账订单不支持部分退款
2、ISV订单退款只支持根据外部订单号退款
3、存在优惠抵扣、积分和钱包的分账订单,收款店铺分账部分不支持部分退款
method:
非ISV订单退款:allinpay.shopoint.orderService.refund
ISV订单退款:allinpay.shopoint.orderService.isvRefund
version: 1.0
业务请求参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
reqRefundNo |
String |
是 |
64 |
外部退款单号 |
必须保证唯一 |
reqOrderNo |
String |
否 |
64 |
原外部订单号 |
三选一,同时传则取orderCode进行处理。对于全抵扣订单,不支持使用trxId进行退款。推荐使用orderCode进行退款。 |
orderCode |
String |
否 |
40 |
数字营销订单号 |
|
trxId |
String |
否 |
30 |
支付流水号 |
|
amount |
String |
否 |
14 |
退款金额 |
存在优惠抵扣、积分和钱包的非分账订单不支持部分退款 |
splitList |
JSONArray |
否 |
1024 |
分账退款信息 |
相见附录7.2 splitList字段说明。 分账订单退款使用,整单退不传。部分退时,若不传,则按退款金额与总金额的比例挨个从分账中退款。 |
noSplitAmount |
String |
否 |
14 |
退款未分账金额 |
预留字段,暂不可用 |
业务响应参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
code |
Integer |
是 |
4 |
返回码 |
0:表示成功; 3:表示失败,具体失败原因参见msg字段; 其他:参见4.1 公共返回码 |
|
msg |
String |
是 |
200 |
错误信息 |
|
|
data |
reqOrderNo |
String |
是 |
64 |
原交易外部订单号 |
|
orderCode |
String |
是 |
40 |
数字营销原交易订单号 |
|
|
refundNo |
String |
是 |
40 |
数字营销退款订单号 |
|
|
amount |
String |
否 |
14 |
退款金额 |
单位:元 |
|
trxId |
String |
否 |
30 |
渠道退款流水号 |
|
|
refundStatus |
Integer |
是 |
4 |
退款状态 |
1-退款中,2-退款成功,3-退款失败 |
|
refundTime |
String |
是 |
19 |
退款时间 |
时间格式:yyyy-dd-MM HH:mm:ss |
|
errMsg |
String |
否 |
200 |
失败描述 |
|
|
fee |
String |
否 |
14 |
手续费 |
单位:元 |
请求示例
{ “reqOrderNo”:”32132132132131”,” orderCode”:”11121212”}
响应示例
{
"code": 0,
"data": {
"reqOrderNo": “1212121212121”,
"orderCode": “1212121212121”,
"refundNo": “0000”,
"amount": “100”
}
"token": "DlRXdIjEBLRLCJgwTP37sZW6ls--NflxVS2-KUHl"
}