GETGPT STOREFRONT API · v1

普通买家购买 API

更新日期：2026-11-03 ·下载 Markdown 版本

普通买家无需注册、登录或申请 API Key。流程与常见数字商品商城一致：读取商品、提交邮箱创建订单、打开返回的支付链接付款，再凭订单号和一次性返回的订单令牌查询支付与交付状态。

请求约定

接口列表

商品查询

商品价格、档位、库存状态和数量阶梯价都来自实时商品目录。库存为零时仍允许创建订单；付款后进入补货等待，补货完成会自动交付。

curl https://getgpt.homes/api/v1/products

curl https://getgpt.homes/api/v1/products/chatgpt-plus-ios-us-card

创建订单

请求示例

{
  "product_slug": "chatgpt-plus-ios-us-card",
  "email": "buyer@example.com",
  "quantity": 1,
  "payment_method": "wechat",
  "variant_id": 1
}

成功响应

{
  "code": 201,
  "msg": "success",
  "data": {
    "order": {
      "trade_no": "GG20261103123000A1B2C3D4",
      "state": "pending",
      "status": "pending",
      "product_slug": "chatgpt-plus-ios-us-card",
      "product_name": "ChatGPT Plus 美区卡密（iOS）",
      "quantity": 1,
      "amount": "115.00",
      "currency": "CNY",
      "payment_method": "wechat",
      "payment_url": "https://checkout.example.com/...",
      "payment_expires_at": "2026-11-03T13:00:00.000Z",
      "delivery": [],
      "message": "订单已创建，请完成支付。"
    },
    "order_token": "eyJraW5kIjoiYXBpX29yZGVyIi...签名",
    "order_token_expires_at": "2026-12-03T12:30:00.000Z",
    "duplicate": false
  }
}

order_token 默认 30 天有效，仅在创建订单时返回。请与服务端订单号一起安全保存，不要在公开页面或日志中传播。

查询与轮询订单

将订单令牌放入 Bearer 请求头。订单处于交付状态时，delivery 才包含卡密或账号内容；未支付和补货中不会提前返回交付数据。

curl https://getgpt.homes/api/v1/orders/GG20261103123000A1B2C3D4 \
  -H 'authorization: Bearer eyJraW5kIjoiYXBpX29yZGVyIi...签名'

两笔支付商品

当创建响应中的 order.status 为 partially_paid 时，调用下一笔支付接口。该接口仅对仍待支付的订单有效。

curl -X POST https://getgpt.homes/api/v1/orders/GG20261103123000A1B2C3D4/payments/next \
  -H 'authorization: Bearer eyJraW5kIjoiYXBpX29yZGVyIi...签名'

错误码

代码示例

Node.js

import crypto from "node:crypto";

const base = "https://getgpt.homes";

const created = await fetch(base + "/api/v1/orders", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "idempotency-key": crypto.randomUUID()
  },
  body: JSON.stringify({
    product_slug: "chatgpt-plus-ios-us-card",
    email: "buyer@example.com",
    quantity: 1,
    payment_method: "wechat"
  })
}).then((response) => response.json());

const orderNo = created.data.order.trade_no;
const token = created.data.order_token;

const latest = await fetch(base + "/api/v1/orders/" + orderNo, {
  headers: { authorization: "Bearer " + token }
}).then((response) => response.json());

cURL

curl -X POST https://getgpt.homes/api/v1/orders \
  -H 'content-type: application/json' \
  -H 'idempotency-key: 6d9e34bc-74e5-4d5d-a78d-4587ba6f385b' \
  -d '{
    "product_slug":"chatgpt-plus-ios-us-card",
    "email":"buyer@example.com",
    "quantity":1,
    "payment_method":"wechat"
  }'

Python

import requests

base = "https://getgpt.homes"
created = requests.post(
    base + "/api/v1/orders",
    headers={"Idempotency-Key": "6d9e34bc-74e5-4d5d-a78d-4587ba6f385b"},
    json={
        "product_slug": "chatgpt-plus-ios-us-card",
        "email": "buyer@example.com",
        "quantity": 1,
        "payment_method": "wechat",
    },
    timeout=20,
).json()

order = created["data"]["order"]
token = created["data"]["order_token"]
latest = requests.get(
    base + "/api/v1/orders/" + order["trade_no"],
    headers={"Authorization": "Bearer " + token},
    timeout=20,
).json()

说明

本 API 只面向普通买家购买。代理余额、API Key、HMAC 签名、商户订单号和回调通知已停止开放；旧 /api/open/v1/* 地址统一返回 410。

商品价格与售卖状态会实时调整，应以创建订单时的响应为准。虚拟商品交付后不支持无理由退款，失败与售后按订单状态和商品说明处理。