CPCardPilot

INTEGRATION API · V1

把卡密兑换接入你的另一个网站

第三方只提交卡密、完整 ChatGPT Session 和自己的幂等请求号。套餐识别、卡片选择、订单轮询全部由 CardPilot 完成。

POST

/api/integrations/v1/recharges

创建充值任务。请求头必须携带 X-Partner-Key。

{
  "redeemCode": "CP-XXXX-XXXX-XXXX-XXXX",
  "externalRequestId": "your-order-20260821-001",
  "session": {
    "user": {},
    "account": {},
    "accessToken": "..."
  }
}
GET

/api/integrations/v1/recharges/:id

读取本地已保存的脱敏订单状态，不主动请求上游。

curl -H "X-Partner-Key: $PARTNER_KEY" https://your-domain/api/integrations/v1/recharges/RC-...
POST

/api/integrations/v1/recharges/:id/poll

主动查询上游并更新状态。终态为 success 或 failed。

{
  "ok": true,
  "order": {
    "id": "RC-...",
    "planType": "plus",
    "status": "processing"
  }
}