测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2294
支持收银宝微信预消费功能退款:
- 以下订单类型,均支持退款。
订单类型 |
订单子类型 |
是否支持退款 |
消费 |
微信订单预消费 |
是 |
消费 |
微信订单完成 |
是 |
新增退款订单子类型:
订单类型 |
订单子类型 |
退款 |
微信订单退款 |
退款 |
微信订单完成退款 |
- 云商通退款处理逻辑说明:
退款申请时,根据商户订单号,检查云商通本地的订单是否已完成(微信订单完成):
收银宝侧交易 |
云商通侧交易 |
处理说明 |
预消费 |
预消费 |
1. D日退款交易申请时: (1)仅允许全额退款 (2)不冻结退款资金,直接发送渠道退款(不动账) 2. D+1日收银宝对账单: 无该笔预消费交易、及退款交易的对账单 |
已完成 |
已完成 |
1. D日退款交易申请时: (1)支持部分退款 (2)常规退款:冻结退款资金,直接发送渠道退款(动账) 2. D+1日收银宝对账单: (1)D日退款的交易:将该笔订单与云商通退款订单核对。 |
- 可退款金额控制逻辑:
(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 |
是 |
业务返回说明 |