4.1H5收银台


订单提交接口(商户网站->H5收银台)

支付请求是商户向H5收银台发起的支付请求,请求数据通过该接口传递给平台,平台根据不同的手机浏览器(微信,支付宝,云闪付等APP自带浏览器)自动选择不同支付方式,引导用户完成支付。

注意:加签的byte[]编码为UTF-8

生产接口地址:https://syb.allinpay.com/apiweb/h5unionpay/unionorder
测试接口地址:https://syb-test.allinpay.com/apiweb/h5unionpay/unionorder

请求参数:

参数 参数名称 取值 可空

长度

备注
orgid

集团/

代理商

商户号

  15 共享集团/代理商参数时必填
cusid 商户号 实际交易商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 默认为12 2  
trxamt 付款金额 单位为分 15  
paytype

指定交易

类型

分期付:F02 8

当指定为F02时,交易仅限分期交易。

分期交易金额必须大于500元。

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

reqsn

商户

订单号

订单号码支持

数字、英文字母、_、-、*、+、#

其他字符不建议使用

50  
unireqsn

唯一

订单号

unireqsn与原订单号reqsn二选一

当2个订单号并存时

优先取原reqsn的订单号原有逻辑

reqsn订单号原有逻辑

同一订单号在微信/支付宝/云闪付等渠道

可以同时存在下单

unireqsn订单号新逻辑

同一订单号在微信/支付宝/云闪付渠道下单时

系统会寻找当前商户其他相同unireqsn订单号

未支付的订单进行关单处理

50

 

charset

参数字符

编码集

商户网站使用的编码格式,

支持UTF-8、GBK

跟商户网站的编码一致

8  
returl

页面跳转

同步通知

页面路径

交易完成后

平台会按照此地址将用户的交易结果

页面重定向到商户网站

同时该参数为返回商户按钮的指向链接

128

必须为https协议地址

且不允许带参数

notify_url

服务器

异步通知

页面路径

交易完成后

平台会将交易结果

以后台通知的方式发送到该地址

商户需要以此通知判断用户订单交易是否成功

256 若使用https,需使用默认443端口
body 订单标题 订单描述信息,展示在收银台 100  
remark

订单

备注信息

通知会原样带上 160  
randomstr

随机

字符串

商户自行生成的随机字符串 32  
validtime 有效时间 订单有效时间,以分为单位,默认为5 4 超时后,该订单不允许再进行支付
expiretime 绝对时间 截止支付时间 20 yyyyMMddHHmmss
limit_pay 支付限制 no_credit--指定不能使用信用卡支付 32 32
goods_tag

订单

支付标识

订单优惠标记

用于区分订单是否可以享受优惠

字段内容在微信后台配置券时进行设置

说明详见代金券或立减优惠

32  
benefitdetail 优惠信息

Benefitdetail的json字符串,注意是String

填写格式详见统一下单附录

3000  
asinfo 分账信息

格式:cusid:type:amount;cusid:type:amount

其中

cusid:接收分账的通联商户号

type分账类型(01:按金额  02:按比率)

如果分账类型为02

则分账比率为0.5表示50%

如果分账类型为01

则分账金额以元为单位表示

1024 开通此业务需开通分账配置
subbranch 门店号   4 通联系统门店号
extendparams 拓展参数

json字符串,注意是String

一般用于渠道的活动参数填写

  参考附录拓展参数说明
signtype 签名类型

RSA

SM2

8  
truename

付款人

真实姓名

实名交易必填

填了此字段就会验证证件号和姓名

32  
idno 证件号

实名交易必填

填了此字段就会验证证件号和姓名

32  
ishide

是否

直接支付

  2 取值为1时直接拉起密码框
ispwdcancel

取消支付

是否通知

0-否

1-是

     仅针对微信,支付宝有效
sign 签名 详见安全规范 32  
unpid 银联pid       仅支持代理商/服务商角色调用
terminfo 终端信息

终端信息的json字符串

详见附录终端字段说明

200  

响应参数:

平台接受到请求后,重定向到网关平台,指引用户完成支付。


yinjr 2025年4月24日 18:10 收藏文档