订单与商品

订单流程

1. 商品目录 GET /v1/catalog：商品、交付方式、价格和库存情况。
2. 下单 POST /v1/orders 在同一操作中从余额扣款并交付商品。订单号（order_id）由我们生成。
3. 商品 GET /v1/orders/{order_id}：key 为卡密或兑换码，account 为账号。请加密存储。
4. 在客户账号上开通订阅 订单等待客户信息（状态 waiting）：请通过 POST /v1/orders/{order_id}/activate 提交（见「开通」一节）。

商品目录

GET /v1/catalog — 每件商品只有一个 product_id，商品如何交付给客户由 delivery_methods 描述：每种交付方式都有自己的价格 price_usdt、订阅时长 subscription_days 和库存状态 in_stock（API 不返回具体库存数量）。商品目录每 1 分钟更新一次。

创建订单

POST /v1/orders — {"product_id": "…"}。如果商品有多种交付方式，请加上 "delivery_method"；缺少该字段时会返回 40005 delivery_method_required，并在 details 中列出可选方式：我们不会替您擅自选择，因为不同方式的价格不同。

curl https://api.astrum.shop/v1/orders \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11"}'

import os, httpx

order = httpx.post(
    "https://api.astrum.shop/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['ASTRUM_KEY']}"},
    json={"product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11"},
    timeout=30,
).json()

const res = await fetch("https://api.astrum.shop/v1/orders", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ASTRUM_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ product_id: "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11" }),
});
const order = await res.json();

示例：从余额下单

{
  "product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11"
}

{
  "order_id": "b1e04c6e-5a0b-4f6e-9a39-0b9f2f1c8d21",
  "product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11",
  "product_name": "ChatGPT Plus",
  "delivery_method": "activation",
  "subscription_days": 30,
  "status": "waiting",
  "status_text": "等待您提供开通所需的信息。",
  "price_usdt": "20.00",
  "refunded_usdt": null,
  "created_at": "2026-09-28T10:14:03Z",
  "available_actions": [
    "activate",
    "cancel"
  ],
  "activation": {
    "customer_data_type": "chatgpt_session",
    "customer_instruction": "请在浏览器中登录 ChatGPT，打开 chatgpt.com/api/auth/session 页面，完整复制页面上的全部文字并发送给我们。如果您当前在团队工作空间中，请先切换到个人账号。",
    "verification_link": null,
    "verification_until": null,
    "current_plan_until": null,
    "note_to_customer": null,
    "page_url": "https://activate.astrum.shop/#t=seBMbloLT26aOQufLxyNIfi1NV8Ia9Gl8a4-FyM75pc"
  },
  "warranty": {
    "until": null,
    "claim_id": null,
    "claim_status": null
  }
}

订单状态

status_text 是面向客户的现成文本，请原样展示。当前可执行的操作见 available_actions（activate、retry、force、cancel）。

订单中返回的商品

GET /v1/orders/{order_id} — 返回订单，以及已交付的商品：

商品尚未交付时，响应中完全没有 key 和 account 字段。无法明确拆分的账号信息（例如密码中含有冒号），请直接使用 text 中的完整内容。

当日订单

GET /v1/orders — 返回当天（UTC 自然日）的订单，最新的在前；查询其他日期使用 ?date=2026-09-28。列表中不包含商品。

取消订单

POST /v1/orders/{order_id}/cancel — 款项立即退回余额，商品退回库存。在商品被取走之前可以取消：

• 卡密或账号：GET /v1/orders/{order_id} 尚未返回过商品；
• 订阅：尚未提交过客户信息。

当前能否取消，看 available_actions 中是否有 cancel。否则会返回错误：50002 goods_already_taken、50003 customer_data_already_sent、50005 order_in_progress（新账号从下单第一分钟起即开始准备）。已交付的商品有问题时，请在交付后 7 天内提交售后申请（见「质保」一节）。

错误

请根据 code 而不是文本做分支判断：message 面向人阅读，内容可能变化。访问类错误对所有接口通用，完整列表见「错误码」一节。