支付网关 API 文档

版本 v1.0 · 基础请求地址：https://p.paysphere.cn

简介

本平台提供标准的 RESTful 支付接口。商户系统在发起支付前，需要按照本文档的规则对请求参数进行加密签名。系统支持微信 Native 扫码支付、支付宝网页支付等多种通道。

签名规则

为了保护数据安全，所有请求参数（除 sign 外）必须参与签名。规则如下：

将参数按照键名 ASCII 码从小到大排序（字典序）。
使用 URL 键值对格式拼接，即 key1=value1&key2=value2...。
在拼接后的字符串末尾直接拼接上商户的 AppSecret（不参与 URL 拼接，直接拼串）。
对最终的字符串进行 HMAC-SHA256 计算，结果转为大写，即为最终的 sign 值。

// 签名计算示例 (PHP)
$params = [
    'app_id' => 'AK123456',
    'amount' => '0.01',
    'merchant_order_no' => 'TEST_001'
];
ksort($params);
$str = http_build_query($params) . '&key=' . $app_secret;
$sign = strtoupper(hash_hmac('sha256', $str, $app_secret));

基础信息

请求格式： application/x-www-form-urlencoded 或 application/json

响应格式： 统一返回 JSON。例如：{"code":0, "msg":"ok", "data": {...}}

创建订单

接口地址： POST /api/v1/order/create

参数名	类型	必填	说明
app_id	String	是	平台分配的商户 AppID
merchant_order_no	String	是	商户系统内部的订单号，要求 32 位以内且唯一
amount	Decimal	是	订单总金额，单位为元，保留两位小数（如 0.01）
pay_type	String	是	支付类型：`wechat` 或 `alipay`
subject	String	否	商品名称或订单标题
notify_url	String	否	异步通知地址，不传则使用后台配置的默认地址
return_url	String	否	支付成功后的同步跳转地址
sign	String	是	按照签名规则生成的签名串

// 返回成功示例
{
    "code": 0,
    "msg": "ok",
    "data": {
        "order_no": "202610251504582870",
        "pay_url": "https://p.paysphere.cn/pay/202610251504582870"
    }
}

查询订单

接口地址： GET /api/v1/order/query

通过 order_no（平台订单号）或 merchant_order_no（商户订单号）查询。返回结果中的 status 为 1 表示已支付，0 表示未支付。

异步通知 (Notify)

当用户支付成功后，平台会向您的 notify_url 发送 POST 请求。您需要验证签名，并且返回纯字符串 success 告知平台已收到。

通知参数包含：order_no, amount, trade_no, status, sign 等。

开始

核心接口