8.1 支付模式


云商通联调环境下,各支付模式对接支付渠道侧环境,查看对应关系

1. 微信正扫

(1)字段说明

支付模式:SCAN_WEIXIN

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

extendParams

String

渠道拓展参数,最长1000字符

cerNum

String

证件号

name

String

付款人姓名

cerType

Long

证件类型

仅支持“1-身份证”

(2)使用说明

1.订单请求,不返回“订单状态”,返回“扫码支付信息”,供转化为二维码。

2.无需调用任何确认支付接口。

3.订单结果通知提供。

 

2. 微信JS

(1)字段说明

支付模式:WECHAT_PUBLIC

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号,与公众号对应

集团模式,必填

subAppid

String

收银宝子商户号,微信公众号支付 appid 参数

extendParams

String

渠道拓展参数,最长1000字符

acct

String

微信JS支付openid——微信分配

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

goodsTag

String

订单支付标识,订单优惠标记,用于区分订单是否可以享受优惠,字段内容在微信后台配置券时进行设置,只对微信支付有效

benefitDetail

JSONObject

优惠信息,benefitdetail的json字符串,注意是String,微信单品优惠

详情

chnlStoreid

String

渠道门店号--商户在支付渠道端的门店编号

subBranch

String

门店号

cerNum

String

证件号

name

String

付款人姓名

cerType

Long

证件类型

仅支持“1-身份证”

(2)使用说明

1.订单请求,不返回“payStatus”, 返回“payInfo支付串信息”,对应微信JS支付,json字符串。商户在微信APP:调用微信浏览器内通过JavaScript调用getBrandWCPayRequest发起支付

2.无需调用云商通确认支付接口。

3.订单结果通知通过【订单结果通知】提供。

附:

(1)微信公众号获取openid官方文档

https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_4#

https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html

(2)微信公众号JSAPI官方文档

https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6

微信公众号支付请求云商通响应payinfo示例:

{"appid":"00000006","cusid":"XXXXXXXX","payinfo":"{\"appId\":\"wxb3fa424b649563b5\",\"timeStamp\":\"1477356696\",\"signType\":\"MD5\",\"package\":\"prepay_id=wx201610250851362b67f0b6570252306441\",\"nonceStr\":\"38642\",\"paySign\":\"66FF000B739F459D093FE24AB3462170\"}","reqsn":"1610258923119024","retcode":"SUCCESS","sign":"9513D3ABF5983F3FACCD8161931DB1ED","trxid":"180681592","trxstatus":"0000"}

注:

(1)公众号支付,需在收银宝商服端配置支付目录,T+1才能支付。

(2)一个收银宝商户号,最多配置10个小程序或公众号,平台有多个小程序或公众号时,需通过接口上送指定微信appid。

 

3. 快捷支付

(1)字段说明

支付模式:QUICKPAY_VSP

字段

字段类型

必填

字段名称

bankCardNo

String

银行卡号,SM4加密。

银行卡号和协议号---二选一必填;若上送银行卡号,优先通过卡号匹配协议信息,不校验上送的协议号

agreementNo

String

协议号

银行卡号和协议号---二选一必填;若上送银行卡号,则不判断协议号;若上送协议号,则通过协议号校验协议信息

 

(2)使用说明

仅支付绑卡方式“7-收银宝快捷支付签约”绑定的银行卡

订单申请

——交易验证方式:2,不支持

——交易验证方式:不送/0/1

A:不验证短信,响应返回订单状态,不返回验证方式,无需调用确认支付。

B:验证短信,响应不返回订单状态,返回验证方式值为“1”,需继续调用【确认支付(后台+短信验证码确认)】

注:

(1)此支付模式连接渠道真实环境,请使用真实银行卡,且交易将从银行卡扣减金额建议小额支付;支持当天、隔天部分退款和全额退款;

(2)生产支付短信验证码有效时间为2分钟

 

4. 微信小程序支付

(1)字段说明

支付模式:WECHATPAY_MINIPROGRAM

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

acct

String

微信JS支付openid——微信分配

subAppid

String

收银宝子商户号,微信小程序支付 appid 参数

extendParams

String

渠道拓展参数,最长1000字符

goodsTag

String

订单支付标识,订单优惠标记,用于区分订单是否可以享受优惠,字段内容在微信后台配置券时进行设置,只对微信支付有效

benefitDetail

JSONObject

优惠信息,benefitdetail的json字符串,注意是String,微信单品优惠

详情

chnlStoreid

String

渠道门店号--商户在支付渠道端的门店编号

subBranch

String

门店号

cerNum

String

证件号

name

String

付款人姓名

cerType

Long

证件类型

仅支持“1-身份证”

 

(2)使用说明

1.订单请求,云商通不验证,返回“支付信息”商户在小程序平台调起支付的JS函数完成支付。

2.无需调用任何确认支付接口。

3.订单结果通知提供。

附:

(1)微信公众号获取openid官方文档

https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_4#

https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html

(2)商户在小程序平台调起支付的JS函数API接口详见:https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5

注:

(1)小程序支付,需在收银宝商服端配置支付目录,T+1才能支付。

(2)一个收银宝商户号,最多配置10个小程序或公众号,平台有多个小程序或公众号时,需通过接口上送指定微信subappid。

(3)关于“微信订单预消费”说明

1.【背景】微信对小程序生态中提供商品/服务在线销售及配送的小程序新增 《实物电商类小程序运营规范》管理要求,对交易资金要求根据收货状态进行结算。

2.【关于产品开通】商户需在收银宝新增支持开通“网上收银-微信订单预消费”产品,并解除10元风控限额。

3.【关于云商通二代处理】

(1)【消费】、【担保消费】接口优化:根据收银宝响应的交易类型,若收银宝响应“VSP681-微信订单预消费”,则云商通将该笔交易的订单子类型更新。且在收银宝通知“VSP686-微信订单完成”后,云商通也同步创建子订单类型为“微信订单完成”的订单。(商户订单号与原微信订单预消费订单一致)

订单类型 订单子类型
消费 微信订单预消费
消费 微信订单完成
担保消费 微信订单预消费
担保消费 微信订单完成

(2)订单:订单结果通知、订单状态查询、订单详情查询的接口,增加响应“是否微信订单预消费”字段。

(3)退款:云商通根据云商通本地原交易的订单子类型,创建退款订单:

订单类型 原交易订单子类型 退款订单--订单子类型
退款 微信订单预消费 微信订单退款
退款 微信订单完成 微信订单完成退款

 

(4)运营平台:同一个商户订单号的“微信订单预消费、微信订单完成”的订单,详情页面收款、分账、退款模块的信息保持一致。

(5)门户支持:支持支付模式=微信订单预消费,且此次新增的订单类型-订单子类型的订单能够在门户查询相关信息。

(6)情况概括:

订单类型

订单子类型

是否记账

是否进应用集合对账单

是否支持退款

对应收银宝交易类型

消费

微信订单预消费

微信订单预消费

消费

微信订单完成

微信订单完成

担保消费

微信订单预消费

微信订单预消费

担保消费

微信订单完成

微信订单完成

退款

微信订单退款

/

微信订单退款

退款

微信订单完成退款

/

微信订单完成退款

5. 付款码支付

(1)字段说明

支付模式:CODEPAY_VSP

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

authcode

String

支付授权码,支付宝被扫刷卡支付时,用户的付款二维码

*不支持数字货币付款码

extendParams

   

渠道拓展参数,最长1000字符

fqNum

   

支付宝分期, 暂仅支持支付宝花呗分期,支付宝信用卡分期

仅支持A01/A02;

3-花呗分期3期

6-花呗分期6期

12-花呗分期12期

3-cc支付宝信用卡分期3期

6-cc 支付宝信用卡分期6期

12-cc支付宝信用卡分期12期

goodsTag

String

订单支付标识,订单优惠标记,用于区分订单是否可以享受优惠,字段内容在微信后台配置券时进行设置,只对微信支付有效

benefitDetail

JSONObject

优惠信息,benefitdetail的json字符串,注意是String,微信单品优惠,详情

chnlStoreid

String

渠道门店号--商户在支付渠道端的门店编号

subBranch

String

门店号

termInfo

JSONObject

终端信息,

先通过【支付终端信息管理】新增

详情

(2)使用说明

1.订单请求,渠道端不验证时,响应返回“payStatus”,成功或失败;渠道端验证,则返回“进行中”

2.无需调用任何确认支付接口。

3.订单结果通知提供。

 

6. 支付宝正扫

(1)字段说明

支付模式:SCAN_ALIPAY

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

extendParams

String

渠道拓展参数,最长1000字符

fqNum

String

支付宝分期, 暂仅支持支付宝花呗分期,支付宝信用卡分期

仅支持A01/A02;

3-花呗分期3期

6-花呗分期6期

12-花呗分期12期

3-cc支付宝信用卡分期3期

6-cc 支付宝信用卡分期6期

12-cc支付宝信用卡分期12期

benefitDetail

JSONObject

优惠信息,benefitdetail的json字符串,注意是String,支付宝智慧门店,详情

chnlStoreid

String

渠道门店号--商户在支付渠道端的门店编号

subBranch

String

门店号

cerNum

String

证件号

name

String

付款人姓名

cerType

Long

证件类型

仅支持“1-身份证”

(2)使用说明

1.订单请求,不返回“订单状态”,返回“扫码支付信息”,供转化为二维码。

2.无需调用任何确认支付接口。

3.订单结果通知提供。

7. 银联扫码支付

(1)字段说明

支付模式:SCAN_UNIONPAY

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

extendParams

String

渠道拓展参数,最长1000字符

(2)使用说明

1.订单请求,不返回“订单状态”,返回“扫码支付信息”,供转化为二维码。

2.无需调用任何确认支付接口。

3.订单结果通知提供。

8. 支付宝JS

(1)字段说明

支付模式:ALIPAY_SERVICE

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号,与生活号对应

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

acct

String

支付宝JS支付user_id——支付宝分配

fqNum

String

支付宝分期, 暂仅支持支付宝花呗分期,支付宝信用卡分期

仅支持A01/A02;

3-花呗分期3期

6-花呗分期6期

12-花呗分期12期

3-cc支付宝信用卡分期3期

6-cc 支付宝信用卡分期6期

12-cc支付宝信用卡分期12期

extendParams

String

渠道拓展参数,最长1000字符

benefitDetail

JSONObject

优惠信息,benefitdetail的json字符串,注意是String,支付宝智慧门店,详情

chnlStoreid

String

渠道门店号--商户在支付渠道端的门店编号

subBranch

String

门店号

cerNum

String

证件号

name

String

付款人姓名

cerType

Long

证件类型

仅支持“1-身份证”

(2)使用说明

1.订单请求,不返回“payStatus”, 返回“payInfo支付串信息(支付宝交易单号)”,将此字段上传至“支付宝服务窗JSAPI官方文档的alipay.trade.create (统一收单交易创建接口)+JSAPI唤起收银台支付” AlipayJSBridge方法的参数tradeNO。

2.无需调用云商通确认支付接口。

3.订单结果通知通过【订单结果通知】提供。

附:

(1)支付宝获取user_id官方文档

https://doc.open.alipay.com/doc2/apiDetail.htm?spm=a219a.7629065.0.0.EoHbww&apiId=876&docType=4

(2)支付宝服务窗JSAPI官方文档

https://doc.open.alipay.com/docs/doc.htm?&docType=1&articleId=105591

支付宝服务窗支付请求云商通响应payinfo示例:

{"appid":"00000006","cusid":"xxxx","payinfo":"2016102521001004455008259156","reqsn":"1610258923075829","retcode":"SUCCESS","sign":"EF87B13EB952C954482676CDFE331107","trxid":"180681552","trxstatus":"0000"}

9. 银联JS

(1)字段说明

支付模式:UNIONPAY_JS

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

acct

String

支付账户用户标示,银联userid

extendParams

String

 

cusIp

String

 

(2)使用说明

1.订单请求,不返回“payStatus”, 返回“payInfo支付串信息”,对应银联JS支付,支付的链接,商户只需跳转到此链接即可触发支付。

2.无需调用云商通确认支付接口。

3.订单结果通知通过【订单结果通知】提供。

4.支付账户用户标识ACCT获取方式:

(1)分公司向商服运营部门申请商户在银联报备域名和通知地址说明;

(2)商户服务器与银联交互自行获取银联userAuth的code,银联地址https://qr.95516.com/qrcGtwWeb-web/api/userAuth?version=1.0.0&redirectUrl=redirectUrlA,redirectUrlA:商户接收userAuthCode的地址;

10. 收银宝POS

(1)字段说明

支付模式:ORDER_VSPPAY

字段

字段类型

必填

字段名称

vspCusid

String

 

trxReserve

String

业务关联内容,取值按如下规则拼接:

#订购人姓名#订购人地址#联系电话#证件类型#证件号

(2)使用说明

POS端冲正:必须关闭

POS端撤销/退款:建议关闭;

(1)订单申请,返回 “通联订单号orderNo”。终端POS或通联收银宝公众号订单页面输入orderNo订单号,完成支付。

(2)无需调用任何确认支付接口。

(3)订单结果通知提供。

11. H5收银台

(1)字段说明

支付模式:H5_CASHIER_VSP

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

payType

String

分期付:F02

当指定为F02时,交易仅限分期交易。分期交易金额必须大于500元。

isHide

String

1:隐藏标准收银台

0:不隐藏标准收银台(默认)

fqNum

String

支付宝分期;暂仅支持支付宝花呗分期,支付宝信用卡分期

仅支持A01/A02;

枚举值:

3:花呗分期3期

6:花呗分期6期

12:花呗分期12期

3-cc:支付宝信用卡分期3期

6-cc:支付宝信用卡分期6期

12-cc:支付宝信用卡分期12期

extendParams

String

渠道拓展参数,最长1000字符

goodsTag

String

订单支付标识

benefitDetail

JSONObje ct

优惠信息,benefitdetail 的 json 字符串,注意是 String,微信单品优 惠,详情

subBranch

String

门店号

(2)使用说明

1. 订单申请,返回“H5收银台”支付地址(在“chnlFrontParamInfo”JSON中返回的chnlPayInfo字段值),在微信/支付宝端打开该地址,进行支付;

2. 无需调用任何确认支付接口。

3. 订单结果通知提供。

 

12. 微信小程序收银台

(1)字段说明

支付模式:WECHATPAY_MINIPROGRAM_CASHIER_VSP

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

limitPay

String

非贷记卡:no_credit

multiPay

String

支持多渠道支付

0/空:不支持

1:支持选择支付宝/微信支付

注:设置该参数后,isdirectpay不生效

isDirectPay

String

是否直接支付

1:直接支付

0:不直接支付,默认0;

subBranch

String

通联系统门店号

isHideShare

String

是否禁止分享

1-禁止分享

0或空时支持分享

cerNum

String

证件号

实名交易必填.填了此字段就会验证证件号和姓名

name

String

付款人真实姓名

实名交易必填.填了此字段就会验证证件号和姓名

(2)使用说明

1. 商户需开通收银宝微信/支付宝小程序收银台;

2. 订单请求,云商通系统生产订单,响应“appletPayParams-收银宝小程序收银台支付参数” ;

3. 商户小程序内调起通联收银台小程序。

调用方式:在小程序环境内,唤起小程序调起收银台小程序时(appId: 微信小程序的appId,固定为:wxef277996acc166c3),在extraData中将云商通返回的“appletPayParams-收银宝小程序收银台支付参数”中的字段名及字段值全部原样作为入参上送

4. 小程序的回调:

用户在收银台中完成支付后,会回调支付结果,具体结果可以在小程序生命周期Page.onShow中获取“code、errmsg”参数,详见

收银宝微信小程序收银台在线文档:“9.1 微信小程序收银台支付调用说明

收银宝微信小程序收银台在线文档:“9.2 支付宝小程序收银台支付调用说明


5.订单结果通知提供。

13. 支付宝小程序收银台

(1)字段说明

支付模式:ALIPAY_MINIPROGRAM_CASHIER_VSP

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

limitPay

String

no_credit:指定不能使用信用卡

isDirectPay

String

是否直接支付

1:直接支付

0:不直接支付,默认0;

subBranch

String

通联系统门店号

isHideShare

String

是否禁止分享

1-禁止分享

0或空时支持分享

cerNum

String

证件号

实名交易必填.填了此字段就会验证证件号和姓名

name

String

付款人真实姓名

实名交易必填.填了此字段就会验证证件号和姓名

fqNum

String

支付宝分期

3 花呗分期3期

6 花呗分期6期

12 花呗分期12期

3-cc 支付宝信用卡分期3期

6-cc 支付宝信用卡分期6期

12-cc 支付宝信用卡分期12期

(2)使用说明

1. 商户需开通收银宝微信/支付宝小程序收银台;

2. 订单请求,云商通系统生产订单,响应“appletPayParams-收银宝小程序收银台支付参数” ;

3. 商户小程序内调起通联收银台小程序。

调用方式:在小程序环境内,唤起小程序调起收银台小程序时(appId: 微信小程序的appId,固定为:wxef277996acc166c3),在extraData中将云商通返回的“appletPayParams-收银宝小程序收银台支付参数”中的字段名及字段值全部原样作为入参上送

4. 小程序的回调:

用户在收银台中完成支付后,会回调支付结果,具体结果可以在小程序生命周期Page.onShow中获取“code、errmsg”参数,详见

收银宝微信小程序收银台在线文档:“9.1 微信小程序收银台支付调用说明

收银宝微信小程序收银台在线文档:“9.2 支付宝小程序收银台支付调用说明


5.订单结果通知提供。

14. PC网关支付

(1)字段说明

支付模式:GATEWAY_VSP

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

gateId

String

支付银行,见收银宝网银银行列表

注:不填时,将在网关平台显示银行列表供用户选择。

注:上送gateid,paytype不允许上送 B2C,B2B

payType

String

交易类型

-支持B2C和B2B和B2C,B2B

limitPay

String

不填--借、贷记卡均支持,默认

no_credit--指定不能使用信用卡支付

to_credit--限定使用信用卡支付

(2)使用说明

1. 订单申请,返回“PC网关支付”支付地址,支付地址(在“chnlFrontParamInfo”JSON中返回的chnlPayInfo字段值),在浏览器该地址,进行支付;

2. 无需调用任何确认支付接口;

3. 订单结果通知提供;
注:
(1)消费、担保消费,reqsUrl针对“PC网关支付”必填;
(2)“订单过期时间”则向渠道字段“validtime-订单过期时间”,若未上送不填默认为5分钟;

15. 微信支付分

(1)字段说明

支付模式:WECHAT_SCORE_VSP

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

outOrderNo

String

支付分服务单号

serviceId

String

服务id:微信分配的服务id

scene

String

交易场景

取值包括:

PARKING—车场停车场场景

PARKING_SPACE—车位停车场

GAS—加油场景

HIGHWAY—高速场景

BRIDGE—路桥场景

LIFE_PAY—生活缴费行业

SHARABLE_BIKE—共享单车

SHARABLE_CHARGERS—共享充电宝

E-COMMERCE—电商

OTHERS—其他

acct

String

支付平台用户标识

服务单中-用户的微信sub_openid

termInfo

JSONObject

终端信息,

先通过【支付终端信息管理】新增

详情

(2)使用说明

(1)发起微信支付分的支付前,需先调用【支付分服务单管理】接口进行服务单的创建、完结等操作,而后才可以发起微信支付分的扣款;

(2)无需调用任何确认支付接口;

(3)订单结果通知提供

 

16. 云商通收银台

(1)字段说明

支付模式:CASHIER_YST

字段

字段类型

必填

字段名称

vspCusid

String

收银宝子商户号

集团模式,必填

limitPay

String

非贷记卡:no_credit

不填--借、贷记卡均支持;

payType

String

指定支付方式,则不展示收银台界面。枚举值:

YHK:银行卡快捷

WX:微信

ZFB:支付宝

YSF:云闪付

benefitDetail

JSONObje ct

优惠信息,benefitdetail 的 json 字符串,注意是 String,微信单品优惠,详情

goodsTag

String

订单支付标识

isHide

String

隐藏云商通收银台界面

0:不隐藏(默认)

1:隐藏

 

(2)使用说明

云商通收银台的支付链接,在响应的chnlFrontParamInfo的ystCashierUrl中返回。例如:"chnlFrontParamInfo":"{\"ystCashierUrl\":\"https://test.allinpay.com/h5/cashRegister?code=20250418105238208501286142\"}"

17.当面付支付

(1)字段说明

支付模式:FACETOFACEPAY_VSP

字段

字段类型

必填

字段名称

说明

vspCusid

String

支付商户号

收银宝子商户

trxReserve

String

 

订单详情标签个性化说明

例:05|Q1#文西|Q2#186-2828-9999|Q3#广州市天河区体育西路107号|X#其他备注信息

(2)支付说明

支付模式

支付模式说明

当面付

(1)订单申请,返回 “通联订单号-respTraceNum”;当面付码牌或通联收银宝公众号/自带参数的当面付订单支付H5 订单页面输入respTraceNum订单号,完成支付。

(2)无需调用任何确认支付接口。

(3)订单结果通知提供。


wuxl2 2025年4月18日 16:40 收藏文档