3.5.10订单退款


根据原交易商户订单号、订单号或渠道支付流水号进行退款,支持部分退款。

特别说明:

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"

}

 


2025年11月19日 14:42 收藏文档