2.2【退款申请】


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle

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

接口代码(transCode):2294

功能说明:

1.支持消费申请发起退款,支持1年内的订单发起退款。

2.支持全额退款、部分金额退款,退款金额不得超过原订单金额;

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

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

收银宝侧交易

云商通侧交易

处理说明

预消费

预消费

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

支持部分退款,不冻结退款资金,直接发送渠道退款(不动账)

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

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

已完成

已完成

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

(1)支持部分退款

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

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

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

4.资金管理模式:银行托管、交易处理,退款订单支持跨模式互通。。

业务请求参数

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

是

商户订单号-退款订单号

 

orgRespTraceNum

String

是

原通联订单号

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

orderAmount

Long

是

退款总金额

单位:分。

退款总金额,不能大于原订单金额

respUrl

String

否

后台通知地址

如果不填,则不通知。

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

chnlDiscAmt

JSONObject

否

优惠信息

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

详情

extendParams

String

否

扩展信息

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

wechatPayB2bRefundDetail

JSONObject

否

B2b门店助手退款详情

仅原交易的支付模式为WECHATPAY_B2b时处理,其他支付模式不报错、也不处理

详情

remark

String

否

备注信息

业务备注信息

reason

String

否

退款理由

微信交易,上送在微信退款通知里展示

业务响应参数

字段

字段类型

必填

字段名称

说明

result

String

否

订单状态

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

详情

respMsg

String

否

订单失败信息

仅“交易失败”时,有值

reqTraceNum

String

是

商户订单号

 

respTraceNum

String

是

通联订单号

 

extendParams

String

否

扩展信息

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

channelParamInfo

JSO

否

渠道参数信息

渠道返回时有值

详细

respCode

String

是

业务返回码

00000:代表成功

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

其他返回码:均代表失败

 

wechatPayB2bRefundDetail-B2b门店助手退款详情JSON

字段

字段类型

必填

字段名称

说明

refundFrom

String

否

退款来源

枚举值:

1:人工客服退款 2:用户自己退款 3:其他

客户未上送则固定送1

refundReason

String

否

退款原因

枚举值

0:暂无描述 1:产品问题 2:售后问题 3:意愿问题 4:价格问题5:其他原因

description

String

否

退款商品描述

 

最长127个字符


2026年5月27日 14:00 收藏文档