Tài liệu tích hợp API

1. Thông tin API của bạn

2. Tổng quan tích hợp

Hệ thống cung cấp 3 API chính để đối tác tích hợp vào website của mình:

• Tạo đơn hàng: dùng khi người dùng bên website đối tác bấm mua tool.
• Kiểm tra đơn hàng: dùng để đồng bộ trạng thái đơn, hạn dùng, key đã kích hoạt.
• Kích hoạt key: dùng khi người dùng nhập key máy hoặc key thiết bị.

3. Cần chuẩn bị gì trước khi tích hợp

3.1. Thông tin cần có

3.2. Website đối tác cần có gì

• Trang danh sách tool hoặc nút mua tool.
• Database nội bộ để lưu đơn hàng.
• Trang lịch sử đơn hàng cho user.
• Form nhập key để active sau khi mua.

4. Luồng tích hợp dễ hiểu nhất

5. Danh sách tool

6. API tạo đơn hàng

$url = "https://www.k316mmotools.online/api/order.php";

$data = [
    'token'        => 'TOKEN_CUA_BAN',
    'website'      => 'domaincuaban.com',
    'product_type' => 'tool',
    'buy_type'     => 'vinh_vien',
    'bithen'       => '49724c098838fe6ba4326be9c5371e81'
];

$options = [
    'http' => [
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($data),
        'timeout' => 30
    ]
];

$context  = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result   = json_decode($response, true);

print_r($result);

curl -X POST "https://www.k316mmotools.online/api/order.php" \
-d "token=TOKEN_CUA_BAN" \
-d "website=domaincuaban.com" \
-d "product_type=tool" \
-d "buy_type=vinh_vien" \
-d "bithen=49724c098838fe6ba4326be9c5371e81"

fetch("https://www.k316mmotools.online/api/order.php", {
    method: "POST",
    headers: {
        "Content-Type": "application/x-www-form-urlencoded"
    },
    body: new URLSearchParams({
        token: "TOKEN_CUA_BAN",
        website: "domaincuaban.com",
        product_type: "tool",
        buy_type: "vinh_vien",
        bithen: "49724c098838fe6ba4326be9c5371e81"
    })
})
.then(res => res.json())
.then(data => console.log(data));

{
  "status":"success",
  "msg":"Tạo đơn hàng thành công",
  "transaction_code":"ABC123XYZ",
  "buy_type":"vinh_vien",
  "product_type":"tool",
  "payment":{
    "discount":0,
    "total":2000000,
    "voucher":""
  },
  "user":{
    "username":"USERNAME_MAP",
    "balance_before":2000000,
    "balance_after":0
  },
  "time_buy":1775328965,
  "time_expired":2639242565
}

7. API kiểm tra đơn hàng

https://www.k316mmotools.online/api/check_order.php?token=TOKEN_CUA_BAN&website=domaincuaban.com&transaction_code=ABC123XYZ

{
  "status":"success",
  "msg":"Lấy thông tin đơn hàng thành công",
  "transaction_code":"ABC123XYZ",
  "status_order":"active",
  "user":{
    "username":"USERNAME_MAP",
    "balance_current":0
  },
  "tool":{
    "code":"49724c098838fe6ba4326be9c5371e81",
    "title":"TEN_TOOL"
  },
  "key_active":"USER-KEY-123",
  "time_rent":9999,
  "time_buy":1775328965,
  "time_expired":2639242565
}

8. API kích hoạt key

$url = "https://www.k316mmotools.online/api/active_key.php";

$data = [
    'token'            => 'TOKEN_CUA_BAN',
    'website'          => 'domaincuaban.com',
    'transaction_code' => 'ABC123XYZ',
    'key'              => 'USER-KEY-123'
];

$options = [
    'http' => [
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($data),
        'timeout' => 30
    ]
];

$context  = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result   = json_decode($response, true);

print_r($result);

curl -X POST "https://www.k316mmotools.online/api/active_key.php" \
-d "token=TOKEN_CUA_BAN" \
-d "website=domaincuaban.com" \
-d "transaction_code=ABC123XYZ" \
-d "key=USER-KEY-123"

{
  "status":"success",
  "msg":"Kích hoạt key thành công",
  "transaction_code":"ABC123XYZ",
  "user":{
    "username":"USERNAME_MAP"
  },
  "key_active":"USER-KEY-123"
}

9. Database gợi ý bên website đối tác

Website đối tác nên có bảng riêng để lưu đơn nội bộ.

CREATE TABLE api_orders (
    id INT AUTO_INCREMENT PRIMARY KEY,
    user_id INT NOT NULL,
    tool_code VARCHAR(255) NOT NULL,
    transaction_code VARCHAR(255) NOT NULL,
    buy_type VARCHAR(50) NOT NULL,
    key_active TEXT,
    status VARCHAR(50) DEFAULT 'created',
    created_at INT NOT NULL
);

• user_id: user bên website đối tác
• tool_code: mã tool đã mua
• transaction_code: mã giao dịch từ hệ thống
• buy_type: vĩnh viễn hay thuê
• key_active: key đã active
• status: trạng thái nội bộ

10. Quy trình tích hợp thực tế

10.1. Khi người dùng mua tool

1. Người dùng bấm nút mua trên website đối tác.
2. Website đối tác lấy đúng tool code của sản phẩm đó.
3. Gọi API order.php.
4. Nếu thành công, lưu transaction_code.
5. Hiển thị “mua thành công”.

10.2. Khi người dùng xem lịch sử đơn

1. Lấy các đơn đã lưu trong database nội bộ.
2. Dùng transaction_code gọi check_order.php.
3. Hiển thị trạng thái, hạn dùng, key đã active.

10.3. Khi người dùng nhập key máy

1. Người dùng nhập key trên website đối tác.
2. Lấy transaction_code của đơn đó.
3. Gọi API active_key.php.
4. Nếu thành công, lưu lại key vào database nội bộ.

11. Lỗi thường gặp

12. Checklist trước khi chạy thật

• Đã có token
• Đã có website đúng domain
• Đã có danh sách tool code
• Website đối tác đã lưu được transaction_code
• Đã test tạo đơn thành công
• Đã test check đơn thành công
• Đã test active key thành công
• Đã có trang lịch sử đơn cho user