API Endpoints
List Products
text
GET /api/productsReturns all active products with a single unit price.
Response Example:
json
{
"success": true,
"products": [
{
"id": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"slug": "gmail-usa-fresh",
"name_zh": "谷歌企业/教育邮箱",
"name_en": "Google Workspace / Education Email",
"stock": 44,
"min_quantity": 5,
"price":
0.5
}
]
}Get Product Detail
text
GET /api/products/:idOrSlugYou can query by product id or slug.
Create Order
text
POST /api/orders/create| Parameter | Type | Required | Description |
|---|---|---|---|
| productId | string | Yes | Product ID. Use the id returned by GET /api/products, not the slug |
| quantity | integer | Yes | Purchase quantity. Maximum 200 per order and cannot exceed stock; minimum follows the product min_quantity |
| contactEmail | string | Yes | Email used for order contact and order lookup |
| paymentMethod | string | Yes | Payment method. Allowed values: crypto, balance_cny, balance_crypto, alipay, wechat |
| coin | string | No | Required only when paymentMethod=crypto. Allowed values: trc20_usdt, erc20_usdt, bep20_usdt, btc, eth, trx, bnb |
| couponCode | string | No | Coupon code. Omit it when unused |
paymentMethod values:
| Value | Description | Bearer Token Required |
|---|---|---|
crypto | On-chain crypto payment. The response returns a payment address and expected amount | No |
balance_cny | CNY balance payment. Deducts the order amount from users.balance | Yes |
balance_crypto | USD/crypto balance payment. Deducts the converted amount from users.balance_crypto | Yes |
alipay | External Alipay checkout. Availability follows /api/payment-config | No |
wechat | External WeChat Pay checkout. Availability follows /api/payment-config | No |
Balance payments require the logged-in user token in the request header:
text
Authorization: Bearer USER_TOKENCrypto Payment Example:
json
{
"productId": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "crypto",
"coin": "trc20_usdt"
}CNY Balance Payment Example:
json
{
"productId": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "balance_cny"
}Query Order
text
GET /api/orders/query?order_no=GS2604291234ABCD&[email protected]Both order number and email are required. When the order is completed, this endpoint returns the delivered account credentials. It is rate limited to 3 requests per IP per 60 seconds and 2 requests per order/email pair per 60 seconds.
Get Order Payment / Fulfillment Status
text
GET /api/orders/:id/status