订单提交接口(商户网站->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 |
响应参数:
平台接受到请求后,重定向到网关平台,指引用户完成支付。