API文档 - 神皇支付

1. 接口说明

神皇支付提供简洁易用的API接口，您可以通过API快速创建支付订单、查询订单状态等。

2. 创建订单

请求地址：https://q.haoyaoshop.cn/submit.php

请求方式：POST / GET

参数名	类型	必填	说明
pid	string	是	商户ID（API_ID）
type	string	是	支付方式：alipay / wxpay / qqpay
out_trade_no	string	是	商户订单号，需保证唯一
name	string	是	商品名称
money	decimal	是	支付金额，单位元，保留2位小数
notify_url	string	否	异步通知地址，支付成功后POST通知
return_url	string	否	同步跳转地址，支付成功后跳转
param	string	否	自定义参数，回调时原样返回
sign	string	是	签名，详见签名算法

返回参数

参数名	类型	说明
code	int	状态码，0成功，非0失败
msg	string	提示信息
data.trade_no	string	平台订单号
data.out_trade_no	string	商户订单号
data.money	decimal	订单金额
data.real_money	decimal	实付金额（含浮动）
data.pay_url	string	支付页面URL
data.expire_time	int	过期时间戳

3. 订单查询

请求地址：https://q.haoyaoshop.cn/api/query.php

请求方式：POST / GET

参数名	类型	必填	说明
pid	string	是	商户ID
trade_no	string	否	平台订单号（与商户订单号二选一）
out_trade_no	string	否	商户订单号

4. 签名算法

签名生成规则如下：

将所有参数（除sign外）按照参数名ASCII码从小到大排序
使用URL键值对的格式（key1=value1&key2=value2...）拼接成字符串
在拼接好的字符串末尾拼接上商户密钥key
对最终的字符串进行MD5运算，得到sign值

PHP示例代码：

function generateSign($data, $key) {
    ksort($data);
    $str = '';
    foreach ($data as $k => $v) {
        if ($k != 'sign' && $v !== '' && !is_null($v)) {
            $str .= $k . '=' . $v . '&';
        }
    }
    $str = trim($str, '&');
    return md5($str . $key);
}

5. 异步通知

支付成功后，系统会向您设置的notify_url地址发送POST通知。

参数名	类型	说明
pid	string	商户ID
trade_no	string	平台订单号
out_trade_no	string	商户订单号
type	string	支付方式
money	decimal	订单金额
real_money	decimal	实付金额
param	string	自定义参数
status	int	订单状态（1=支付成功）
pay_time	int	支付时间戳
sign	string	签名

注意：收到通知后，请验证签名是否正确，验证通过后请输出 "success" 表示接收成功。否则系统会在一段时间后重发通知。