/v1/pay/create
创建一笔支付订单
请求参数 (application/json)
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| app_id | string | 是 | 商户应用ID |
| channel | string | 是 | 支付渠道: alipay, wechat, unionpay, qqpay, DCEP |
| amount | number | 是 | 交易金额 (单位: 元, 保留两位) |
| subject | string | 是 | 商品标题 |
| out_trade_no | string | 否 | 商户订单号 (若不传则系统生成) |
| notify_url | string | 否 | 异步通知地址 |
| sign | string | 是 | RSA签名 (详见签名规则) |
请求示例
{
"app_id": "202410210001",
"channel": "alipay",
"amount": 1.00,
"subject": "四方支付测试商品",
"out_trade_no": "T20260724001",
"notify_url": "https://yourdomain.com/notify",
"sign": "A2E7F9C8D4B1..."
}响应参数
| trade_no | string | 系统交易号 |
| out_trade_no | string | 商户订单号 |
| status | string | pending / success / fail |
| pay_url | string | 支付链接 (H5/PC跳转) |
/v1/pay/query
根据订单号查询交易状态
请求参数 (Query String)
| app_id | string | 是 | 商户应用ID |
| trade_no | string | 否 | 系统交易号 (二选一) |
| out_trade_no | string | 否 | 商户订单号 (二选一) |
| sign | string | 是 | 签名 |
GET /v1/pay/query?app_id=202410210001&out_trade_no=T20260724001&sign=... HTTP/1.1/v1/pay/refund
请求参数
| app_id | string | 是 | 商户应用ID |
| trade_no | string | 否 | 系统交易号 |
| out_trade_no | string | 否 | 商户订单号 |
| refund_amount | number | 是 | 退款金额 (元) |
| refund_reason | string | 否 | 退款原因 |
| sign | string | 是 | 签名 |
支付成功后，系统会以 POST 形式将交易结果通知到商户设置的 notify_url。商户需返回 {"code":0} 表示接收成功。
回调参数 (示例)
{
"trade_no": "T2026072422001",
"out_trade_no": "T20260724001",
"amount": 1.00,
"status": "success",
"pay_time": "2026-07-24 14:22:10",
"sign": "F7A8B9C..."
}| 错误码 | 描述 |
|---|---|
| 10001 | 参数缺失或格式错误 |
| 10002 | 签名验证失败 |
| 10003 | 商户未开通该渠道 |
| 10004 | 交易金额超限 |
| 10005 | 订单不存在 |
| 10006 | 订单已支付/退款 |