Kết nối website đại lý, mua tài khoản tự động
Lấy danh sách sản phẩm, mua hàng bằng số dư ví và nhận tài khoản ngay trong phản hồi JSON. Dùng API v1 cho tích hợp mới, hoặc API tương thích SHOPCLONE7 để website SHOPCLONE6/7 chỉ cần đổi domain và API Key.
- Base URL
- /api/v1
- Định dạng
- JSON · UTF-8
- Xác thực
- 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}'Xác thực
Gửi API Key trong header Authorization: Bearer <API Key> (hoặc X-API-Key). Không đặt khoá trong URL; nếu khoá bị lộ, hãy đổi khoá mới ngay.
/api/v1/meThông tin tài khoản
Thông tin tài khoản, số dư ví và giới hạn tần suất mua.
Request
https://your-domain/api/v1/meTham số
AuthorizationBắt buộcMã mẫu
curl "https://your-domain/api/v1/me" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"success": true,
"data": {
"username": "daily01",
"email": "daily01@example.com",
"balance": 1250000,
"currency": "VND",
"limits": { "buy_interval_seconds": 3, "max_wait_seconds": 25 }
}
}/api/v1/categoriesDanh sách danh mục
Danh mục đang bán kèm số sản phẩm (tính cả danh mục con).
Request
https://your-domain/api/v1/categoriesTham số
AuthorizationBắt buộclangTuỳ chọnMã mẫu
curl "https://your-domain/api/v1/categories" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"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 }
]
}/api/v1/productsDanh sách sản phẩm
Danh sách sản phẩm có lọc và phân trang; giá là giá riêng của bạn.
Request
https://your-domain/api/v1/products?category_id=1&in_stock=1&page=1&limit=50Tham số
AuthorizationBắt buộccategory_idTuỳ chọnsearchTuỳ chọnin_stockTuỳ chọnpageTuỳ chọnlimitTuỳ chọnlangTuỳ chọnMã mẫu
curl "https://your-domain/api/v1/products?category_id=1&in_stock=1&page=1&limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"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 }
}/api/v1/products/{id}Chi tiết sản phẩm
Chi tiết một sản phẩm theo ID.
Request
https://your-domain/api/v1/products/3Tham số
AuthorizationBắt buộcidBắt buộclangTuỳ chọnMã mẫu
curl "https://your-domain/api/v1/products/3" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"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"
}
}/api/v1/ordersTạo đơn hàng (mua)
Mua bằng số dư ví và nhận tài khoản ngay trong phản hồi. Hỗ trợ Idempotency-Key để thử lại an toàn, không bị mua trùng.
Request
https://your-domain/api/v1/ordersTham số
AuthorizationBắt buộcIdempotency-KeyTuỳ chọnproduct_idBắt buộcquantityBắt buộccouponTuỳ chọnwaitTuỳ chọnMã mẫu
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}'Phản hồi mẫu
{
"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"
]
}
}/api/v1/ordersLịch sử đơn hàng
Lịch sử đơn hàng (mới nhất trước), không kèm tài khoản.
Request
https://your-domain/api/v1/orders?status=completed&page=1Tham số
AuthorizationBắt buộcstatusTuỳ chọnsourceTuỳ chọnpageTuỳ chọnlimitTuỳ chọnMã mẫu
curl "https://your-domain/api/v1/orders?status=completed&page=1" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"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 }
}/api/v1/orders/{code}Chi tiết đơn hàng
Chi tiết đơn kèm danh sách tài khoản đã giao.
Request
https://your-domain/api/v1/orders/STC261028TAKE49XDTham số
AuthorizationBắt buộccodeBắt buộcMã mẫu
curl "https://your-domain/api/v1/orders/STC261028TAKE49XD" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"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"
]
}
}Mã lỗi
Khi lỗi, success = false; error.code là mã cố định để code của bạn xử lý, error.message là thông báo cho người đọc, kèm request_id để gửi hỗ trợ.
{
"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_request400invalid_quantity400out_of_stock401missing_api_key401invalid_api_key402insufficient_balance403ip_not_allowed404product_not_found404order_not_found409idempotency_conflict429rate_limited503api_disabled503order_refundedLưu ý khi tích hợp
- Gửi Idempotency-Key cho mỗi lần mua để có thể thử lại an toàn khi mạng lỗi hoặc hết thời gian chờ.
- Đơn có status = processing khi chưa giao đủ — gọi GET /v1/orders/{code} để lấy phần còn lại.
- Mỗi khoá cần cách nhau tối thiểu 3 giây giữa 2 lần mua.
- Giá trả về là giá riêng của bạn (đã tính cấp bậc, Flash Sale), đơn vị VND.
- Mọi phản hồi có header X-Request-Id; gửi kèm mã này khi cần hỗ trợ.
- Chỉ sản phẩm giao tự động mới bán được qua API.