4.1 PC网关订单提交接口


支付请求是商户向网关平台发起的支付请求,请求数据通过该接口传递给平台,平台提交支付请求到银行,自动打开银行网银页面,引导用户完成支付。
注意:加签的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  

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


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