MaxSocial.Vn - Tài liệu & Cổng Kết Nối API V2 Dành Cho Đại Lý

API GATEWAY V2 RESTFUL

Cổng Kết Nối API & Nguồn Hàng Tự Động

Cổng API tốc độ cao, hỗ trợ đấu nối tự động 100% cho Tài Khoản Bản Quyền (CapCut, ChatGPT, Canva...) và Dịch Vụ Mạng Xã Hội (SMM).

Quy Trình Nhanh API Sản Phẩm Bảng Mã Lỗi

Endpoint API URL	https://maxsocial.vn/api/v2
API Key Của Bạn	Vui lòng đăng nhập để lấy API Token!
Phương Thức (Method)	POST GET (Khuyến nghị luôn dùng POST để bảo mật API Key)
Content-Type	application/x-www-form-urlencoded \| multipart/form-data
Định dạng trả về	JSON (UTF-8)

Quy Trình Tích Hợp Nguồn Hàng Dành Cho Đại Lý

Chào mừng bạn đến với hệ thống phân phối tự động của Maxsocial. Bạn có thể kéo toàn bộ danh mục tài khoản số (Canva Pro, ChatGPT Plus, CapCut Pro, Netflix, Key phần mềm...) và dịch vụ MXH về bán trên website riêng của mình để nhận lợi nhuận chênh lệch mà không cần vốn ôm hàng lớn.

Lấy API Key & Nạp Quỹ Đại Lý

Đăng ký tài khoản, sao chép API Key ở bảng phía trên. Nạp tiền vào tài khoản để hệ thống có số dư trừ tiền tự động mỗi khi website của bạn có khách đặt mua hàng.

Lấy Bảng Giá & ID Gói Sản Phẩm

Gọi API action=products để lấy toàn bộ danh mục gói, giá gốc và ID sản phẩm (Canva, ChatGPT, CapCut...). Đăng tải lên web bạn và cấu hình giá bán lẻ (hưởng chênh lệch).

Bắn Đơn Tự Động Khi Khách Mua

Khi có đơn hàng trên website bạn, hệ thống của bạn tự động gửi request action=buy_product sang web chúng tôi. Chúng tôi trừ tiền đại lý và bàn giao thông tin tài khoản ngay lập tức 24/7.

Đồng Bộ Kho & Cảnh Báo Số Dư

Cài đặt tự động gọi action=product_stock để tự động ẩn gói nếu hết hàng, và gọi action=balance để nhận thông báo nạp thêm tiền khi ví đại lý sắp cạn.

Lưu ý bảo mật cho Đại Lý

Tuyệt đối giữ bí mật chuỗi API Key của bạn. Không để lộ API Key trong mã nguồn JavaScript phía Frontend. Nếu phát hiện nghi ngờ lộ Key, hãy bấm nút [Đổi Key Mới] ở trên ngay lập tức.

Hướng Dẫn Đấu Nối Sản Phẩm

Dành cho các website đại lý / website con muốn kết nối tự động kéo kho tài khoản số về bán trực tiếp:

Các bước cấu hình kết nối trong Admin website của bạn:

Đăng nhập trang Quản trị Admin website của bạn → Vào mục Quản lý sản phẩm → Cấu hình kết nối nguồn / API Provider.
Nhập Domain API: https://maxsocial.vn
Nhập API Key: Dán mã API Token của bạn (lấy tại bảng trên).
Bấm Tải danh sách sản phẩm: Hệ thống web bạn sẽ tự động quét toàn bộ danh mục sản phẩm đang mở bán trên website của chúng tôi (Canva Pro, ChatGPT Plus, CapCut Pro, Netflix, Spotify, Windows, v.v.).
Chọn các sản phẩm muốn nhập về bán, đặt tên hiển thị trên web bạn và cấu hình % lợi nhuận mong muốn (ví dụ: giá gốc 80.000đ, đặt lãi 25% → tự động bán giá 100.000đ).
Bật tính năng Tự động đồng bộ tồn kho (Cron Job) để web bạn tự động cập nhật số lượng tồn kho thực tế, ẩn gói khi hết hàng và cập nhật giá vốn tức thì.

Định dạng bàn giao dữ liệu sản phẩm (Account Delivery)

Bảng Mã Lỗi & Cách Khắc Phục

Tất cả phản hồi lỗi từ API đều trả về định dạng JSON chuẩn: {"error": "Tên_Lỗi"} hoặc {"status": "error", "message": "Thông_Báo"}:

Mã lỗi (Error String)	Ý nghĩa & Nguyên nhân	Cách khắc phục
`Incorrect request`	Thiếu tham số bắt buộc hoặc tên `action` không hợp lệ.	Kiểm tra lại tên action và các trường dữ liệu gửi lên đã đầy đủ chưa.
`API key is invalid`	API Key bị sai, bị đổi mới hoặc tài khoản chưa kích hoạt.	Kiểm tra lại Key trong bảng trên, đảm bảo đã truyền param `key` chính xác.
`Not enough balance`	Số dư tài khoản ví đại lý không đủ để thanh toán cho đơn hàng.	Nạp thêm tiền vào tài khoản để duy trì số dư mua hàng tự động.
`Product out of stock`	Sản phẩm bạn chọn hiện tại trong kho đã hết hàng.	Gọi lại `action=product_stock` để kiểm tra tồn kho trước khi đặt đơn.
`Product not found`	Mã gói sản phẩm (Product ID) không tồn tại hoặc đã tạm dừng bán.	Gọi `action=products` để lấy danh sách ID các sản phẩm đang mở bán.

Danh Mục & Bảng Giá Sản Phẩm (products)

Canva Pro ChatGPT Plus CapCut Pro Windows & Office

POST

Lấy toàn bộ danh sách gói tài khoản bản quyền, số lượng tồn kho (stock), đơn giá sỉ và trạng thái mở bán.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `products`
`category_id`	Integer	(Tùy chọn) Lọc theo ID danh mục chuyên biệt

Mã Nguồn Mẫu (Code Example)

curl -X POST "https://maxsocial.vn/api/v2"      -d "key=YOUR_API_KEY"      -d "action=products"

<?php
$ch = curl_init('https://maxsocial.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => [
        'key'    => 'YOUR_API_KEY',
        'action' => 'products',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$products = json_decode($response, true);
print_r($products);
?>

import requests

url = "https://maxsocial.vn/api/v2"
payload = {
    "key": "YOUR_API_KEY",
    "action": "products"
}

response = requests.post(url, data=payload)
print(response.json())

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=products]

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Bấm "▷ Gửi request" để tải danh sách gói sản phẩm (Canva, ChatGPT, CapCut...)...

Mua Tài Khoản Tự Động (buy_product)

POST

Tự động đặt mua tài khoản (Canva Pro, ChatGPT Plus, CapCut Pro...), trừ tiền ví đại lý và bàn giao thông tin đăng nhập tức thì.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `buy_product`
`product_id` *	Integer	ID gói sản phẩm cần mua (tra cứu tại `action=products`)
`quantity` *	Integer	Số lượng cần mua
`email`	String	(Tùy chọn) Email người nhận nếu là dịch vụ nâng cấp

Mã Nguồn Mẫu (Code Example)

curl -X POST "https://maxsocial.vn/api/v2"      -d "key=YOUR_API_KEY"      -d "action=buy_product"      -d "product_id=101"      -d "quantity=1"

<?php
$ch = curl_init('https://maxsocial.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => [
        'key'        => 'YOUR_API_KEY',
        'action'     => 'buy_product',
        'product_id' => 101, // Ví dụ: ID gói Canva Pro hoặc ChatGPT
        'quantity'   => 1,
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$order = json_decode($response, true);
if (isset($order['status']) && $order['status'] === 'success') {
    // Tách dữ liệu tài khoản trả về
    foreach ($order['data'] as $line) {
        $parts = explode('|', $line);
        $user = $parts[0] ?? '';
        $pass = $parts[1] ?? '';
        $twofa = $parts[2] ?? '';
        echo "Tài khoản: $user | Mật khẩu: $pass\n";
    }
}
?>

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=buy_product]

ID Gói sản phẩm (product_id):

Số lượng (quantity):

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Bấm "▷ Gửi request" để kiểm tra tính năng mua hàng...

Kiểm Tra Tồn Kho Sản Phẩm (product_stock)

POST

Tra cứu nhanh số lượng tài khoản còn lại trong kho để kích hoạt ẩn gói trên website đại lý khi hết hàng.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `product_stock`
`product_id` *	Integer	ID gói sản phẩm cần kiểm tra tồn kho

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=product_stock]

ID Gói sản phẩm (product_id):

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Kết quả kiểm tra tồn kho...

Tra Cứu Đơn Sản Phẩm & Lấy Data (product_orders)

POST

Tra cứu thông tin chi tiết đơn hàng đã mua hoặc lấy lại dữ liệu tài khoản nếu bị thất lạc.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `product_orders`
`order_id` *	Integer	Mã đơn hàng cần lấy lại dữ liệu

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=product_orders]

Mã đơn hàng (order_id):

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Kết quả tra cứu đơn hàng sản phẩm...

Danh Sách Dịch Vụ SMM (services)

POST

Lấy toàn bộ danh mục dịch vụ mạng xã hội, đơn giá, giới hạn số lượng min/max theo chuẩn Standard SMM API v2.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `services`

Mã Nguồn Mẫu (Code Example)

curl -X POST "https://maxsocial.vn/api/v2"      -d "key=YOUR_API_KEY"      -d "action=services"

<?php
$ch = curl_init('https://maxsocial.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => [
        'key'    => 'YOUR_API_KEY',
        'action' => 'services',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$services = json_decode($response, true);
print_r($services);
?>

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=services]

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Bấm nút "▷ Gửi request" ở trên để kiểm tra kết nối thực tế tới máy chủ...

Tạo Đơn Dịch Vụ SMM (add)

POST

Tự động đẩy đơn hàng sang hệ thống và trừ tiền từ số dư ví đại lý.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `add`
`service` *	Integer	ID gói dịch vụ (lấy từ action `services`)
`link` *	String	Link hoặc ID đối tượng cần tăng tương tác
`quantity` *	Integer	Số lượng cần tăng

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=add]

Mã dịch vụ (service):

Link hoặc ID:

Số lượng (quantity):

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Kết quả đơn hàng trả về sau khi bấm "▷ Gửi request"...

Kiểm Tra Trạng Thái 1 Đơn (status)

POST

Tra cứu tiến độ xử lý, số lượng ban đầu, số lượng còn lại của 1 đơn hàng cụ thể.

Tham số	Kiểu	Mô tả
`key` *	String	API Key xác thực của bạn
`action` *	String	Cố định giá trị: `status`
`order` *	Integer	Mã đơn hàng cần kiểm tra

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=status]

Mã đơn hàng (order ID):

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Kết quả kiểm tra trạng thái đơn hàng...

Kiểm Tra Nhiều Đơn Cùng Lúc (status)

POST

Tra cứu trạng thái hàng loạt nhiều mã đơn chỉ trong một request duy nhất.

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=status & orders]

Danh sách mã đơn (cách nhau bởi dấu phẩy):

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Kết quả kiểm tra nhiều đơn hàng...

Kiểm Tra Số Dư Ví Đại Lý (balance)

POST

Tra cứu số dư hiện tại của tài khoản để kích hoạt thông báo nạp thêm quỹ khi số dư dưới định mức.

TERMINAL KIỂM THỬ TRỰC TIẾP

POST /api/v2 [action=balance]

Kết quả phản hồi thực tế từ máy chủ (Server Response):

// Bấm nút "▷ Gửi request" ở trên để kiểm tra số dư thực tế...