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