接口地址:https://vsp.allinpay.com/apiweb/unitorder/pay
测试地址:https://syb-test.allinpay.com/apiweb/unitorder/pay
使用场景:请求扫码支付的二维码串(支持支付宝、数字人民币、云闪付),公众号JS支付(支付宝,微信,数字人民币,云闪付),微信小程序支付,微信app支付
请求参数:
参数 | 参数名称 | 取值 | 可空 | 长度 | 备注 |
---|---|---|---|---|---|
orgid | 集团/代理商商户号 | 是 | 15 | 共享集团号/代理商参数时必填 | |
cusid | 商户号 | 实际交易的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
version | 版本号 | 接口版本号 | 是 | 2 | 默认填11 |
trxamt | 交易金额 | 单位为分 | 否 | 15 | |
reqsn | 商户交易单号 | 商户的交易订单号 | 是 | 50 | 保证商户平台唯一 |
unireqsn | 唯一订单号 | 商户的交易订单号 | 是 | 50 |
unireqsn与原订单号reqsn二选一 当2个订单号并存时, 优先取原reqsn的订单号原有逻辑。 reqsn订单号原有逻辑, 同一订单号在微信/支付宝/云闪付等渠道 可以同时存在下单。 unireqsn订单号新逻辑, 同一订单号在微信/支付宝/云闪付渠道下单时 系统会寻找当前商户其他相同unireqsn 订单号的未支付的订单 进行关单处理。 |
paytype | 交易方式 | 详见附录交易方式 | 否 | 3 | W11微信订单支付切换说明见附录 |
randomstr | 随机字符串 | 商户自行生成的随机字符串 | 否 | 32 | |
body | 订单标题 |
订单商品名称, 为空则以商户名作为商品名称 |
是 | 100 |
最大100个字节 (注:utf8下,一个中文字符是3个字节) |
remark | 备注 | 备注信息 | 是 | 160 |
最大160个字节(80个中文字符) 禁止出现+,空格,/,?,%,#,&,= 这几类特殊符号 |
validtime | 有效时间 |
订单有效时间, 以分为单位, 不填默认为5分钟 |
是 | 4 |
最大1440分钟 W01最大支持120分钟 |
expiretime | 绝对时间 | 截止支付时间 | 是 | 20 | yyyyMMddHHmmss |
acct | 支付平台用户标识 |
JS支付时使用 微信支付-用户的微信openid 支付宝支付-用户user_id 微信小程序-用户小程序的openid 云闪付JS-用户userId |
是 | 32 | |
notify_url | 交易结果通知地址 |
接收交易结果的通知回调地址, 通知url必须为直接可访问的url, 不能携带参数。 https只支持默认端口 |
是 | 256 | 若使用https,需使用默认443端口 |
limit_pay | 支付限制 | no_credit--指定不能使用信用卡支付 | 是 | 32 |
暂时只对微信支付和支付宝有效 仅支持no_credit |
sub_appid | 微信子appid | 微信小程序/微信公众号/APP的appid | 是 | 32 | 只对微信支付有效 |
goods_tag | 订单优惠标识 |
订单优惠标记, 用于区分订单是否可以享受优惠 字段内容在微信后台配置券时进行设置 说明详见代金券或立减优惠 |
是 | 32 |
只对微信支付有效 W01交易方式不支持 |
benefitdetail | 优惠信息 |
Benefitdetail的json字符串 注意是String 填写格式详见附录5.8 |
是 | - |
微信单品优惠 W01交易方式不支持 支付宝智慧门店 支付宝单品优惠 |
chnlstoreid | 渠道门店编号 | 商户在支付渠道端的门店编号 | 是 |
例如 对于支付宝支付,支付宝门店编号 对于微信支付,微信门店编号 W01交易方式不支持 |
|
subbranch | 门店号 | 是 | 4 | 通联系统门店号 | |
extendparams | 拓展参数 |
json字符串,注意是String 一般用于渠道的活动参数填写 |
是 | 参考5.9拓展参数附录说明 | |
cusip | 终端ip | 用户下单和调起支付的终端ip地址 | 是 | 16 | payType=U02云闪付JS支付不为空 |
front_url | 支付完成跳转 |
必须为https协议地址 且不允许带参数 |
是 | 128 |
只支持payType=U02云闪付JS支付 payType=W02微信JS支付 详见4.6支付完成跳转 |
idno | 证件号 |
实名交易必填. 填了此字段就会验证证件号和姓名 |
是 | 32 |
暂只支持支付宝支付,微信支付 (微信支付的刷卡支付除外) |
truename | 付款人真实姓名 |
实名交易必填. 填了此字段就会验证证件号和姓名 |
是 | 32 |
暂只支持支付宝支付,微信支付 (微信支付的刷卡支付除外) |
asinfo | 分账信息 |
格式: cusid:type:amount;cusid:type:amount 其中 cusid:接收分账的通联商户号 type分账类型( 01:按金额 02:按比率) 如果分账类型为02,则分账比率 0.5表示50%。 如果分账类型为01,则分账金额 以元为单位表示 |
是 | 1024 |
开通此业务需开通分账配置 W11交易方式不支持 |
fqnum | 分期 |
3 花呗分期3期 6 花呗分期6期 12 花呗分期12期 24 花呗分期24期 3-cc 支付宝信用卡分期3期 6-cc 支付宝信用卡分期6期 12-cc 支付宝信用卡分期12期 24-cc 支付宝信用卡分期24期 3,1 花呗分期3期(商户贴息) 6,1 花呗分期6期(商户贴息) 12,1 花呗分期12期(商户贴息) 24,1 花呗分期24期(商户贴息) 3-cc,1 支付宝信用卡分期3期(商户贴息) 6-cc,1 支付宝信用卡分期6期(商户贴息) 12-cc,1 支付宝信用卡分期12期(商户贴息) 24-cc,1 支付宝信用卡分期24期(商户贴息) |
是 | 8 |
暂只支持支付宝花呗分期 支付宝信用卡分期 仅支持A01/A02 |
signtype | 签名方式 | 否 | 8 |
RSA SM2 |
|
unpid | 银联pid | 是 | 仅支持代理商/服务商角色调用 | ||
finorg | 金融机构号 | 是 |
当paytype=N03必填 暂只支持翼支付 (finorg=Z2013811000010) |
||
sign | 签名 | 详见安全规范 | 否 | 32 | |
operatorid | 收银员号 | 是 | 20 |
各交易方式必填字段(M:必填)
W01|A01|S01|U01 动态码CSB支付 |
W02|A02|U02 JSAPI支付 |
W03|A03|S03 APP支付 |
W06|W11 微信小程序支付 /微信订单 |
|
动态码CSB支付 | JSAPI支付 | APP支付 | 微信小程序支付/微信订单 | |
acct | M | M | ||
notify_url | M | M | M | M |
sub_appid | M | M | ||
idno | 仅实名支付需要 | |||
truename | ||||
asinfo | 仅分账支付需要(W11交易方式不支持) |
响应参数:
字段ID | 字段名称 | 取值 | 可空 | 长度 | 备注 |
---|---|---|---|---|---|
retcode | 返回码 | SUCCESS/FAIL | 否 | 8 | 此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断 |
retmsg | 返回码说明 | 是 | 100 | ||
以下信息只有当retcode为SUCCESS时有返回 | |||||
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
trxid | 交易单号 | 收银宝平台的交易流水号 | 否 | 20 | |
chnltrxid | 渠道平台交易单号 | 例如微信,支付宝平台的交易单号 | 是 | 50 | |
reqsn | 商户交易单号 | 商户的交易订单号 | 否 | 32 | |
randomstr | 随机字符串 | 随机生成的字符串 | 否 | 32 | |
trxstatus | 交易状态 |
交易的状态, 对于刷卡支付,该状态表示实际的支付结果,其他为下单状态 |
否 | 4 | 详见交易返回码说明 |
fintime | 交易完成时间 | yyyyMMddHHmmss | 是 | 14 | 对于微信刷卡支付有效 |
errmsg | 错误原因 | 失败的原因说明 | 是 | 100 | |
payinfo | 支付串 |
扫码支付则返回二维码串,js支付则返回json字符串 云闪付的JS支付返回支付的链接,商户只需跳转到此链接即可完成支付 支付宝App支付返回支付信息串 |
是 | 不限 | |
trxcode | 交易类型 |
|
是 | ||
sign | 签名 | 否 | 32 | 详见安全规范 |