API dành cho reseller sử dụng các dịch vụ công khai, số dư và lịch sử đơn của bot.
Base URL: /api/v1
Gửi X-API-Key trong mọi request. Quyền API phải được admin kích hoạt thủ công trước khi sử dụng. Chỉ dùng HTTPS; không đặt key trong URL, frontend công khai hoặc log.
curl -H "X-API-Key: YOUR_BOT_API_KEY" https://YOUR_DOMAIN/api/v1/me
{
"ok": true,
"code": "SUCCESS"
}{
"ok": false,
"code": "INSUFFICIENT_BALANCE",
"error": "Insufficient balance."
}Dùng một clientOrderId/shopOrderId duy nhất cho mỗi đơn và dùng lại mã đó khi gửi lại request tạo đơn. Cùng mã nhưng payload khác trả 409 IDEMPOTENCY_CONFLICT.
| Method | Endpoint | Description |
|---|---|---|
| GET | /me | Hồ sơ, tier, số dư Point và referral |
| GET | /balance | Số dư Point chuẩn và quy đổi hiển thị |
| GET | /purchases?limit=50 | Lịch sử mua trong bot |
| GET | /deposits?limit=50 | Lịch sử nạp tiền |
| GET | /referrals | Thống kê referral |
{
"ok": true,
"success": true,
"code": "SUCCESS",
"shopId": "TG123",
"wallet": {
"point": 1.5,
"usd": 1.5,
"vnd": 39000,
"credit": 2
}
}Point là đơn vị ví duy nhất: 1 Point = 1 USD = 26.000 VND. Telegram Stars chỉ dùng để nạp Point trong bot; wallet.usd và wallet.vnd chỉ là giá trị quy đổi hiển thị.
| Method | Endpoint | Description |
|---|---|---|
| GET | /products?page=1&limit=50 | Sản phẩm, giá và tồn kho |
| POST | /orders | Mua bằng productId hoặc code |
| POST | /products/{id}/buy | Mua theo ID |
| GET | /orders?limit=50 | Danh sách đơn Shop API |
| GET | /orders/{orderCode} | Chi tiết đơn |
POST /orders
{
"productId": 123,
"qty": 1,
"currency": "point",
"shopOrderId": "shop-001"
}{
"ok": true,
"order": {
"orderCode": "ORDER123",
"shopOrderId": "shop-001",
"qty": 1,
"total": 1.5,
"currency": "point",
"status": "completed",
"accounts": [
"delivered-content"
]
}
}
| Method | Endpoint | Description |
|---|---|---|
| GET | /sheerid/service_info | Giá và trạng thái |
| POST | /sheerid/verify | Tạo xác minh bằng URL SheerID |
| GET | /sheerid/jobs | Danh sách job |
| GET | /sheerid/jobs/{job_id} | Tiến độ và kết quả |
POST /sheerid/verify
{
"sheerid_url": "https://services.sheerid.com/verify/...",
"client_order_id": "student-001",
"discount_code": "API5"
}{
"job": {
"job_id": "SJ123",
"client_order_id": "student-001",
"status": "pending",
"progress": 0,
"result_link": null
}
}
| Method | Endpoint | Description |
|---|---|---|
| GET | /xiaomi3/services | Giá và trạng thái Xiaomi Full |
| POST | /xiaomi3/orders | Tạo batch 1–200 tài khoản |
| GET | /xiaomi3/orders | Danh sách đơn |
| GET | /xiaomi3/orders/{id} | Chi tiết/kết quả |
Xiaomi Full là chế độ duy nhất. Mỗi tài khoản được tạo thành một đơn riêng để theo dõi và hoàn tiền độc lập. Mặc định, bậc giá reseller được tính theo tổng số dư ví quy đổi: từ 30 USD giảm 5%, từ 60 USD giảm 10%. Nếu reseller được admin đặt giá riêng thì giá cứng đó được ưu tiên và không áp dụng bậc giảm. Giá được khóa tại thời điểm tạo đơn.
Đọc trạng thái mở bán, giá gốc, giá thực trả và bậc giảm hiện tại trước khi tạo đơn. customPrice=true nghĩa là tài khoản API đang dùng giá cứng riêng.
{
"ok": true,
"pricingTiers": [
{
"minimumUsd": 0,
"discountPercent": 0
},
{
"minimumUsd": 30,
"discountPercent": 5
},
{
"minimumUsd": 60,
"discountPercent": 10
}
],
"services": [
{
"taskType": "default",
"name": "Xiaomi Full",
"basePriceUsd": 2,
"basePriceVnd": 50000,
"priceUsd": 1.7,
"priceVnd": 43000,
"discountPercent": 0,
"customPrice": true,
"walletEquivalentUsd": 35,
"enabled": true
}
]
}
| Trường | Kiểu | Yêu cầu / Ý nghĩa |
|---|---|---|
taskType | string | Bắt buộc: chỉ nhận default. |
currency | string | Khuyến nghị: point. Legacy usd/vnd vẫn được nhận và đổi sang Point. |
clientOrderId | string | Bắt buộc, 8–80 ký tự: chữ, số, dấu gạch dưới hoặc gạch ngang. Dùng lại chính mã này khi request bị timeout. |
accounts | string[] | Bắt buộc 1–200 dòng. Mỗi dòng dùng 2FA Base32 đúng 32 ký tự hoặc một mã dự phòng 8 số. |
POST /xiaomi3/orders
Content-Type: application/json
X-API-Key: YOUR_BOT_API_KEY
{"taskType":"default","currency":"point","clientOrderId":"xiaomi-001","accounts":["email@gmail.com|password|12345678","second@gmail.com|password|JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP"]}
Request mới trả HTTP 202. Gửi lại cùng clientOrderId và cùng payload trả HTTP 200 với duplicated=true, không trừ tiền lần hai. Cùng clientOrderId nhưng đổi tài khoản hoặc currency trả HTTP 409 IDEMPOTENCY_CONFLICT.
{
"ok": true,
"duplicated": false,
"orders": [
{
"id": 812,
"clientOrderId": "xiaomi-001",
"email": "email@gmail.com",
"taskType": "default",
"status": "pending",
"amount": 47500,
"currency": "vnd",
"resultLink": null,
"errorCode": null,
"errorEn": null,
"createdAt": "2026-11-16 10:20:00",
"updatedAt": "2026-11-16 10:20:01"
}
]
}
Trả tối đa 50 đơn gần nhất của API key hiện tại, mới nhất trước. Một batch nhiều tài khoản xuất hiện thành nhiều đơn có cùng clientOrderId.
{
"ok": true,
"orders": [
{
"id": 812,
"clientOrderId": "xiaomi-001",
"email": "email@gmail.com",
"taskType": "default",
"status": "running",
"amount": 47500,
"currency": "vnd",
"resultLink": null,
"errorCode": null,
"errorEn": null,
"createdAt": "2026-11-16 10:20:00",
"updatedAt": "2026-11-16 10:21:10"
}
]
}
Tra cứu một đơn thuộc API key hiện tại. Thành công trả resultLink khi có; thất bại trả errorCode và errorEn đã chuẩn hóa, đồng thời số tiền của riêng đơn đó được hoàn tự động.
{
"ok": true,
"order": {
"id": 812,
"clientOrderId": "xiaomi-001",
"email": "email@gmail.com",
"taskType": "default",
"status": "success",
"amount": 47500,
"currency": "vnd",
"resultLink": "https://one.google.com/...",
"errorCode": null,
"errorEn": null,
"createdAt": "2026-11-16 10:20:00",
"updatedAt": "2026-11-16 10:23:00"
}
}{
"ok": true,
"order": {
"id": 813,
"clientOrderId": "xiaomi-001",
"email": "second@gmail.com",
"taskType": "default",
"status": "failed",
"amount": 47500,
"currency": "vnd",
"resultLink": null,
"errorCode": "wrong_password",
"errorEn": "Incorrect password.",
"createdAt": "2026-11-16 10:20:00",
"updatedAt": "2026-11-16 10:22:00"
}
}
Trường đơn:
| Trường | Kiểu | Yêu cầu / Ý nghĩa |
|---|---|---|
id | integer | ID đơn dùng cho endpoint chi tiết. |
clientOrderId | string | ID idempotency do reseller cung cấp. |
email | string | Tài khoản của đơn; mật khẩu/2FA không được trả lại. |
status | string | submitting | pending | running | success | failed | cancelled |
amount | number | Số Point đã khóa cho riêng đơn. |
currency | string | point |
resultLink | string|null | Link kết quả khi hoàn tất và có link. |
errorCode | string|null | Mã lỗi ổn định để xử lý bằng code. |
errorEn | string|null | Thông báo lỗi tiếng Anh an toàn cho khách. |
createdAt / updatedAt | string | Thời gian tạo và cập nhật gần nhất. |
Kiểm tra trạng thái mỗi 5–10 giây. Dừng khi success, failed hoặc cancelled. Nếu hệ thống không trả về mã tác vụ hợp lệ, đơn thất bại và được hoàn ví tự động.
submitting → pending → running → successfailed, cancelled
| Method | Endpoint | Description |
|---|---|---|
| 400 | INVALID_TASK_TYPE / INVALID_CURRENCY / INVALID_CLIENT_ORDER_ID / INVALID_ACCOUNTS / INVALID_ORDER_ID | Request không hợp lệ |
| 401 | MISSING_API_KEY / INVALID_API_KEY | Lỗi xác thực |
| 402 | INSUFFICIENT_BALANCE / INSUFFICIENT_CREDIT | Không đủ số dư |
| 403 | API_NOT_UNLOCKED / SERVICE_DISABLED | Admin chưa mở quyền hoặc dịch vụ đang tắt |
| 404 | ORDER_NOT_FOUND / INVALID_PRODUCT | Không tìm thấy |
| 409 | IDEMPOTENCY_CONFLICT | Cùng ID nhưng payload khác |
| 410 | XIAOMI_LINK_DISABLED | Chế độ Link không tồn tại |
| 500 | INTERNAL_ERROR | Lỗi nội bộ tạm thời; gửi lại cùng clientOrderId |
| 503 | SERVICE_UNAVAILABLE / PRICE_UNAVAILABLE | Tạm thời không khả dụng |
API không trả lại mật khẩu, khóa 2FA hay mã tác vụ nội bộ. Không ghi credentials vào log và không chia sẻ X-API-Key.
GET /api/v1/openapi.json