Tài Liệu API Mua Hàng & Dịch Vụ (REST API v1)
Dành Cho Mọi Thành Viên & Đại Lý
Khóa Bảo Mật API Key Của Bạn
Chưa Đăng Nhập
Hãy đăng nhập tài khoản để nhận mã
api_key riêng và mua hàng tự động qua API.
Cơ chế xác thực & Bảo mật API:
- Truyền
api_keyqua tham số GET/POST, JSON Body hoặc HeaderX-API-Key: hk_live_YOUR_SECRET_API_KEY. - Hệ thống tự động khóa giao dịch nguyên tử (Atomic Lock) chống trừ tiền trùng khi bắn đa luồng.
- Giới hạn bảo vệ chống spam: Tối đa 60 requests / phút / IP.
Chạy Thử API Trực Tiếp (Live Playground)
Kết quả JSON trả về:
Sẵn sàng
{
"hint": "Nhấn nút Gửi Request phía trên để xem phản hồi thực tế từ /api/v1.php"
}
POST / GET
1. API Mua Tài Khoản Tự Động (
action=buy_account)
Trừ tiền tự động trong ví thành viên và trả về ngay lập tức Tài khoản, Mật khẩu và Thông tin đi kèm / 2FA của acc vừa mua.
| Tham Số | Kiểu | Bắt Buộc | Mô Tả Chi Tiết |
|---|---|---|---|
action |
string | Có | Giá trị cố định: buy_account |
api_key |
string | Có | API Key riêng của bạn (Hoặc truyền qua Header X-API-Key) |
account_code hoặc account_id |
string / int | Có (1 trong 2) | Mã số tài khoản (VD: KT1001) hoặc ID số nguyên lấy từ action=accounts |
Ví dụ gọi bằng PHP (cURL) / Command Line:
curl -X POST "https://ndzstore.site/api/v1.php" \ -H "X-API-Key: hk_live_YOUR_SECRET_API_KEY" \ -d "action=buy_account" \ -d "account_code=KT1001"
Phản hồi JSON khi mua thành công:
{
"status": "success",
"message": "Mua tài khoản #KT1001 thành công!",
"order": {
"order_code": "ACC261118A1B2C",
"account_id": 1,
"account_code": "KT1001",
"price": 85000,
"credentials": {
"username": "hellokitty_rbx01",
"password": "KittyPass@2026",
"extra": "Trắng mail - Đổi mật khẩu ngay"
}
},
"new_balance": 65000
}
POST / GET
2. API Đặt Đơn Dịch Vụ (
action=order_service)
| Tham Số | Kiểu | Bắt Buộc | Mô Tả Chi Tiết |
|---|---|---|---|
action |
string | Có | Giá trị cố định: order_service |
api_key |
string | Có | API Key riêng của bạn |
service_id |
int | Có | ID gói dịch vụ (Lấy danh sách tại action=services) |
quantity |
int | Có | Số lượng cần đặt (Nằm trong khoảng min_qty đến max_qty) |
target_input |
string | Có | Link bài viết, UID Game hoặc Tên tài khoản cần thực hiện dịch vụ |
target_password / customer_note |
string | Tùy chọn | Mật khẩu cày thuê (nếu có) và ghi chú riêng cho Admin |
Ví dụ gọi đặt đơn dịch vụ:
curl -X POST "https://ndzstore.site/api/v1.php" \ -d "action=order_service" \ -d "api_key=hk_live_YOUR_SECRET_API_KEY" \ -d "service_id=1" \ -d "quantity=2" \ -d "target_input=kitty_roblox_vip"
Phản hồi JSON khi tạo đơn dịch vụ:
{
"status": "success",
"message": "Tạo đơn dịch vụ #SRV261118F99A1 thành công!",
"order": {
"order_code": "SRV261118F99A1",
"service_id": 1,
"quantity": 2,
"total_price": 50000,
"target_input": "kitty_roblox_vip",
"status": "pending"
},
"new_balance": 100000
}
GET / POST
3. Các Endpoint Tra Cứu Kho Hàng, Số Dư & Trạng Thái Đơn
| Action | Cần API Key | Tham Số Kèm Theo | Chức Năng |
|---|---|---|---|
action=profile |
Có | api_key |
Lấy số dư hiện tại, tổng nạp, cấp VIP và thông tin STK VietQR nạp tiền. |
action=categories |
Không | — | Lấy danh sách danh mục tài khoản và số lượng acc còn trong mỗi danh mục. |
action=accounts |
Không | category_id (Tùy chọn) |
Lấy danh sách các tài khoản lẻ đang có sẵn (available), mã số và giá bán. |
action=bulk_products |
Không | — | Lấy danh sách các gói Clone / Via / Mail bán theo số lượng và tồn kho thực tế (available_stock). |
action=buy_bulk |
Có | api_key, product_id, quantity |
Mua tự động N dòng tài khoản Clone / Via cùng lúc, trả về mảng accounts và chuỗi raw_text. |
action=services |
Không | — | Lấy danh sách các gói dịch vụ, đơn giá, số lượng tối thiểu / tối đa. |
action=order_status |
Có | api_key, order_code |
Kiểm tra chi tiết đơn tài khoản lẻ (ACC...), đơn Clone/Via (CLN...) hoặc đơn dịch vụ (SRV...). |