接口地址：https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/unitorder/pay
测试地址：https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/unitorder/pay
使用场景：请求扫码支付的二维码串（支持支付宝、数字人民币、云闪付),公众号JS支付（支付宝，微信，数字人民币，云闪付）,微信小程序支付。
该接口不支持阶梯分账（可正常收款，但不执行阶梯分账规则）。
开通微信发货模式的订单，不支持上送分账规则，分账需在订单确认后，调用3.21分账/收款确认接口，完成分账
请求参数
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
|
version |
版本号 |
接口版本号 |
是 |
2 |
默认填11 |
|
trxamt |
交易金额 |
单位为分 |
否 |
15 |
|
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
64 |
保证商户平台唯一 |
|
paytype |
交易方式 |
详见附录交易方式 |
否 |
3 |
|
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
body |
订单标题 |
订单商品名称，为空则以商户名作为商品名称 |
是 |
100 |
最大100个字节(注：utf8下，一个中文字符是3个字节) |
|
remark |
备注 |
备注信息 |
是 |
160 |
最大160个字节(80个中文字符) |
|
validtime |
有效时间 |
订单有效时间，以分为单位，不填默认为5分钟 |
是 |
4 |
最大1440分钟 |
|
acct |
支付平台用户标识 |
JS支付时使用 |
是 |
32 |
|
|
notify_url |
交易结果通知地址 |
接收交易结果的通知回调地址，通知url必须为直接可访问的url，不能携带参数。 |
是 |
256 |
若使用https,需使用默认443端口 |
|
limit_pay |
支付限制 |
no_credit--指定不能使用信用卡支付 |
是 |
32 |
暂时只对微信支付和支付宝有效,仅支持no_credit |
|
sub_appid |
微信子appid |
微信小程序/微信公众号/APP的appid |
是 |
32 |
只对微信支付有效 |
|
goods_tag |
订单优惠标识 |
订单优惠标记，用于区分订单是否可以享受优惠，字段内容在微信后台配置券时进行设置，说明详见代金券或立减优惠 |
是 |
32 |
只对微信支付有效 |
|
benefitdetail |
优惠信息 |
Benefitdetail的json字符串,注意是String |
|
- |
微信单品优惠 |
|
chnlstoreid |
渠道门店编号 |
商户在支付渠道端的门店编号 |
是 |
|
例如： |
|
subbranch |
门店号 |
|
是 |
4 |
通联系统门店号 |
|
extendparams |
拓展参数 |
json字符串，注意是String |
是 |
|
参考拓展参数附录说明4.5.7 |
|
cusip |
终端ip |
用户下单和调起支付的终端ip地址 |
是 |
16 |
payType=U02云闪付JS支付不为空 |
|
front_url |
支付完成跳转 |
必须为https协议地址，且不允许带参数 |
是 |
128 |
只支持payType=U02云闪付JS支付 |
|
idno |
证件号 |
实名交易必填.填了此字段就会验证证件号和姓名 |
是 |
32 |
暂只支持支付宝支付,微信支付(微信支付的刷卡支付除外),云微支付 |
|
truename |
付款人真实姓名 |
实名交易必填.填了此字段就会验证证件号和姓名 |
是 |
32 |
暂只支持支付宝支付,微信支付(微信支付的刷卡支付除外),云微支付 |
|
asinfo |
分账信息 |
上送分账信息，json字符串 |
是 |
1024 |
参照附录4.7asinfo字段说明 |
|
fqnum |
分期 |
3 花呗分期3期 |
是 |
8 |
暂只支持支付宝花呗分期,支付宝信用卡分期 |
|
signtype |
签名方式 |
|
是 |
8 |
支持MD5、RSA、SM2，不填默认MD5 |
|
unpid |
银联pid |
|
|
|
仅支持代理商/服务商角色调用 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
|
terminfo |
终端信息 |
终端信息的json字符串 |
是 |
200 |
paytype=A04,W04,U04时，terminfo字段必填 |
|
operatorid |
收银员号 |
|
是 |
20 |
|
|
membertype |
会员账户类型 |
|
是 |
2 |
1-手机号 2-会员卡号 3-微信公众号Openid 4-会员动态码 5-外部会员ID 6-内部会员ID 10-微信小程序Openid |
|
memberid |
会员账户 |
|
是 |
180 |
|
|
inaccountflag |
入金账户标识 |
0-余额户 1-储值卡专用户 |
是 |
2 |
不送默认0 |
|
splitflag |
分账标识 |
|
是 |
2 |
1-自动分账，默认1 2-不分账 3-延时分账/收款 若上送2时，忽略接口上送的asinfo；若上送3，则必须调用“3.21分账/收款确认”接口完成分账或收款入账。 |
|
receivershopid |
收款人店铺ID |
|
是 |
11 |
只有开通资金管理功能的机构生效 |
|
appname |
应用名称 |
填小程序ID/公众号ID |
是 |
100 |
通过wx.navigateToMiniProgram(小程序接口)或wx-open-launch-weapp（公众号开放标签）拉起云闪付小程序。UW01必填 |
|
apptype |
交易发起场景 |
03:小程序 04:公众号 |
是 |
2 |
UW01必填 |
|
channelorderno |
渠道流水号 |
|
是 |
- |
交易方式为SI01时可传 |
各交易方式必填字段(M:必填)：
|
|
W01|A01|S01 |
W02|A02|U02 |
W03|A03|S03 |
W06 |
|
动态码CSB支付 |
JSAPI支付 |
APP支付 |
微信小程序支付 |
|
|
acct |
|
M |
|
M |
|
notify_url |
M |
M |
M |
M |
|
sub_appid |
|
M |
|
M |
|
idno |
仅实名支付需要 |
|||
|
truename |
||||
|
asinfo |
仅分账支付需要 |
|||
响应参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
此字段是通信标识，非交易结果，交易是否成功需要查看trxstatus来判断 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
|
trxid |
交易单号 |
收银宝平台的交易流水号 |
否 |
20 |
|
|
chnltrxid |
渠道平台交易单号 |
例如微信,支付宝平台的交易单号 |
是 |
50 |
|
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
64 |
|
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
trxstatus |
交易状态 |
交易的状态, |
否 |
4 |
详见交易返回码说明 |
|
fintime |
交易完成时间 |
yyyyMMddHHmmss |
是 |
14 |
对于微信刷卡支付有效 |
|
errmsg |
错误原因 |
失败的原因说明 |
是 |
100 |
|
|
payinfo |
支付串 |
扫码支付则返回二维码串，js支付则返回json字符串 聚合支付返回支付链接，跳转到此链接进行支付； 小程序聚合支付返回json串，商户小程序跳转至appid小程序的paypath进行支付； 云微支付返回调起云闪付微信小程序的相关参数，商户解析获取cqpMpPath和cqpMpAppId后发起调用 |
是 |
不限 |
|
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
|
mchtdiscountamount |
商户优惠汇总金额 |
商户积分、余额、卡券优惠抵扣金额，银行活动商户分摊金额 |
否 |
14 |
单位：分 |
|
bankdiscountamount |
银行补贴汇总金额 |
银行活动银行分摊金额 |
否 |
14 |
单位：分 |
向front_url跳转
支付完成后,交易成功后点击跳往商户网站,会跳往交易上送的front_url
注意：不能以此为支付结果，以交易结果通知接口为最终交易结果
云闪付JS完成跳转请求参数：
|
参数 |
参数名称 |
取值 |
|
appid |
应用ID |
平台分配的应用ID |
|
cusid |
商户号 |
平台分配的商户号 |
|
cusorderid |
商户订单号 |
交易上送的订单号(reqsn) |
|
trxcode |
交易类型 |
见附录：交易类型说明 |
|
trxid |
通联交易流水号 |
通联系统内唯一 |
|
trxamt |
交易金额 |
分为单位 |
|
trxdate |
交易请求日期 |
yyyyMMdd |
|
paytime |
交易完成时间 |
yyyyMMddHHmmss |
|
trxstatus |
交易状态 |
见附录：交易状态说明 |
|
trxreserved |
交易备注 |
返回商品号(goodsid) |
|
sign |
签名信息 |
详见接口规则：安全规范 |
微信JS完成跳转请求参数：
微信js支付完成跳转改造参考 https://prodoc.allinpay.com/doc/260/
|
参数 |
参数名称 |
取值 |
|
appid |
应用ID |
平台分配的应用ID |
|
cusid |
商户号 |
平台分配的商户号 |
|
reqsn |
商户订单号 |
交易上送的订单号(reqsn) |
|
trxid |
通联交易流水号 |
通联系统内唯一 |
|
trxamt |
交易金额 |
分为单位 |
|
remark |
交易备注 |
|
|
randomstr |
随机串 |
|
|
sign |
签名信息 |
详见安全规范 |