Reseller API · v1 & SHOPCLONE7 compatible

Connect your reseller site, buy accounts automatically

List products, buy with your wallet balance and receive the accounts right in the JSON response. Use API v1 for new integrations, or the SHOPCLONE7-compatible API so SHOPCLONE6/7 sites only switch the domain and API key.

Base URL
/api/v1
Format
JSON · UTF-8
Auth
Bearer API key
curl -X POST "https://your-domain/api/v1/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f3c9a2e-order-1001" \
  -d '{"product_id": 3, "quantity": 2}'

Authentication

Send your API key in the Authorization: Bearer <API key> header (or X-API-Key). Never put the key in the URL; if it leaks, generate a new one right away.

GET/api/v1/me

Account info

Account info, wallet balance and purchase rate limits.

Request

GEThttps://your-domain/api/v1/me

Parameters

AuthorizationRequired
headerBearer <API key>

Code samples

curl "https://your-domain/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

200 OK · application/json
{
  "success": true,
  "data": {
    "username": "daily01",
    "email": "[email protected]",
    "balance": 1250000,
    "currency": "VND",
    "limits": { "buy_interval_seconds": 3, "max_wait_seconds": 25 }
  }
}
GET/api/v1/categories

List categories

Active categories with product counts (including subcategories).

Request

GEThttps://your-domain/api/v1/categories

Parameters

AuthorizationRequired
headerBearer <API key>
langOptional
queryLanguage of product names and messages (vi, en)

Code samples

curl "https://your-domain/api/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

200 OK · application/json
{
  "success": true,
  "data": [
    { "id": 1, "parent_id": null, "name": "Facebook", "icon": "https://…/facebook.svg", "product_count": 11 },
    { "id": 8, "parent_id": 1, "name": "Via Việt Nam", "icon": null, "product_count": 4 }
  ]
}
GET/api/v1/products

List products

Products with filters and pagination; prices are your own prices.

Request

GEThttps://your-domain/api/v1/products?category_id=1&in_stock=1&page=1&limit=50

Parameters

AuthorizationRequired
headerBearer <API key>
category_idOptional
queryFilter by category (including subcategories)
searchOptional
querySearch by product name
in_stockOptional
query1 = only products in stock
pageOptional
queryPage, default 1
limitOptional
queryRows per page, default 50, max 100
langOptional
queryLanguage of product names and messages (vi, en)

Code samples

curl "https://your-domain/api/v1/products?category_id=1&in_stock=1&page=1&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

200 OK · application/json
{
  "success": true,
  "data": [
    {
      "id": 3,
      "name": "Via VN cổ 2FA",
      "category_id": 8,
      "price": 45000,
      "currency": "VND",
      "stock": 120,
      "in_stock": true,
      "min_quantity": 1,
      "max_quantity": 100,
      "country": "vn",
      "description": "…",
      "image": "https://…/via.png"
    }
  ],
  "meta": { "page": 1, "limit": 50, "total": 19, "total_pages": 1 }
}
GET/api/v1/products/{id}

Get product

A single product by ID.

Request

GEThttps://your-domain/api/v1/products/3

Parameters

AuthorizationRequired
headerBearer <API key>
idRequired
pathProduct ID
langOptional
queryLanguage of product names and messages (vi, en)

Code samples

curl "https://your-domain/api/v1/products/3" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

200 OK · application/json
{
  "success": true,
  "data": {
    "id": 3,
    "name": "Via VN cổ 2FA",
    "category_id": 8,
    "price": 45000,
    "currency": "VND",
    "stock": 120,
    "in_stock": true,
    "min_quantity": 1,
    "max_quantity": 100,
    "country": "vn",
    "description": "…",
    "image": "https://…/via.png"
  }
}
POST/api/v1/orders

Create order (buy)

Buy with your wallet balance and receive the accounts in the response. Supports Idempotency-Key for safe retries without double buying.

Request

POSThttps://your-domain/api/v1/orders

Parameters

AuthorizationRequired
headerBearer <API key>
Idempotency-KeyOptional
headerUnique string per purchase (max 128 chars). Resending the same key within 24 hours returns the original order instead of buying again
product_idRequired
integerProduct ID (from /v1/products)
quantityRequired
integerQuantity to buy, between min_quantity and max_quantity
couponOptional
stringCoupon code, if any
waitOptional
booleantrue (default): wait up to a few dozen seconds for delivery; false: return immediately, fetch later with GET /v1/orders/{code}

Code samples

curl -X POST "https://your-domain/api/v1/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f3c9a2e-order-1001" \
  -d '{"product_id": 3, "quantity": 2}'

Sample response

201 Created · application/json
{
  "success": true,
  "message": "Tạo đơn hàng thành công!",
  "data": {
    "code": "STC261028TAKE49XD",
    "status": "completed",
    "source": "api",
    "total": 90000,
    "discount": 0,
    "currency": "VND",
    "coupon": null,
    "quantity": 2,
    "items": [
      { "product_id": 3, "name": "Via VN cổ 2FA", "unit_price": 45000, "quantity": 2, "total": 90000 }
    ],
    "created_at": "2026-10-28T09:15:02.000Z",
    "delivered": 2,
    "accounts": [
      "1000040304952|GUTJXYIFPWLHCNDOMBRKVAQESZ",
      "1000087676467|IVMRLABECWTQYUXHPOFNJDSZGK"
    ]
  }
}
GET/api/v1/orders

List orders

Order history (newest first), without accounts.

Request

GEThttps://your-domain/api/v1/orders?status=completed&page=1

Parameters

AuthorizationRequired
headerBearer <API key>
statusOptional
queryFilter by status: pending, processing, completed, cancelled, refunded
sourceOptional
queryFilter by source: api or web
pageOptional
queryPage, default 1
limitOptional
queryRows per page, default 50, max 100

Code samples

curl "https://your-domain/api/v1/orders?status=completed&page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

200 OK · application/json
{
  "success": true,
  "data": [
    {
      "code": "STC261028TAKE49XD",
      "status": "completed",
      "source": "api",
      "total": 90000,
      "discount": 0,
      "currency": "VND",
      "coupon": null,
      "quantity": 2,
      "items": [
        { "product_id": 3, "name": "Via VN cổ 2FA", "unit_price": 45000, "quantity": 2, "total": 90000 }
      ],
      "created_at": "2026-10-28T09:15:02.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 50, "total": 1, "total_pages": 1 }
}
GET/api/v1/orders/{code}

Get order

Order details with the delivered accounts.

Request

GEThttps://your-domain/api/v1/orders/STC261028TAKE49XD

Parameters

AuthorizationRequired
headerBearer <API key>
codeRequired
pathOrder code

Code samples

curl "https://your-domain/api/v1/orders/STC261028TAKE49XD" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

200 OK · application/json
{
  "success": true,
  "data": {
    "code": "STC261028TAKE49XD",
    "status": "completed",
    "source": "api",
    "total": 90000,
    "discount": 0,
    "currency": "VND",
    "coupon": null,
    "quantity": 2,
    "items": [
      { "product_id": 3, "name": "Via VN cổ 2FA", "unit_price": 45000, "quantity": 2, "total": 90000 }
    ],
    "created_at": "2026-10-28T09:15:02.000Z",
    "delivered": 2,
    "accounts": [
      "1000040304952|GUTJXYIFPWLHCNDOMBRKVAQESZ",
      "1000087676467|IVMRLABECWTQYUXHPOFNJDSZGK"
    ]
  }
}

Error codes

On error success = false; error.code is a stable code for your program, error.message is human readable, plus request_id for support.

402 Payment Required · application/json
{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Số dư không đủ, vui lòng nạp thêm",
    "status": 402
  },
  "request_id": "4c043782-5dac-4e19-8ef8-60b7ff3c7c20"
}
400invalid_request
Missing or invalid parameter
400invalid_quantity
Quantity outside the allowed range
400out_of_stock
Not enough stock
401missing_api_key
Missing Authorization header
401invalid_api_key
Wrong API key or locked account
402insufficient_balance
Insufficient wallet balance
403ip_not_allowed
IP is not in the key whitelist
404product_not_found
Product not found or no longer sold via the API
404order_not_found
Order not found
409idempotency_conflict
Idempotency-Key already used for a different request, or the previous request is still processing
429rate_limited
Buying too fast or too many wrong keys
503api_disabled
API temporarily disabled
503order_refunded
Supplier failed, the order was refunded

Integration notes

  • Send an Idempotency-Key with every purchase so you can safely retry on network errors or timeouts.
  • Orders have status = processing while not fully delivered — call GET /v1/orders/{code} to get the rest.
  • Each key must wait at least 3 seconds between two purchases.
  • Returned prices are your own prices (tier and Flash Sale applied), in VND.
  • Every response has an X-Request-Id header; include it when contacting support.
  • Only automatically delivered products can be bought via the API.