5.1【消费申请】接口


测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle

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

接口代码(transCode):2085

功能说明:

1、收款会员仅支持会员进件生成的商户号收款,收款后通过【批量分账】接口分账。

2、订单类型“消费”,对应订单子类型为“商户收款”;

  • 新增支持收银宝微信订单预消费:

(1)若请求上送的支付模式为:“收银宝微信小程序支付-WECHATPAY_MINIPROGRAM”,则需根据收银宝“响应的交易类型处理:

收银宝响应的交易类型

云商通处理

VSP681:微信订单预消费

 

更新订单支付模式为:微信订单预消费-WECHAT_PRECONSUME

更新订单子类型为:微信订单预消费

订单不动账

其他

原流程,正常更新订单状态、动账

(2)并在同步响应中增加响应字段isPreConsume

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

signNum

String

60

商户会员编号-付款人

商户系统用户唯一标识

付款会员无需注册

receiverSignNum

String

60

商户会员编号-收款人

商户系统用户唯一标识

支持个人会员、企业会员

 

reqTraceNum

String

50

商户订单号

 

orderAmount

Long

20

订单金额

单位:分

订单金额=支付金额+营销金额

promotionAmount

Long

20

营销金额

单位:分

payAmount

Long

20

支付金额

单位:分

渠道实际需支付金额

payMode

JSONObject

256

支付模式

详见支付模式字典

详情

注“支付金额”为空或0时,可不送

reqsUrl

String

256

前台通知地址

 

respUrl

String

256

后台通知地址

 

orderValidTime

String

20

订单过期时间

 

goodsType

String

2

商品类型

 

bizGoodsNo

String

32

商户商品编号

 

goodsName

String

50

商品名称

如下支付模式必填:

1.快捷支付

2.H5收银台

3.微信小程序收银台

4.支付宝小程序收银台

summary

String

100

摘要

 

extendParams

String

200

扩展参数

 

txDistrictCode

String

2

交易所在省市

仅智能路由时需要上送,

上送2位的地区码,如:11为北京

goodsDesc

String

256

商品描述

使用云商通收银台时,可展示商品信息

按照:商品名称1#金额##商品名称2#金额

的格式上送,则收银台界面可展示商品(金额为元)

业务响应参数

字段

字段类型

必填

字段名称

说明

result

String

订单状态

仅交易验证方式为“0”时返回

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

详情

respMsg

String

订单失败信息

 

respTraceNum

String

通联订单号

 

reqTraceNum

String

商户订单号

 

extendParams

String

扩展参数

 

channelParamInfo

JSONObject

渠道参数信息(支付详情)

渠道返回时有值

详细

chnlFrontParamInfo

JSONObject

渠道参数信息(前端支付参数)

渠道返回时有值

详细

(1)扫码支付信息/ JS支付串信息(微信、支付宝、QQ钱包)
(2)交易验证方式(收银宝快捷)
(3)收银宝小程序收银台支付参数(inner)
(4)收银宝手机安全控件支付参数(inner)
(5)云商通收银台支付链接ystCashierUrl

客户对接提醒:前端调用方法不要用取字段的方式,避免加字段后签名失败。

respCode

String

业务返回码

00000:代表成功

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

其他返回码:均代表失败

respMsg

String

业务返回说明

 

isPreConsume

String

是否微信订单预消费

 目前仅支持在订单子支付模式为微信订单预消费时返回

枚举值:

0:否

1:是


maxy2 2025年4月18日 11:17 收藏文档