5.2【行业收银台退款申请】


测试地址: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

业务返回说明

 

 


wuxl2 2025年7月24日 14:11 收藏文档