测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2281
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNumCashier |
String |
50 |
是 |
行业收银台商户订单号-退款订单号 |
|
orgRespTraceNumCashier |
String |
40 |
是 |
原收银台通联订单号 |
|
isRefundAll |
String |
2 |
否 |
是否全额原路退回 |
0:否 1:是,则对原【行业收银台下单】订单原路退回,包括退营销金额、平台抽佣金额、分账金额。 默认为:0。 当上送为1时,仅需上送orderAmount,promotionAmount、refundDetail、isAdvancePay字段不允许上送 |
orderAmount |
Long |
20 |
是 |
退款总金额 |
单位:分。 1.上送退款列表:退款总金额=订单退款列表中(退款金额)之和; 2.不上送退款列表:退款总金额,不能大于原订单金额-平台抽佣金额-分账金额 |
promotionAmount |
Long |
20 |
否 |
营销退款金额 |
单位:分 1.不能超过退款总金额; 2.不能超过原订单营销金额; 3.支持部分退款。 4.如不填,则不退营销退款金额,则“退款总金额”不能超过“原订单的订单金额-营销金额” |
refundDetail |
JSONArray |
否 |
退款详情 |
详情 | |
isFundAllocation |
String |
1 |
否 |
是否需要调拨资金 |
0:否 1:是 注:默认“0:否”; 仅“通联存管”支持上送“1:是”,上送“1”,则从收付通将资金调拨回收银宝,实现退款。 |
isAdvancePay |
String |
1 |
否 |
是否允许收款人垫资 |
0:否 1:是 注:默认“0:否”; 当上送“1:是”时,允许退款的资金全部从收款方出,不从分账方出 |
respUrl |
String |
256 |
否 |
后台通知地址 |
如果不填,则不通知。 退款成功、失败时,均发送通知 |
chnlDiscAmt |
JSONObject |
|
否 |
优惠信息 |
此字段只适用于银联云闪付单品优惠交易的退货,含单品优惠交易只能整单退款,不支持部分退款 |
summary |
String |
50 |
否 |
摘要 |
透传渠道 |
extendParams |
String |
200 |
否 |
扩展信息 |
接口将原样返回,不可包含“|”及换行符+,空格,/,?,%,#,&,=等特殊字符,最多100个字符 |
退款详情(refundDetail)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
orderAmount |
Long |
是 |
退款金额 |
从收款方退款的金额,单位:分 |
cnlRefundAmount |
Long |
否 |
渠道退款金额 |
仅资金管理管理模式为:账后结算时,上送该字段则退款至渠道 |
couponAmount |
Long |
否 |
平台抽佣退款金额 |
【担保消费申请】当账户类型上送从“1:薄记账户”时,可上送平台抽佣退款金额 |
sepDetail |
JSONArray |
否 |
分账退款列表 |
详情 |
分账退款列表(sepDetail)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signNum |
String |
是 |
分账方商户会员编号 |
|
amount |
Long |
是 |
分账方退款金额 |
单位:分 不大于原分账金额; |
remark |
String |
否 |
备注 |
|
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
result |
String |
1 |
否 |
订单状态 |
0:进行中 1:交易成功 2:交易失败 |
respTraceNumCashier |
String |
40 |
否 |
行业收银台通联订单号 |
|
reqTraceNumCashier |
String |
50 |
否 |
行业收银台商户订单号 |
|
extendParams |
String |
200 |
否 |
扩展信息 |
接口将原样返回,最多50个字符,不可包含“|”特殊字符 |
channelParamInfo |
JSON |
|
否 |
渠道参数信息 |
渠道返回时有值 |
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
业务返回说明 |
|