订单提交接口(商户网站->聚合收银台)
支付请求是商户向聚合收银台发起的支付请求,请求数据通过该接口传递给平台,支持PC/手机端双端请求。
注意:加签的byte[]编码为UTF-8
生产接口地址:https://syb.allinpay.com/apiweb/h5unionpay/onepay
测试接口地址:https://syb-test.allinpay.com/apiweb/h5unionpay/onepay
请求参数:
| 参数 | 参数名称 | 取值 | 可空 |
长度 |
备注 |
|---|---|---|---|---|---|
| orgid |
集团/ 代理商 商户号 |
是 | 15 | 共享集团/代理商参数时必填 | |
| cusid | 商户号 | 实际交易商户号 | 否 | 15 | |
| appid | 应用ID | 平台分配的APPID | 否 | 8 | |
| version | 版本号 | 默认为12 | 否 | 2 | |
| trxamt | 付款金额 | 单位为分 | 否 | 15 | |
| reqsn |
唯一 订单号 |
|
是 | 50 | |
| charset |
参数字符 编码集 |
商户网站使用的编码格式, 支持UTF-8、GBK 跟商户网站的编码一致 |
否 | 8 | |
| front_url |
页面跳转 同步通知 页面路径 |
交易完成后 平台会按照此地址将用户的交易结果 页面重定向到商户网站 同时该参数为返回商户按钮的指向链接 |
否 | 128 |
必须为https协议地址 且不允许带参数 |
| notify_url |
服务器 异步通知 页面路径 |
交易完成后 平台会将交易结果 以后台通知的方式发送到该地址 商户需要以此通知判断用户订单交易是否成功 |
是 | 256 | 若使用https,需使用默认443端口 |
| body | 订单标题 | 订单描述信息,展示在收银台 | 否 | 100 | |
| remark |
订单 备注信息 |
通知会原样带上 | 是 | 300 | |
| randomstr |
随机 字符串 |
商户自行生成的随机字符串 | 否 | 32 | |
| expiretime | 绝对时间 | 截止支付时间 | 否 | 20 | yyyyMMddHHmmss |
| limit_pay | 支付限制 | no_credit--指定不能使用信用卡支付 | 是 | 32 | 32 |
| 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-是 |
是 | 2 | 仅针对微信,支付宝有效,用户关闭密码框时通知 |
| sign | 签名 | 详见安全规范 | 否 | 256 | |
| unpid | 银联pid | 是 | 32 | 仅支持代理商/服务商角色调用 | |
| cancelurl |
取消支付跳转 同步通知页面路径 |
取消支付后 平台会按照此地址将用户的取消动作通过重定向到商户网站 仅支持微信/支付宝APP。 |
是 | 128 | 必须为https协议地址且不允许带参数 |
响应参数:
平台接受到请求后,重定向到网关平台,指引用户完成支付。