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日退款的交易:将该笔订单与云商通退款订单核对。

 

业务请求参数

字段

字段类型

必填

字段名称

说明

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个字符


maxy2 2026年4月22日 09:19 收藏文档