Trang chủ
Tài liệu api đổi thẻ cào, mua thẻ , nạp topup miễn phí

Tài liệu api đổi thẻ cào, mua thẻ , nạp topup miễn phí

Ngày đăng: 2026-07-01 16:40:58 Đã xem: 112

Tài liệu API Đổi Thẻ

API giúp đối tác gửi thẻ cào trực tiếp lên hệ thống Thenhanh1s để xử lý tự động 24/7.

1. Endpoint

POST http://{{domain_post}}/chargingws/v2

2. Headers

Key	Value
Content-Type	application/json
Authorization	Bearer API_KEY

3. Tham số gửi lên

Tham số	Kiểu	Bắt buộc	Mô tả
telco	String	Có	Nhà mạng
amount	Integer	Có	Mệnh giá
serial	String	Có	Serial thẻ
code	String	Có	Mã thẻ
request_id	String	Có	Mã đơn của đối tác

4. Ví dụ Request

{
    "telco":"VIETTEL",
    "amount":100000,
    "serial":"123456789012",
    "code":"12345678901234",
    "request_id":"DH10001"
}

5. Response thành công

{
    "status":200,
    "message":"Thành công",
    "trans_id":"TNH123456",
    "request_id":"DH10001"
}

6. Response lỗi

{
    "status":400,
    "message":"Sai serial"
}

7. Trạng thái giao dịch

Mã	Ý nghĩa
0	Đang xử lý
1	Thành công
2	Sai mệnh giá
3	Sai serial
4	Sai mã thẻ
5	Thẻ đã sử dụng
99	Lỗi hệ thống

8. Ví dụ PHP

$data = [
    "telco"=>"VIETTEL",
    "amount"=>100000,
    "serial"=>"123456789012",
    "code"=>"12345678901234",
    "request_id"=>"DH10001"
];

$ch = curl_init("https://thenhanh1s.com/chargingws/v2");

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer API_KEY",
    "Content-Type: application/json"
]);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$result = curl_exec($ch);

echo $result;

API Mua Thẻ

API dùng để mua thẻ điện thoại và thẻ game tự động từ hệ thống Thenhanh1s.

1. Endpoint

POST http://{{domain_post}}/api/cardws

2. Headers

Key	Value
Authorization	Bearer YOUR_API_KEY
Content-Type	application/json

3. Tham số

Tên	Kiểu	Bắt buộc	Mô tả
request_id	String	Có	Mã giao dịch của đối tác
telco	String	Có	Loại thẻ cần mua
amount	Integer	Có	Mệnh giá
quantity	Integer	Có	Số lượng thẻ

4. Ví dụ Request

{
    "request_id":"BUY001",
    "telco":"VIETTEL",
    "amount":100000,
    "quantity":2
}

5. Response

{
    "status":200,
    "message":"Mua thẻ thành công",
    "request_id":"BUY001",
    "cards":[
        {
            "serial":"123456789012",
            "code":"12345678901234",
            "amount":100000
        },
        {
            "serial":"123456789013",
            "code":"12345678901235",
            "amount":100000
        }
    ]
}

6. Danh sách nhà mạng

Nhà mạng	Giá trị
Viettel	VIETTEL
Vinaphone	VINAPHONE
Mobifone	MOBIFONE
Vietnamobile	VIETNAMOBILE
Gate	GATE
Garena	GARENA
Zing	ZING
Appota	APPOTA
Vcoin	VCOIN
Scoin	SCOIN

7. Mã lỗi

Code	Mô tả
200	Thành công
400	Thiếu tham số
401	API KEY không hợp lệ
402	Không đủ số dư
403	API bị khóa
404	Không tìm thấy giao dịch
405	Sai nhà mạng
406	Sai mệnh giá
407	Hết hàng
500	Lỗi hệ thống

API Nạp Topup

API Nạp Topup cho phép đối tác nạp tiền điện thoại tự động 24/7 cho tất cả các nhà mạng.

1. Endpoint

POST http://{{domain_post}}/api/rechargews

2. Headers

Key	Value
Authorization	Bearer YOUR_API_KEY
Content-Type	application/json

3. Tham số gửi lên

Tham số	Kiểu	Bắt buộc	Mô tả
request_id	String	Có	Mã giao dịch duy nhất
network	String	Có	Nhà mạng cần nạp
phone	String	Có	Số điện thoại nhận tiền
amount	Integer	Có	Mệnh giá cần nạp

4. Ví dụ Request

{
    "request_id":"TOPUP001",
    "network":"VIETTEL",
    "phone":"0987654321",
    "amount":100000
}

5. Response Thành Công

{
    "status":200,
    "message":"Nạp thành công",
    "request_id":"TOPUP001",
    "phone":"0987654321",
    "amount":100000,
    "transaction_id":"TNH123456"
}

6. Response Thất Bại

{
    "status":402,
    "message":"Không đủ số dư"
}

7. Nhà mạng hỗ trợ

Tên nhà mạng	Giá trị
Viettel	VIETTEL
Vinaphone	VINAPHONE
Mobifone	MOBIFONE
Vietnamobile	VIETNAMOBILE

8. Mệnh giá hỗ trợ

Mệnh giá
10.000 VNĐ
20.000 VNĐ
30.000 VNĐ
50.000 VNĐ
100.000 VNĐ
200.000 VNĐ
300.000 VNĐ
500.000 VNĐ

9. Mã lỗi

Code	Mô tả
200	Nạp thành công
400	Thiếu tham số
401	API KEY không hợp lệ
402	Không đủ số dư
403	API bị khóa
404	Số điện thoại không hợp lệ
405	Nhà mạng không hỗ trợ
406	Mệnh giá không hợp lệ
500	Lỗi hệ thống

10. Ví dụ PHP

$data = [
    "request_id" => "TOPUP001",
    "network"    => "VIETTEL",
    "phone"      => "0987654321",
    "amount"     => 100000
];

$ch = curl_init("https://thenhanh1s.com/api/rechargews");

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json"
]);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

echo curl_exec($ch);