功能说明:
- 银行托管:仅支持收款会员(会员状态=有效),不支持分账,不支持营销和抽佣;
- 针对“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:是 |