2.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

业务请求参数

字段

字段类型

必填

字段名称

说明

 

reqTraceNum

String

商户订单号

   

orderAmount

Long

订单金额

单位:分

 

payAmount

Long

支付金额

单位:分

渠道实际需支付金额

 

payMode

JSONObject

支付模式

详见支付模式字典

详情

 

reqsUrl

String

前台通知地址

   

respUrl

String

后台通知地址

   

orderValidTime

String

订单过期时间

格式:yyyy-MM-dd HH:mm:ss,除特殊说明外,默认过期时间为1小时


注:除B2B门店助手交易(72小时)外,其他支付模式最长时间限制为24小时。

 

goodsName

String

商品名称

   

summary

String

摘要

   

extendParams

String

扩展参数

   

txDistrictCode

String

交易所在省市

仅智能路由时需要上送,

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

 

goodsDesc

String

256

商品描述

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

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

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

业务响应参数

字段

字段类型

必填

字段名称

说明

result

String

订单状态

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

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

详情

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月24日 14:07 收藏文档