支付请求是商户向网关平台发起的支付请求,请求数据通过该接口传递给平台,平台提交支付请求到银行,自动打开银行网银页面,引导用户完成支付。
注意:加签的byte[]编码为UTF-8
测试环境接口地址:https://syb-test.allinpay.com/apiweb/gateway/pay
生产环境接口地址:https://vsp.allinpay.com/apiweb/gateway/pay
请求参数:
参数 | 参数名称 | 取值 | 可空 | 最大长度 | 备注 |
---|---|---|---|---|---|
orgid |
集团/代理商 商户号 |
是 | 15 |
共享集团号/代理商 参数时必填 |
|
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | 交易商户号 |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
charset |
参数字符 编码集 |
商户网站使用的编码格式, 支持UTF-8、GBK、GB2312 |
否 | 8 |
Get URLEncode时的编码 sign的byte用UTF-8 |
returl |
页面跳转 同步通知 页面路径 |
交易完成后, 平台会按照此地址将用户的交易结果页面 重定向到商户网站 同时该参数为返回商户按钮的指向链接 如果商户不传递该参数, 则返回按钮指向为空页面。 |
是 | 256 | |
notifyurl |
服务器 异步通知 页面路径 |
交易完成后, 平台会将交易结果 以后台通知的方式发送到该地址 商户需要以此通知 判断用户订单交易是否成功。 |
是 | 256 | returl和notifyurl不能同时为空 |
goodsid | 商品号 |
支持数字, 字母该参数会在对账文件 返回的商户备注字段 |
是 | 160 |
不允许使用 “|”、“%”、“#”、“^” 等特殊字符 |
goodsinf |
商品描述 信息 |
如果传递中文, 需确保该字段在传入接口前, 编码正确,建议使用UTF-8编码 (根据商户服务器编码环境而定)。 |
是 | 100 |
不允许使用 “|”、“%”、“#”、“^” 等特殊字符 |
trxamt | 付款金额 | 单位为分 | 否 | 15 | |
orderid |
商户唯一 订单号 |
订单号码支持数字、 英文字母、_、-、*、+、#, 其他字符不建议使用 |
否 | 50 | |
randomstr | 随机字符串 | 商户自行生成的随机字符串 | 否 | 32 | |
gateid | 支付银行 | 详见银行列表 | 是 | 8 |
gateid不填时, 将在网关平台显示银行列表供用户选择 |
paytype | 交易类型 | B2C/B2B | 否 | 8 |
paytype不填时, 默认B2C如需同时支持B2C和B2B, 需填入B2C,B2B |
validtime | 有效时间 | 是 | 4 |
订单有效时间,以分为单位, 不填默认为60分钟 仅支持B2C,最大60分钟 B2B固定有效期20天 |
|
limitpay |
no_credit--指定不能使用信用卡支付 to_credit--限定使用信用卡支付 |
是 | 32 | 仅限于交易类型为B2C时 | |
signtype | 签名方式 | 是 | 8 | RSA | |
sign | 签名 | 详见安全规范 | 否 | 32 |
响应参数:
平台接受到请求后,重定向到网关平台,指引用户完成支付。