4.1统一支付API


接口地址: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 详见安全规范

yinjr 2025年1月9日 22:42 收藏文档