Adswar

Dành cho đại lý

Tài liệu API mua hàng

API tương thích SHOPCLONE7: website SHOPCLONE6/7 của bạn chỉ cần thêm nhà cung cấp loại SHOPCLONE7 với domain và API Key của bạn — không cần sửa code.

Lấy API Key
Domainhttps://beta.adswar.shop
  1. 1

    Lấy API Key

    Đăng nhập, vào Tài khoản › API mua hàng để tạo khoá và khai báo IP máy chủ website của bạn.

  2. 2

    Kết nối website

    Ở trang quản trị website của bạn, thêm nhà cung cấp loại SHOPCLONE7 với domain bên trên và API Key vừa tạo.

  3. 3

    Đồng bộ và bán hàng

    Đồng bộ danh sách sản phẩm, đặt giá bán; đơn của khách sẽ tự mua hàng bằng số dư ví của bạn.

Xác thực

Mọi request gửi kèm tham số api_key trên query string; riêng lệnh mua gửi dạng form POST (multipart hoặc urlencoded).

curl -X POST "https://beta.adswar.shop/api/buy_product" \
  -F action=buyProduct -F api_key=YOUR_API_KEY -F id=12 -F amount=1
GET/api/profile.php

Thông tin tài khoản và số dư ví

Tham số

api_keyBắt buộcAPI Key của bạn

Phản hồi mẫu

{
  "status": "success",
  "msg": "Data retrieved successfully!",
  "data": { "username": "reseller01", "money": "1250.5" }
}
GET/api/products.php

Danh mục và sản phẩm (giá theo cấp bậc của bạn)

Tham số

api_keyBắt buộcAPI Key của bạn
langTuỳ chọnNgôn ngữ tên sản phẩm: th, en, vi

Phản hồi mẫu

{
  "status": "success",
  "msg": "Data retrieved successfully!",
  "categories": [
    {
      "id": "1", "parent_id": 0, "name": "Facebook", "icon": "https://.../facebook.png",
      "products": [
        { "id": "12", "name": "Facebook US | 2FA", "price": "35", "amount": 80,
          "description": "...", "flag": "us", "min": "1", "max": "500" }
      ]
    }
  ]
}
GET/api/product.php

Thông tin một sản phẩm

Tham số

api_keyBắt buộcAPI Key của bạn
productBắt buộcID sản phẩm

Phản hồi mẫu

{
  "status": "success",
  "msg": "Data retrieved successfully!",
  "product": [
    { "id": "12", "name": "Facebook US | 2FA", "price": "35", "amount": 80,
      "description": "...", "flag": "us", "min": 1, "max": 500 }
  ]
}
POST/api/buy_product

Mua hàng: action=buyProduct, api_key, id, amount, coupon (tuỳ chọn)

Tham số

actionBắt buộcLuôn là buyProduct
api_keyBắt buộcAPI Key của bạn
idBắt buộcID sản phẩm cần mua
amountBắt buộcSố lượng mua (trong khoảng min – max của sản phẩm)
couponTuỳ chọnMã giảm giá

Phản hồi mẫu

{
  "status": "success",
  "msg": "Order created successfully!",
  "trans_id": "AW261012A6YQJM7H",
  "data": ["uid|password|2fa", "uid|password|2fa"]
}
GET/api/order.php

Lấy lại tài khoản của đơn hàng

Tham số

api_keyBắt buộcAPI Key của bạn
orderBắt buộcMã đơn hàng (trans_id) nhận được khi mua

Phản hồi mẫu

{
  "status": "success",
  "msg": "Order retrieved successfully!",
  "trans_id": "AW261012A6YQJM7H",
  "data": ["uid|password|2fa", "uid|password|2fa"]
}

Mã lỗi

Khi lỗi, API trả status = "error" và câu thông báo msg kèm mã HTTP:

{ "status": "error", "msg": "..." }
  • 400Thiếu tham số, ID hoặc số lượng không hợp lệ, không đủ hàng
  • 401API Key sai hoặc tài khoản bị khoá
  • 402Số dư ví không đủ
  • 403IP không nằm trong danh sách được phép (kèm client_ip)
  • 404Sản phẩm hoặc đơn hàng không tồn tại
  • 429Thao tác quá nhanh, vui lòng chờ
  • 503API tạm tắt hoặc kho hàng lỗi (đơn đã được hoàn tiền)

Lưu ý

  • Giá trả về là giá riêng theo cấp bậc của bạn, tính bằng tiền tệ gốc của cửa hàng.
  • Đơn được thanh toán bằng số dư ví — nạp tiền trước ở trang Nạp tiền.
  • Hai lần mua của cùng một khoá phải cách nhau vài giây.
  • Nếu tài khoản chưa giao kịp, lệnh mua vẫn trả trans_id — gọi order.php để lấy lại sau.