接口说明
接口域名
https://zfqix.com/api.php
所有接口均使用POST方式请求，返回JSON格式数据。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
pid |
Int | 是 | 商户ID |
type |
String | 是 | 支付方式 |
out_trade_no |
String | 是 | 商户订单号 |
notify_url |
String | 是 | 异步通知地址 |
return_url |
String | 是 | 同步跳转地址 |
name |
String | 是 | 商品名称 |
money |
Float | 是 | 金额（元） |
sign |
String | 是 | 签名字符串 |
sign_type |
String | 是 | 签名类型：MD5 |
签名验证
签名规则
1. 将所有参数（除sign、sign_type外）按参数名ASCII码从小到大排序
2. 使用URL键值对的格式（key=value）拼接成字符串
3. 在字符串最后拼接上商户密钥key
4. 对拼接后的字符串进行MD5运算，得到签名值
示例代码（PHP）
function getSign($params, $key) {
unset($params['sign']);
unset($params['sign_type']);
ksort($params);
$signStr = '';
foreach ($params as $k => $v) {
if ($v != '') {
$signStr .= $k . '=' . $v . '&';
}
}
$signStr .= 'key=' . $key;
return md5($signStr);
}状态码
| 状态码 | 说明 |
|---|---|
1 |
成功 |
0 |
失败 |
-1 |
签名错误 |
-2 |
参数错误 |
-3 |
商户不存在 |
-4 |
商户状态异常 |
发起支付
接口地址
https://zfqix.com/submit.php
请求方式
POST
返回示例
{
"code": 1,
"msg": "success",
"data": {
"trade_no": "202312010001",
"qrcode": "https://...",
"payurl": "https://..."
}
}SDK下载
常见问题
如何获取商户ID和密钥？
登录商户后台，在"用户信息"页面可以查看商户ID和密钥。
签名验证失败怎么办？
请检查参数排序是否正确，密钥是否正确，特殊字符是否进行了URL编码。
异步通知多久会收到？
支付成功后，系统会立即发送异步通知。如果通知失败，会在24小时内重试最多8次。