POST /api/private/v1/redemptions

兑换卡密，为指定客户激活对应套餐。

鉴权

Authorization: Bearer <PRIVATE_API_KEY>
Content-Type: application/json

请求体

{
  "code": "ABC-DEF-GHI",
  "customer": "customer_001",
  "autoCreate": false
}

字段	类型	必填	说明
code	string	是	卡密字符串
customer	string	否	目标客户用户名
autoCreate	boolean	否	客户不存在时是否自动创建，默认 false

成功响应

{
  "ok": true,
  "requestId": "req_123",
  "data": {
    "customer": {
      "id": 1,
      "username": "customer_001",
      "created": false
    },
    "subscriptions": [
      {
        "id": 10,
        "planId": 2,
        "planName": "Pro",
        "validFrom": "2026-03-21T00:00:00.000Z",
        "validTo": "2026-04-21T00:00:00.000Z"
      }
    ]
  }
}

可能错误

• 404 CODE_NOT_FOUND
• 404 CUSTOMER_NOT_FOUND
• 409 CODE_ALREADY_REDEEMED
• 403 CUSTOMER_PROJECT_MISMATCH