创建支付订单

POST

/api/pay

创建一个新的支付订单，返回支付链接或二维码。

注意事项：

需要 Bearer Token 认证

OutPayOrderNo 在10分钟内不能重复

订单有效期为5分钟

金额最小0.01元，最大99999.99元

WebPay 参数说明：

true: 返回网页地址，用户点击后跳转到二维码页面

false: 返回二维码链接，客户端自行展示二维码

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

支付宝支付（网页模式）微信支付（二维码模式）手动支付（无回调）

{
    "OutPayOrderNo": "ORDER-20240206-001",
    "Amount": 0.01,
    "Name": "VIP会员",
    "Type": "alipay",
    "NotifyUrl": "https://your-domain.com/callback",
    "WebPay": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

支付宝支付（网页模式）微信支付（二维码模式）手动支付（无回调）

curl --location --request POST '/api/pay' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "OutPayOrderNo": "ORDER-20240206-001",
    "Amount": 0.01,
    "Name": "VIP会员",
    "Type": "alipay",
    "NotifyUrl": "https://your-domain.com/callback",
    "WebPay": true
}'

返回响应

🟢200成功

application/json

订单创建成功

Body

示例

成功响应重复订单（返回已存在订单）

{
    "code": 200,
    "message": "订单创建成功",
    "OutPayOrderNo": "ORDER-20240206-001",
    "PayOrderNo": "550e8400-e29b-41d4-a716-446655440000",
    "PayUrl": "http://localhost:8080/pay?PayOrderNo=550e8400-e29b-41d4-a716-446655440000"
}

🟠400请求有误

🟠401未认证

🔴500服务器内部错误

修改于 2026-02-06 19:13:40

字符集

查询订单支付状态