码支付API开发文档 · 下单查询回调通知签名算法接口手册

所有 API 请求均通过 HTTPS 协议以 POST 方式提交至统一网关入口， 请求参数与返回数据均采用标准 JSON 格式进行编码传输。 商户接入前需在控制台创建应用并获取 appid 与 appsecret 密钥对。

为确保接口调用安全，所有请求必须携带 sign 签名参数， 签名生成需遵循以下标准步骤以避免签名校验失败。

1. 将所有请求参数（除 sign 本身）按参数名 ASCII 码从小到大排序（字典序）；
2. 使用 URL 键值对的格式（即 key1=value1&key2=value2…）拼接成字符串 stringA；
3. 在 stringA 最后拼接上 &key=AppSecret 得到 stringSignTemp 字符串；
4. 对 stringSignTemp 进行 MD5/HMAC-SHA256 运算，并将得到的字符串所有字符转换为大写，即 sign 值。

// 签名函数示例
function generateSign($params, $appSecret) {
    ksort($params);
    $str = http_build_query($params) . '&key=' . $appSecret;
    return strtoupper(md5($str));
}

// 参数示例
$params = [
    'appid'     => 'MP20240001',
    'out_trade_no' => 'O202407311530001',
    'total_fee' => '19800',
    'body'      => 'VIP会员开通'
];
$sign = generateSign($params, 'YOUR_APP_SECRET');

商户通过该接口创建支付订单，平台会根据支付类型参数返回对应的支付二维码链接或跳转地址。 建议订单号在商户系统内保证全局唯一性。

请求参数

响应示例

{
    "code": 1,
    "msg": "下单成功",
    "data": {
        "appid": "MP20240001",
        "out_trade_no": "O202407311530001",
        "trade_no": "MP20240731000012345",
        "total_fee": 19800,
        "pay_type": "wxpay",
        "code_url": "weixin://wxpay/bizpayurl?pr=AbCdEf123",
        "qr_code": "https://api.mapay.com/qrcode/xxxx.png",
        "pay_url": "https://pay.mapay.com/h5/xxxx",
        "expire_time": 1722411000,
        "nonce_str": "a8b9c0d1e2f3",
        "sign": "A1B2C3D4E5F67890123456789ABCDEF0"
    }
}

该接口用于主动查询指定订单的实时支付状态， 建议配合回调通知机制作为兜底查询，避免因网络抖动导致的回调延迟或丢失。

订单支付成功后，码支付服务器会通过 POST 方式将支付结果主动推送到商户在下单时传入的 notify_url 地址。 商户接收后需完成验签与业务逻辑处理，并返回特定字符串应答。

⚠️ 处理要求：商户回调接口接收到通知后，校验成功必须原样返回字符串 success，否则平台会按重试策略重复推送，最多10次。 请务必做好幂等性处理，避免同一订单重复发货。