Tài Liệu Kết Nối API
Tích hợp dịch vụ Gạch thẻ cào tự động và Tra cứu UID Facebook vào hệ thống, website hoặc bot của bạn
X-Api-Key: <YOUR_KEY>
3 Bước Tích Hợp Nhanh Luồng Gạch Thẻ
Lấy Bảng Giá & Chiết Khấu
Gọi GET /card-exchange?action=info để lấy danh sách nhà mạng, mệnh giá hỗ trợ và số dư ví của bạn.
Gửi Thẻ (Tạo Đơn Gạch)
Gửi mã thẻ, serial qua POST /card-exchange (action=create). Hệ thống trả về mã giao dịch trans_id.
Cộng Tiền & Tra Cứu
Thẻ đúng sẽ được tự động cộng tiền ngay vào ví. Tra cứu trạng thái đơn bất cứ lúc nào qua GET /card-exchange?action=get-order-detail.
/card-exchange
Tất cả thao tác gạch thẻ được thực hiện qua endpoint duy nhất, phân biệt hành động qua tham số action.
1. Lấy thông tin nhà mạng, mệnh giá & chiết khấu
?action=info
Trả về danh sách các nhà mạng đang mở, bảng chiết khấu chi tiết từng mệnh giá và số dư ví hiện tại của tài khoản.
{
"success": true,
"message": "Lấy thông tin API gạch thẻ thành công.",
"data": {
"status_enabled": true,
"balance": { "available": 1500000, "available_text": "1.500.000 VNĐ" },
"telcos": [
{ "value": "VIETTEL", "label": "Viettel" },
{ "value": "VINAPHONE", "label": "Vinaphone" },
{ "value": "MOBIFONE", "label": "Mobifone" }
],
"amount_options_by_telco": { "VIETTEL": [10000, 20000, 50000, 100000, 500000] },
"fee_schedule": [
{
"telco": "VIETTEL",
"value": 50000,
"estimated_receive": 40000,
"estimated_receive_text": "40.000 VNĐ"
}
]
}
}
2. Gửi thẻ (Tạo đơn gạch thẻ)
action: "create"
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| action | String | Bắt buộc | Giá trị cố định: "create" |
| telco | String | Bắt buộc | Mã nhà mạng (VD: VIETTEL, VINAPHONE, MOBIFONE, ZING, VCOIN) |
| amount | Number | Bắt buộc | Mệnh giá thẻ (VD: 10000, 20000, 50000, 100000) |
| serial | String | Bắt buộc | Số Serial in trên thẻ |
| code | String | Bắt buộc | Mã thẻ cào (Mã PIN) |
| note | String | Tùy chọn | Ghi chú riêng cho đơn (tối đa 255 ký tự) |
{
"success": true,
"message": "Đã gửi yêu cầu gạch thẻ. Vui lòng dùng trans_id để kiểm tra trạng thái.",
"data": {
"status": "PENDING",
"request": {
"trans_id": "CE1699999999999",
"telco": "VIETTEL",
"serial": "123456789012",
"amount": 50000,
"estimated_received": 40000,
"estimated_received_text": "40.000 VNĐ",
"status": "PENDING",
"status_label": "Đang chờ xử lý"
}
}
}
3. Tra cứu kết quả & Trạng thái đơn
?action=get-order-detail&trans_id=...
Tra Cứu UID Facebook (Public API)
Trích xuất nhanh UID hoặc Object ID từ đường dẫn Profile, Fanpage, Group, Bài viết, Video, Reel hoặc Short link Facebook.
{
"success": true,
"type": "profile",
"uid": "1000123456789",
"objectUid": "1000123456789",
"inputUrl": "https://www.facebook.com/zuck",
"confidence": "high",
"message": "Đã lấy UID từ URL thành công."
}
type: Loại liên kết nhận diện (profile,page,group,post,video,reel).uid: UID của chủ sở hữu trang / profile / group.objectUid: ID riêng của đối tượng bài viết / video / ảnh.confidence: Độ tin cậy (high,medium,low).