4.7【退款申请】


测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle

接口代码(transCode):2294

支持收银宝微信预消费功能退款:

  1. 以下订单类型,均支持退款。

订单类型

订单子类型

是否支持退款

消费

微信订单预消费

消费

微信订单完成

新增退款订单子类型:

订单类型

订单子类型

退款

微信订单退款

退款

微信订单完成退款

  1. 云商通退款处理逻辑说明:

退款申请时,根据商户订单号,检查云商通本地的订单是否已完成(微信订单完成)

收银宝侧交易

云商通侧交易

处理说明

预消费

预消费

1. D日退款交易申请时:

(1)仅允许全额退款

(2)不冻结退款资金,直接发送渠道退款(不动账)

2.  D+1日收银宝对账单:

无该笔预消费交易、及退款交易的对账单

已完成

已完成

1. D日退款交易申请时:

(1)支持部分退款

(2)常规退款:冻结退款资金,直接发送渠道退款(动账)

2. D+1日收银宝对账单:

(1)D日退款的交易:将该笔订单与云商通退款订单核对。

 

  1. 可退款金额控制逻辑:

(1)上送“商户订单号”发起退款时,校验该订单号无“微信订单完成”的交易,则控制仅允许全额退款

(2)已退款金额按照同一个“商户订单号”累计。例如:

说明

订单类型-订单子类型

商户订单号

通联订单号

订单金额

原商户订单号

原通联订单号

消费

消费-微信订单预消费

A

B

100

 

 

收银宝对账单出现“微信订单完成”后,补订单

消费-微信订单完成

A

C

100

 

 

对原“消费-微信订单预消费”发起退款,10元。

则累计已退款:10元,剩余可退:90元。

退款-微信订单完成退款

F

G

10

A

B

再次发起退款,上送通联订单号“C”退款,系统匹配到商户订单号A。

则累计已退款:10+30=40元,剩余可退60元

退款-微信订单完成退款

H

I

30

A

C

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

商户订单号-退款订单号

 

orgRespTraceNum

String

40

原通联订单号

原消费、担保消费、平台转账订单

orderAmount

Long

20

退款总金额

单位:分。

1.【消费申请】退款,

不上送退款列表:退款总金额,不能大于原订单金额-平台抽佣金额-分账金额

promotionAmount

Long

20

营销退款金额

单位:分

1.不能超过退款总金额;

2.不能超过原订单营销金额;

3.支持部分退款。

4.如不填,则不退营销退款金额,则“退款总金额”不能超过“原订单的订单金额-营销金额”

isFundAllocation

String

1

是否需要调拨资金

0:否

1:是

注:默认“0:否”;

仅“通联存管”支持上送“1:是”,上送“1”,则从收付通将资金调拨回收银宝,实现退款。

respUrl

String

256

后台通知地址

如果不填,则不通知。

退款成功、失败时,均发送通知

chnlDiscAmt

JSONObject

 

优惠信息

此字段只适用于银联云闪付单品优惠交易的退货,含单品优惠交易只能整单退款,不支持部分退款

详情

extendParams

String

200

扩展信息

接口将原样返回,不可包含“|”及换行符+,空格,/,?,%,#,&,=等特殊字符,最多100个字符

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

result

String

1

订单状态

订单成功时会发订单结果通知商户。

详情

reqTraceNum

String

50

商户订单号

 

respTraceNum

String

40

通联订单号

 

extendParams

String

200

扩展信息

接口将原样返回,最多50个字符,不可包含“|”特殊字符

channelParamInfo

JSONObject

 

渠道参数信息

渠道返回时有值

详细

respCode

String

5

业务返回码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

respMsg

String

200

业务返回说明

 

maxy2 2024年11月5日 09:59 收藏文档