4.2 H5网关订单提交接口


订单提交接口(商户网站->H5收银台)
支付请求是商户向H5收银台发起的支付请求,请求数据通过该接口传递给平台,平台调起云闪付app,引导用户完成支付。


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

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid

集团/代理商

商户号

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

商户唯一

订单号

订单号码

支持数字、英文字母、_、-、*、+、#,

其他字符不建议使用

50  
charset

参数字符

编码集

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

支持UTF-8、GBK跟商户网站的编码一致

8  
returl

页面跳转

同步通知

页面路径

交易完成后

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

重定向到商户网站

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

128

必须为https协议地址

且不允许带参数

rettype

同步返回

请求方式

交易完成后

平台会按照此请求方式

提交到商户上送的同步通知地址

2

默认为POST方式

01 POST方式

02 GET方式

notify_url

服务器

异步通知

页面路径

交易完成后

平台会将交易结果

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

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

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

订单备注

信息

通知会原样带上 160  
randomstr 随机字符串 商户自行生成的随机字符串 32  
validtime 有效时间

订单有效时间,以分为单位,

不填默认为60分钟,最大60分钟

4 超时后,该订单不允许再进行支付
limit_pay 支付限制 no_credit--指定不能使用信用卡支付 32  
asinfo 分账信息

格式:

cusid:type:amount;cusid:type:amount…

其中

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

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

如果分账类型为02,则分账比率为0.5表示50%。

如果分账类型为01,则分账金额以元为单位表示

1024 开通此业务需开通分账配置
subbranch 门店号   4 通联系统门店号
signtype 签名类型

RSA

SM2

8  
gateid 支付银行 见附录支持银行列表 8

gateid不填时,

将在收银台显示银行列表供用户选择

idtype 证件类型

0-身份证

1-户口簿

2-护照

3-军官证

4-士兵证

5-港澳通行证

6-台湾通行证

7-临时身份证

8-外国人居留证

9-警官证

X-其他证件

4  
idno 证件号   32  
truename 姓名   32  
sign 签名 详见安全规范 32  

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


yinjr 2024年9月5日 16:33 收藏文档