支付与结账 API

结账页、支付宝/ PayPal 下单与回调。

结账页面

接口地址：

  • /checkout

HTTP请求方式

  • GET

请求参数

  • plan (query, optional): 套餐，如 free / standard / pro / ultra

响应代码

  • 200: 返回结账页面 HTML

说明：根据 plan 和语言展示对应价格（如 zh 为人民币，en 为美元）。

支付宝创建订单（重定向）

接口地址：

  • /checkout/alipayorders

HTTP请求方式

  • GET

请求参数

  • amount (query, required): 支付金额，如 69.99

响应代码

  • 302: 重定向到支付宝支付页

说明：创建支付宝订单并跳转支付，需登录。支付成功后会重定向到 /pay/back（或配置的回调地址）。

支付宝返回（重定向）

接口地址：

  • /checkout/alipayback

HTTP请求方式

  • GET

请求参数

  • 支付宝同步回调 query 参数

响应代码

  • 302: 重定向到 /billing

说明：用户支付完成后支付宝同步跳转至该地址，服务端再重定向到 /billing。验签与订单更新见实现。

PayPal 创建订单

接口地址：

  • /checkout/paypalorders

HTTP请求方式

  • POST

请求参数

  • 请求体 JSON:

    {
  "cart": [
    { "plan": "pro" | "ultra" | "custom", "quantity": "1" }
  ]
}
响应代码

  • 200: 返回 PayPal 订单对象（含 id、links 等）

响应示例：

  • JSON: PayPal Create Order 响应（含 id、status、links 等）

PayPal 捕获订单

接口地址：

  • /checkout/paypalorders/:id/capture

HTTP请求方式

  • POST

请求参数

  • id (path): PayPal 订单 ID

响应代码

  • 200: 返回 PayPal 捕获结果

响应示例：

  • JSON: PayPal Capture Order 响应