传输方式:HTTPS 请求方式:GET/POST 签名算法:MD5 字符编码:UTF-8
请求API地址:
网关提交地址:https://(隐藏)/payment.do 登录商户后台查看
字段名 | 变量名 | 是否必填 | 加入签名 | 描述 |
---|---|---|---|---|
商户ID | parter | 是 | 是 | 速宝支付所创建的商户ID |
支付方式 | type | 是 | 是 | 查看API支付产品编码 |
订单金额 | value | 是 | 是 | 精确到小数点后两位,例如10.28 |
商户订单号 | orderid | 是 | 是 | 商户订单号,该值需在商户网站内唯一 |
充值账号 | account | 是 | 是 | 用于游戏充值时,可传入玩家账号 |
异步通知 | callbackurl | 是 | 是 | 支付成功后回调地址 |
同步通知 | hrefbackurl | 否 | 否 | 支付成功后会跳转到这个地址 |
联系方式 | contact | 否 | 否 | 用于游戏充值时,可传入玩家联系方式 |
商品名称 | subject | 否 | 否 | 第三方支付平台,付款界面展示的商品名称 |
用户IP | payerIp | 否 | 否 | 用户支付IP地址,例如127.0.0.1 |
自定义参数 | param | 否 | 否 | 原封返回,避免特殊字符 |
返回json | format | 否 | 否 | 值:json 返回json格式,为空跳转支付页面 |
备注消息 | attach | 否 | 否 | 备注信息,原样返回 |
md5签名 | sign | 是 | 否 | 32位小写md5签名值,请参考签名算法 |
按顺序排序拼接
拼接顺序:"parter="+parter+"&type="+type+"&value="+value+"&orderid="+orderid+"&account="+account+"&callbackurl="+callbackurl+key |
$md5String="parter={$parter}&type={$type}&value={$value}&orderid={$orderid}&account={$account}&callbackurl={$callbackurl}$key"; |
$sign=md5($md5String)); |
上行为PHP语言拼接案例,其他语言自行拼接,key 为速宝支付商户签名密钥。 |
通知类型:服务器异步通知(callbackurl)
请求方式:GET
当订单支付成功后 速宝支付 会立即向你填写的通知地址发起回调通知
字段名 | 变量名 | 加入签名 | 描述 |
---|---|---|---|
商户订单号 | orderid | 是 | 商户网站的订单号 |
订单结果 | opstate | 是 | 0 支付成功 1 请求参数无效 2 签名错误 |
订单金额 | ovalue | 是 | 提交订单金额,单位(元) |
付款金额 | ovaluesuc | 是 | 订单实际支付金额,单位(元) |
平台订单号 | sysorderid | 否 | 速宝支付平台的订单号 |
订单时间 | systime | 否 | 订单完成时间:格式 2014/02/15 18:42:28 |
备注信息 | attach | 否 | 提交支付的attach原样返回 |
MD5签名 | sign | 否 | 验证订单是否为合法 |
注意: 订单回调参数如有中文,PHP语言请用 $url = urlencode('参数名') 解码,其他语言写法不同。
拼接顺序:"orderid="+orderid+"&opstate="+opstate+"&ovalue="+ovalue+key |
$signStr="orderid={$orderid}&opstate={$opstate}&ovalue={$ovalue}$key"; |
$mysign=md5($signStr); |
上行为PHP语言拼接,其他语言自行拼接,key 为速宝支付商户签名密钥。 |
商户收到通知参数,在校验通过后需要给速宝支付接口返回一个字符串 success 的结果,如通知失败,会重复通知5次。 |
URL网关订单查询地址:http://(隐藏)/api.php 登录商户后台查看
请求方式:GET/POST
字段名 | 变量名 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
操作类型 | act | 是 | order | 此API固定值 |
商户订单号 | out_trade_no | 是 | 20160806151343349 | |
商户ID | pid | 是 | 800800001 |
字段名 | 变量名 | 示例值 | 描述 |
---|---|---|---|
返回状态码 | code | 1 | 1为成功,其它值为失败 |
返回信息 | msg | 查询成功 | |
支付状态 | status | 1 | 1为支付成功,0为未支付,2为订单号不存在 |
支付产品名称 | 银行编码 |
---|---|
支付宝 | alipay |
微信支付 | wxpay |
编写语言 | 下载地址 |
---|---|
JAVA | |
PHP | |
ASP | |
C# |