Tài liệu API
Đặt đơn tự động từ tool / website của bạn — giá đại lý, trừ thẳng số dư ví.
Bắt đầu
Địa chỉ gốc: https://thapkychungsuc.com/api
Mọi request gửi header X-API-Key: <khoá của bạn> và Content-Type: application/json. Lỗi trả HTTP 4xx kèm { "message": "…" }. Giới hạn 300 request / phút / IP.
curl -X POST https://thapkychungsuc.com/api/reseller/orders \
-H "X-API-Key: cmsnt_xxxxxxxx" -H "Content-Type: application/json" \
-d '{"package_id":"<package_id>","quantity":1,"codes":["ABCD1234"],"reference":"don-001"}'GET/reseller/balance— Xem số dư ví
{ "balance": 182000, "currency": "VND" }GET/reseller/services— Danh sách dịch vụ & gói (giá đại lý)
[{ "id": "…", "name": "Sự kiện Chung Sức Liên Quân", "inputLabel": "Mã mời (Friend Code)",
"packages": [{ "id": "<package_id>", "name": "38 VÉ NHẢY", "price": 6000, "retailPrice": 6000,
"units": 38, "unitLabel": "bước nhảy", "minQty": 1, "maxQty": 100 }] }]POST/reseller/orders— Tạo đơn (trừ số dư ví)
{
"package_id": "<package_id>",
"quantity": 1, // số gói cho MỖI mã
"codes": ["ABCD1234", "EFGH5678"], // hoặc chuỗi nhiều dòng; gửi link mời ?code=... cũng được
"reference": "don-cua-ban-001", // nên gửi: chống tạo trùng khi rớt mạng
"note": "tuỳ chọn"
}{ "code": "DV7K3M2Q", "status": "PENDING", "total": 12000, "existed": false,
"items": [{ "input": "ABCD1234", "quantity": 1, "done": 0, "status": "PENDING" }, …] }Gửi lại cùng reference sẽ trả lại đơn cũ với "existed": true và không trừ tiền lần hai. Tổng tiền = giá × quantity × số mã.
GET/reseller/orders/{code}— Chi tiết + tiến độ đơn
{ "code": "DV7K3M2Q", "status": "PROCESSING", "progressDone": 1, "progressTotal": 2,
"queue": { "ahead": 3, "etaSeconds": 120 }, "refundedAmount": 0,
"items": [{ "input": "ABCD1234", "done": 1, "quantity": 1, "status": "DONE" }, …] }GET/reseller/orders?status=&reference=&page=1&limit=20— Danh sách đơn (lọc theo trạng thái / reference)
{ "data": [ …đơn… ], "meta": { "page": 1, "limit": 20, "total": 35, "totalPages": 2 } }Trạng thái đơn
- PENDING
- Đã thanh toán, chờ gửi xử lý
- PROCESSING
- Đang chạy
- COMPLETED
- Hoàn thành
- PARTIAL
- Xong một phần — mã lỗi đã hoàn tiền vào ví
- FAILED
- Lỗi, shop đang kiểm tra
- REFUNDED
- Đã hoàn toàn bộ tiền
Trạng thái từng mã: PENDING (chờ), RUNNING (đang chạy), DONE (xong), ERROR (lỗi), SKIPPED (bỏ qua). Nên hỏi lại chi tiết đơn mỗi 30–60 giây.
Mã gói hiện có
| 38 VÉ NHẢY | ef5ad1eb-e47f-41de-a5ea-cb5697e041c5 |
| 150 VÉ NHẢY — Rương skin SS | aa3b6342-5b86-4278-9840-15d02073cddc |
| 340 VÉ NHẢY — Full 3 rương | 78ccba32-293c-40ba-88ba-a69105559ba5 |