Tài liệu API

Khóa API của bạn

Test API

Chọn một hành động, điền tham số và gửi yêu cầu. Khi đã đăng nhập, khóa API của bạn sẽ được tải tự động.

curl -X POST "https://hstockplus.net/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

Điểm cuối API

Tất cả yêu cầu API nên được gửi qua HTTP POST đến điểm cuối này.

Giới hạn tốc độ

Giới hạn được tính theo từng khóa API — chỉ hai thao tác danh sách bên dưới bị giới hạn

A limited call still returns HTTP 200, with the error below. retry_after_ms is how many milliseconds to wait before the next call. A key that keeps calling while limited (about 20 limited calls in one minute) is paused for 60 seconds.

{"error": "Rate limit exceeded", "retry_after_ms": 1400}

To check price and stock of many products, call products once with productIds (up to 100 per call) instead of one services call per product. For the stock of each option of one product, use inventory.

Ngôn ngữ tùy chọn (lang)

Tùy chọn. Mã ngôn ngữ đích. Sử dụng một trong các mã được hỗ trợ được liệt kê bên dưới. Khi được thiết lập và không phải là en, các trường có thể dịch sẽ được trả về bằng ngôn ngữ đó. Nếu bản dịch chưa có sẵn, API sẽ trả về tiếng Anh.

Được hỗ trợ trên các hành động đọc: categories, subcategory_info, services, products, inventory ((tên sản phẩm phụ)), sms_projects, và sms_countries. Bỏ qua lang hoặc dùng en cho tiếng Anh.

Các tham số bộ lọc danh mục và danh mục con trên dịch vụ/sản phẩm luôn sử dụng tên tiếng Anh chuẩn, ngay cả khi lang được thiết lập.

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Lấy Danh mục

Lấy tất cả danh mục và danh mục con của từng danh mục. Sử dụng các giá trị này để lọc Danh sách Dịch vụ theo danh mục hoặc danh mục con.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

Ví dụ Phản hồi:

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

Thông tin danh mục con

Lấy thông tin chi tiết danh mục con theo subcategoryId, bao gồm cả danh mục cha. Sử dụng subcategoryId từ các hàng trong Danh sách Sản phẩm.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

Ví dụ Phản hồi:

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://cdn.hstockplus.org/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

Danh sách Cửa hàng

Liệt kê các cửa hàng đang hoạt động kèm thông tin cơ bản, số lượng sản phẩm và đánh giá xếp hạng. Tên cửa hàng được ẩn danh để bảo vệ quyền riêng tư.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

Với phân trang:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

Danh sách mã giảm giá

Liệt kê mã giảm giá của mọi cửa hàng có thể dùng ngay lúc này, kèm điều kiện của từng mã. Truyền mã vào coupon của action=add. Các mã chỉ dành riêng cho tài khoản của bạn (ví dụ báo giá sỉ từ một ticket) cũng được liệt kê và đánh dấu private.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=coupons"

Ví dụ Phản hồi:

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

Mã giảm giá được trừ vào số tiền còn lại sau khi áp dụng chiết khấu đại lý. Các trường tùy chọn sẽ được lược bỏ khi mã không có điều kiện tương ứng.

Danh sách Sản phẩm

Chỉ liệt kê sản phẩm marketplace (không có dịch vụ SMM). Các trường giống như hàng sản phẩm trong Danh sách Dịch vụ, bao gồm id (id thực thể sản phẩm), service (số dịch vụ thân thiện), description và imageUrl. productIds tùy chọn chỉ trả về các sản phẩm đó (số dịch vụ thân thiện từ danh sách và/hoặc id thực thể sản phẩm, phân tách bằng dấu phẩy hoặc mảng JSON, tối đa 100). sort=sold tùy chọn sắp xếp kết quả theo số lượng đơn hàng đã thanh toán giảm dần (sản phẩm bán chạy nhất trước).

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

Lọc theo ID sản phẩm:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

Với phân trang:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

Lọc theo danh mục hoặc danh mục con:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

Sản phẩm bán chạy nhất trong một danh mục con:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

Chỉ các sản phẩm được đề xuất:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

Danh sách Dịch vụ

Lấy tất cả dịch vụ có sẵn với phân trang tùy chọn. Mỗi hàng bao gồm id (id thực thể), service (số dịch vụ thân thiện), stock (tồn kho) và entityType (smm hoặc product). Tham số entityType tùy chọn chỉ trả về hàng product hoặc smm. Tham số danh mục và danh mục con tùy chọn chỉ trả về dịch vụ trong danh mục hoặc danh mục con đó (giá trị từ API Lấy Danh mục). Tham số shopId tùy chọn chỉ trả về sản phẩm và dịch vụ cho cửa hàng đó (sử dụng shopId từ Danh sách Cửa hàng). Tham số productIds tùy chọn chỉ trả về các hàng phù hợp (số dịch vụ thân thiện và/hoặc id thực thể; khớp với hàng sản phẩm hoặc smm). Sử dụng action=products để chỉ lọc sản phẩm.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Với phân trang:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

Lọc theo danh mục hoặc danh mục con:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Lọc theo loại thực thể:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

Ví dụ Phản hồi:

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Mỗi hàng bao gồm id (mã thực thể) và service (số dịch vụ thân thiện cho đơn hàng), stock, entityType (smm hoặc product), và autoDelivery. Các hàng sản phẩm cũng bao gồm description, imageUrl, isRecommended, và subcategoryId. Khi limit là 0 hoặc bị bỏ qua, tất cả dịch vụ được trả về và page/limit bằng tổng số.

Các dòng sản phẩm còn mang những số liệu hiển thị trên trang sản phẩm: service là số sản phẩm (#48071 trên trang), sellerRating và sellerReviewCount là điểm sao của người bán và số lượt đánh giá, returningBuyerRate là tỷ lệ người mua quay lại của người bán (0.52 = 52%), sold là số lượng đã bán, và warrantyHours là thời hạn hậu mãi tính bằng giờ kể từ lúc giao hàng (0 = không có hậu mãi). sellerRating, sellerReviewCount và returningBuyerRate sẽ bị lược bỏ khi người bán chưa có đánh giá hoặc có quá ít người mua.

Kiểm tra Tồn kho

Lấy tồn kho hiện tại và tình trạng còn hàng của một dịch vụ theo ID (cùng ID với trong danh sách dịch vụ). Với sản phẩm trên marketplace, JSON bao gồm subproducts: một mảng các biến thể đang hoạt động, mỗi biến thể có subproductId, name, stock (tồn kho hiển thị của biến thể đó) cùng giá và giới hạn đặt hàng riêng: available, rate, min, max, và packs cho các tùy chọn bán theo gói cố định.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

Ví dụ Phản hồi (SMM):

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

Ví dụ phản hồi (sản phẩm):

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

Phản hồi bao gồm tỷ lệ (trên mỗi đơn vị, cùng định dạng chuỗi như danh sách dịch vụ), entityType (smm hoặc product) và autoDelivery (true = tự động giao hàng, false = nhà cung cấp thực hiện thủ công). Đối với dịch vụ sản phẩm, min và max khớp với hàng sản phẩm phụ chính trong danh sách dịch vụ; nếu sản phẩm phụ đó không thể đáp ứng đơn đặt hàng của bạn, nền tảng có thể chọn một sản phẩm phụ khác và tính giá đơn vị của nó. Mảng subproducts liệt kê mọi biến thể đang hoạt động với tồn kho hiển thị; phản hồi tồn kho SMM bỏ qua subproducts.

Mỗi subproduct có rate, min và max riêng: đó là đơn giá và khoảng số lượng mà add tính phí khi bạn truyền subproductId đó, trước mọi chiết khấu đại lý trên tài khoản của bạn. Với các tùy chọn bán theo gói cố định, packs liệt kê từng gói còn hàng (quantity, total price, discountPercent) và bạn phải đặt đúng một trong các số lượng đó; khi ấy rate, min và max mô tả gói nhỏ nhất.

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

Ví dụ Phản hồi:

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

Trạng thái đơn hàng

Lấy trạng thái của một đơn hàng.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

Ví dụ Phản hồi:

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

Đối với đơn hàng sản phẩm (ví dụ: tài khoản), khi đơn hàng được giao toàn bộ hoặc một phần, phản hồi bao gồm một mảng "accounts" chứa thông tin đăng nhập tài khoản đã giao (một chuỗi cho mỗi tài khoản). Đối với giao hàng một phần, chỉ các tài khoản đã giao cho đến thời điểm đó được trả về.

autoDelivery: true nếu đơn hàng được xử lý tự động (ví dụ: SMM, sản phẩm tự động/tồn kho); false nếu nhà cung cấp phải xử lý thủ công (có thể mất một thời gian).

Ví dụ Phản hồi (đơn hàng sản phẩm với tài khoản đã giao):

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

Các Trạng thái Có thể có:

Đơn hàng đã hoàn tiền trả về Canceled, đơn hàng hoàn tiền một phần trả về Partial. Khi có bất kỳ khoản tiền nào được hoàn, phản hồi còn kèm "refunded" cho biết số tiền đã hoàn bằng USD.

Ví dụ phản hồi (đơn hàng sản phẩm được giao dưới dạng tệp):

Một số sản phẩm (ví dụ tài khoản Telegram kèm tệp lưu phiên) được giao dưới dạng tệp ZIP thay cho hoặc bên cạnh thông tin đăng nhập dạng văn bản. Khi đó phản hồi có mảng "files". Mỗi tệp là một mục đã giao. Tải tệp bằng action=order_file.

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

Tải tệp đơn hàng

Tải xuống một tệp giao hàng (ZIP) của đơn hàng. Khi thành công, nội dung phản hồi chính là tệp (Content-Type: application/zip); khi thất bại, phản hồi là JSON có trường "error".

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

Ví dụ phản hồi lỗi:

{
  "error": "File not found"
}

Hãy kiểm tra header Content-Type trước khi lưu: application/zip là tệp, application/json là lỗi.

Tạo hủy

Hủy một hoặc nhiều đơn hàng (định dạng batch tương thích với PerfectPanel). Mỗi đơn hàng đủ điều kiện sẽ được hoàn tiền vào số dư của bạn.

Tất cả những điều sau đây phải đúng. Sử dụng allowcancel để kiểm tra điều kiện đủ mà không cần xử lý hoàn tiền.

• Hủy sớm: tính năng nền tảng được bật (cài đặt quản trị viên).
• Hủy sớm: productType có thể là manual, auto hoặc inventory (các dịch vụ tự động SMM thường sử dụng productType auto).
• Hủy sớm: trạng thái thanh toán là hoàn tất hoặc một phần.
• Hủy sớm: trạng thái đơn hàng là đang chờ, đang xử lý hoặc lỗi (lỗi từ nhà cung cấp hiển thị là đang tiến hành).
• Hủy sớm: không có external_id (đơn hàng chưa được gửi đến nhà cung cấp hoặc đối tác bên ngoài).
• Hủy sớm: ít nhất N phút kể từ khi thanh toán hoàn tất (auto_order_early_refund_minutes, mặc định 30).
• Hủy sớm: khách hàng chưa từng sử dụng tính năng tự hoàn tiền sớm cho đơn hàng này.
• Hủy sớm: đơn hàng chưa được giao đầy đủ (giao một phần sẽ được hoàn tiền tương ứng cho phần chưa giao).
• Hủy sớm: số tiền hoàn lại vẫn còn (refundedAmount nhỏ hơn tổng đơn hàng).
• Hủy sớm: không có tranh chấp đang hoạt động trên đơn hàng.
• Hủy sớm: không có nhà cung cấp nào rút lui ở trạng thái đã yêu cầu hoặc đã hoàn tất.

Giao hàng một phần sẽ được hoàn tiền tương ứng; các tài khoản đã giao vẫn được giữ lại.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

Ví dụ Phản hồi:

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

Cho phép hủy

Kiểm tra xem một hoặc nhiều đơn hàng có thể bị hủy ngay bây giờ không (cùng quy tắc đủ điều kiện như hủy, nhưng không xử lý hoàn tiền). Sử dụng trước khi gọi hủy để tránh các yêu cầu thất bại. Hỗ trợ ID đơn hàng hàng loạt (cách nhau bằng dấu phẩy, tối đa 100).

Tất cả những điều sau đây phải đúng. Sử dụng allowcancel để kiểm tra điều kiện đủ mà không cần xử lý hoàn tiền.

• Hủy sớm: tính năng nền tảng được bật (cài đặt quản trị viên).
• Hủy sớm: productType có thể là manual, auto hoặc inventory (các dịch vụ tự động SMM thường sử dụng productType auto).
• Hủy sớm: trạng thái thanh toán là hoàn tất hoặc một phần.
• Hủy sớm: trạng thái đơn hàng là đang chờ, đang xử lý hoặc lỗi (lỗi từ nhà cung cấp hiển thị là đang tiến hành).
• Hủy sớm: không có external_id (đơn hàng chưa được gửi đến nhà cung cấp hoặc đối tác bên ngoài).
• Hủy sớm: ít nhất N phút kể từ khi thanh toán hoàn tất (auto_order_early_refund_minutes, mặc định 30).
• Hủy sớm: khách hàng chưa từng sử dụng tính năng tự hoàn tiền sớm cho đơn hàng này.
• Hủy sớm: đơn hàng chưa được giao đầy đủ (giao một phần sẽ được hoàn tiền tương ứng cho phần chưa giao).
• Hủy sớm: số tiền hoàn lại vẫn còn (refundedAmount nhỏ hơn tổng đơn hàng).
• Hủy sớm: không có tranh chấp đang hoạt động trên đơn hàng.
• Hủy sớm: không có nhà cung cấp nào rút lui ở trạng thái đã yêu cầu hoặc đã hoàn tất.

Khi allowcancel là 1, phản hồi sẽ bao gồm refundAmount (số tiền sẽ được hoàn lại khi hủy).

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

Ví dụ Phản hồi:

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

Số dư

Lấy số dư hiện tại của bạn.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

Ví dụ Phản hồi:

{
  "balance": "100.00",
  "currency": "USD"
}

Tổng quan đơn hàng

Số lượng đơn hàng và tổng tiền trong một khoảng ngày, dùng để đối soát. Tính cùng các đơn hàng như trang Đơn hàng của bạn.

Ví dụ Yêu cầu:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=orders_summary" \
  -d "date_from=2026-10-31" \
  -d "date_to=2026-10-31" \
  -d "tz=480"

Ví dụ Phản hồi:

{
  "date_from": "2026-10-30T16:00:00.000Z",
  "date_to": "2026-10-31T16:00:00.000Z",
  "orders": 126,
  "refunded_orders": 3,
  "gross": "412.5000",
  "refunded": "6.2000",
  "net": "406.3000",
  "currency": "USD"
}

date_from and date_to echo the range as UTC instants (date_to is exclusive). Only paid orders are counted; unpaid and failed orders are ignored. orders is the number of paid orders, gross is what you paid, refunded is what came back to you, net = gross - refunded. Call at most once every 2 seconds.

API xác minh SMS

Các điểm cuối chuyên dụng cho dịch vụ xác minh SMS.

Đơn SMS có ID đơn hàng riêng. Dùng sms_code, sms_status và sms_cancel với chúng; status, cancel và allowcancel chỉ dành cho đơn sản phẩm và đơn SMM.

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

Phản hồi Lỗi

Các phản hồi lỗi phổ biến bạn có thể gặp phải.