准备工作
- 已有appid和appkey,没有点击注册
- 已上传支付宝,微信不同面值收款二维码
- 已开通套餐
- 已安装APP,并按要求设置完毕,点击下载
发起付款接口(必用接口)
有2种方法发起支付:1.跳转到我们支付页;2.获取json支付页信息,自定义支付页,跳转支付页接口URL:http://pay.minicti.com/paysubmit.aspx,传参方式:POST使用方法:用表单post的方式,post参数并跳转到此网址,显示我们的支付页。获取支付JSON数据接口URL:http://pay.minicti.com/paysubmit.ajax ,参方式:POST说明:用curl的post方式传参数,并直接获取json返回值,显示在您自定义的支付页上。
输入参数
输入参数
参数名 |
含义 |
类型 |
说明 |
appid |
应用id |
string(35) |
必填。您的商户唯一标识,注册后在设置里获得。一个35位字符串 |
money |
支付金额 |
float |
必填。单位:元。精确小数点后2位 |
paytype |
支付类型 |
string(10) |
必填。alipay:支付宝;weixinpay:微信支付 |
orderid |
商户自定义订单号 |
string(50) |
必填。我们会据此判别是同一笔订单还是新订单。我们回调时,会带上这个参数。例:201802191531 |
goodsname |
商品名 |
string(50) |
选填。您的商品名称,用来显示在后台的订单名称。如未设置,我们会使用后台商品管理中对应的商品名称 |
keystring1 |
回调标识1 |
string(50) |
选填。您的商品标识1,我们回调时,会带上这个参数 |
keystring2 |
回调标识2 |
string(50) |
选填。您的商品标识2,我们回调时,会带上这个参数 |
returnurl |
跳转网址 |
string(255) |
必填。用户支付成功后,我们会让用户浏览器自动跳转到这个网址。由您自定义。不要urlencode。例:http://www.aaa.com/payok_return |
nodifyurl |
通知回调网址 |
string(255) |
必填。用户支付成功后,我们服务器会主动发送一个post消息到这个网址。由您自定义。不要urlencode。例:http://www.aaa.com/payok_notify |
key |
秘钥 |
string(32) |
必填。把使用到的所有参数,连appkey一起,按参数名字母升序排序。把参数值拼接在一起。做md5-32位加密,取字符串小写。得到key。网址类型的参数值不要urlencode |
key的拼接顺序:如用到了所有参数,就按这个顺序拼接:appid+appkey+goodsname+keystring1+keystring2+money+nodifyurl+orderid+paytype+returnurl
注意:appkey在安全上非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端。计算key时,先在服务端计算好,把计算出来的key传出来。严禁在客户端计算key,严禁在客户端存储appkey。
JSON请求的返回值:
{
//提示给用户的文字信息,会根据不同场景,展示不同内容
"msg":"付款即时到账 未到账可联系我们",
"data":{
//二维码信息,如果没返回,说明存在错误,参考msg的信息。
//想展示二维码内容,可以qrcode值放到这个网址后面:https://pan.baidu.com/share/qrcode?w=280&h=280&url=
"qrcode":"HTTPS://QR.ALIPAY.COM/FKX06895NKNQFFVUFPL92A",
//支付渠道:alipay-支付宝;weixinpay-微信
"paytype":"alipay",
//显示给用户的订单金额(一定要把这个价格显示在支付页上,而不是订单金额)
"realmoney":0.05
},
//code目前只返回1。
"code":1,
//判断支付成功后,要同步跳转的URL
"url":"https://www.payok.com/"
}
付款成功回调通知
用户付款成功后,我们会向您在发起付款接口传入的notify_url网址发送通知。您的服务器只要返回200状态,就表示回调已收到。如果返回状态不是200,我们会再尝试回调3次,每次间隔1分钟
输入参数
输入参数
参数名 |
含义 |
类型 |
说明 |
pay_payrecords_nodeuuid |
支付平台订单id |
string(50) |
页面带回支付平台的订单唯一流水 |
orderid |
商户的订单id |
string(50) |
商户支付时候带的orderid |
paytype |
支付类型 |
string(50) |
订单支付的类型 alipay:支付宝,weixinpay:微信 |
realmoney |
实际支付金额 |
float |
实际支付金额单位:元。精确小数点后2位/td>
|
keystring1 |
下订单时候传的 |
string(50) |
下订单时候传的值/td>
|
keystring2 |
下订单时候传的 |
string(50) |
下订单时候传的值/td>
|
key |
秘钥 |
string(32) |
必填。把使用到的所有参数,连appkey一起,按参数名字母升序排序。把参数值拼接在一起。做md5-32位加密,取字符串小写。得到key。网址类型的参数值不要urlencode,用户校验传输值是否正常 |
key的拼接顺序:如用到了所有参数,就按这个顺序拼接:appkey+keystring1+keystring2+orderid+pay_payrecords_nodeuuid+paytype+realmoney
注意:appkey在安全上非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端。计算key时,先在服务端计算好,把计算出来的key传出来。严禁在客户端计算key,严禁在客户端存储appkey。
订单查询接口(可选接口)
用来主动查询订单是否支付成功,一般情况只用支付接口即可。如果您服务器中断了一段时间,可以用这个接口,快速获取中断时期的订单的支付状态。注意:此接口不能频繁查询,一个订单一分种只能查询一次接口URL:http://pay.minicti.com/personpayapi/askorder.ajax
输入参数
输入参数
参数名 |
含义 |
类型 |
说明 |
appid |
应用id |
string(35) |
必填。您的商户唯一标识,注册后在设置里获得。一个35位字符串 |
orderid |
商户订单id |
string(50) |
必填。商户的订单id |
r |
随机数 |
string(10) |
必填。每次请求确保不一样 |
key |
秘钥 |
string(32) |
必填。把使用到的所有参数,连appkey一起,按参数名字母升序排序。把参数值拼接在一起。做md5-32位加密,取字符串小写。得到key。网址类型的参数值不要urlencode |
key的拼接顺序:如用到了所有参数,就按这个顺序拼接:appid +appkey+ orderid + r
JSON请求的返回值:
{
//调用返回状态 true:成功调用 false:调用失败
"bOK":true,
//调用失败原因
"sMsg":"调用失败原因",
//返回的状态数据
"m_ReturnOBJ":
{
//状态 needpay:等待支付 paysuccess:支付成功还未通知 nodify:支付成功并已经通知 payerror:支付失败,norecord:未找到订单
"status":"paysuccess"
}
}
DEMO下载
点击下载demo