UPI Paid API 文档

调用规则

所有接口使用 HTTPS 和 JSON；请求头需要 Content-Type: application/json。
提链使用普通 CDK，只有成功生成 UPI 链接才扣 1 次。
扫码订单使用金色点数 CDK，创建时预扣 1 点；订单失败或超时会自动退回。
access token、CDK 和订单凭证均属于敏感信息，请只在服务端调用。

1. 付费提链

POST /api/v1/paid/extract

使用一个 ChatGPT access token 生成真实 UPI instructions 链接。服务端使用内置付费代理池。

access_token · string · 必填
ChatGPT JWT access token；也兼容 credential / accessToken。

cdk · string · 必填
普通提链 CDK，格式通常为 UPI-…。

country · string · 可选
默认 IN。

telegram_session_id · string · 可选
已绑定 Telegram 时可接收成功通知。

curl -X POST https://upi.newzoe.cloud/api/v1/paid/extract \
  -H 'Content-Type: application/json' \
  -H 'X-Request-ID: demo-extract-001' \
  -d '{
    "access_token": "eyJ...",
    "cdk": "UPI-XXXXXXXX-XXXXXXXX-XXXXXXXX",
    "country": "IN"
  }'

{
  "ok": true,
  "request_id": "demo-extract-001",
  "data": {
    "code": "upi_instructions_ready",
    "upi_url": "https://checkout.stripe.com/...",
    "upi_instructions_url": "https://checkout.stripe.com/...",
    "payment_monitor_id": "pm_...",
    "payment_method": "upi",
    "cdk_remaining_uses": 9,
    "cdk_total_uses": 10
  }
}

2. 创建扫码订单

POST /api/v1/paid/scan-orders

提交已生成的 Stripe UPI 链接，创建工人后台扫码订单。订单会先进入待抢状态。

upi_url · string · 必填
提链接口返回的 UPI instructions 链接。

gold_cdk · string · 必填
金色点数 CDK；也兼容字段名 cdk。

telegram_session_id · string · 可选
用于关联顾客 Telegram 历史记录。

curl -X POST https://upi.newzoe.cloud/api/v1/paid/scan-orders \
  -H 'Content-Type: application/json' \
  -d '{
    "upi_url": "https://checkout.stripe.com/...",
    "gold_cdk": "GOLD-XXXXXXXX-XXXXXXXX-XXXXXXXX"
  }'

{
  "ok": true,
  "data": {
    "order_id": "UPI-AB12CD34",
    "status": "available",
    "expires_at": 1780000000,
    "upi_url": "https://checkout.stripe.com/...",
    "status_token": "hmac-order-token",
    "cdk_remaining_uses": 4,
    "cdk_total_uses": 5
  }
}

3. 查询扫码订单

GET /api/v1/paid/scan-orders/{order_id}?status_token=…

创建订单返回的 status_token 只用于该订单状态查询，也可用字段名 token。

curl 'https://upi.newzoe.cloud/api/v1/paid/scan-orders/UPI-AB12CD34?status_token=hmac-order-token'

{
  "ok": true,
  "data": {
    "order_id": "UPI-AB12CD34",
    "status": "claimed",
    "gold_point_state": "reserved",
    "cdk_remaining_uses": 4,
    "cdk_total_uses": 5,
    "can_complain": false,
    "complaint_submitted": false
  }
}

状态	含义
`available`	待抢订单，工人后台可见。
`claimed`	已被工人领取，正在扫码。
`paid`	扫码支付成功。
`unpaid`	工人已领取并扫码，但付款链到期时仍未到账。
`expired`	订单超时，金色点数已退回。
`failed`	支付检测失败，金色点数已退回。

错误响应

{
  "ok": false,
  "code": "cdk_exhausted",
  "message": "CDK 次数已用完"
}

常见 code：missing_access_token、invalid_access_token、missing_cdk、invalid_cdk、cdk_exhausted、missing_gold_cdk、complaint_access_denied、rate_limited。