4.5【消费申请(综合支付)】


功能说明:

  • 银行托管:仅支持收款会员(会员状态=有效),不支持分账,不支持营销和抽佣;
  • 针对“POS及当面付、付款码支付”等线下支付模式,可以不上送付款方会员相关字段
  • 银行卡协议支付:付款会员需先注册;非银行卡协议支付:付款会员无需注册但接口需商户付款方会员相关信息;
  • 订单类型及子类型说明:订单类型“消费”,对应订单子类型为“商户收款”;
  • 新增支持收银宝微信订单预消费:

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

收银宝响应的交易类型

云商通处理

VSP681:微信订单预消费

 

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

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

订单不动账

其他

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

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

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

signNum

String

60

商户会员编号-付款人

商户系统用户唯一标识

银行卡协议支付:付款会员需先注册

非银行卡协议支付:付款会员无需注册

receiverSignNum

String

60

商户会员编号-收款人

商户系统用户唯一标识

支持个人会员、企业会员,不支持平台会员(平台会员不设置角色)

reqTraceNum

String

50

商户订单号

 

orderAmount

Long

20

订单金额

单位:分

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

payAmount

Long

20

支付金额

单位:分

渠道实际需支付金额

不上送时,则“营销金额”必送,即:订单金额=营销金额;

promotionAmount

Long

20

营销金额

单位:分

平台承担的营销金额

couponAmount

Long

20

平台抽佣金额

单位:分

仅上送“收款会员编号”时有效;

verifyType

String

1

交易验证方式

(余额)

0:无验证

1:短信验证码

默认-1:短信验证码

payMode

String

256

支付模式

详见支付模式字典

详情

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

reqsUrl

String

256

前台通知地址

 

respUrl

String

256

后台通知地址

 

orderValidTime

String

20

订单过期时间

 

goodsType

String

2

商品类型

 

bizGoodsNo

String

32

商户商品编号

 

goodsName

String

50

商品名称

支付方式为QUICKPAY_VSP(快捷支付)时必须上送校验必填

summary

String

100

摘要

 

extendParams

String

200

扩展参数

 

txDistrictCode

String

2

交易所在省市

仅智能路由时需要上送,

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

goodsDesc

String

256

商品描述

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

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

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

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

result

String

1

订单状态

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

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

详情

respTraceNum

String

40

通联订单号

 

reqTraceNum

String

50

商户订单号

 

extendParams

String

200

扩展参数

 

channelParamInfo

JSONObject

 

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

渠道返回时有值

详细

chnlFrontParamInfo

JSONObject

 

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

渠道返回时有值

详细

(1)扫码支付信息/ JS支付串信息(微信、支付宝、QQ钱包)

(2)交易验证方式(收银宝快捷)

(3)收银宝小程序收银台支付参数(inner)

(4)收银宝手机安全控件支付参数(inner)

(5)云商通收银台支付链接ystCashierUrl

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

respCode

String

5

业务返回码

00000:代表成功

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

其他返回码:均代表失败

respMsg

String

200

业务返回说明

 

isPreConsume

String

40

是否微信订单预消费

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

枚举值:

0:否

1:是


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