API chuẩn SMM

Tài liệu API

Mua dịch vụ, theo dõi đơn, bảo hành, huỷ đơn và quản lý gói VIP qua một endpoint duy nhất, phân biệt thao tác bằng tham số action. Mỗi thao tác đều có bảng tham số đầy đủ, code mẫu và nút Thử ngay để gửi request ngay trên trang.

Xem Markdown

Dán cho ChatGPT, Claude… để AI viết code tích hợp giúp bạn. Bản Markdown có đủ mọi tham số, kiểu dữ liệu và giá trị hợp lệ.

Mọi request đều cần API Key của tài khoản. Đăng ký hoặc đăng nhập để lấy Key ở trang Website & API.

POST https://shopmxh.vn/api/v2

Content-Type: application/x-www-form-urlencodedcũng nhận form-data và JSON
Xác thực: Tham số key trong body
Phản hồi: JSON
Postman: Postman Collection API V2 Postman Collection API V3

V2 và V3

Tham số gửi đi giống hệt nhau, cùng trả thông báo tiếng Việt và tiền tệ USD - chỉ khác cách báo lỗi. Chọn phiên bản ở thanh bên, mọi ví dụ trên trang đổi theo.

API V2/api/v2

Chuẩn chung của đa số API SMM. Luôn trả HTTP 200, kể cả khi lỗi; có lỗi thì body có trường error (kèm code).

Ví dụ lỗi · HTTP 200

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

API V3/api/v3

Dùng cho các đầu nối API SMM tại Việt Nam. Lỗi trả HTTP khác 200 (400: lỗi chung, 401: sai API Key), body có code, status: "error" và error.

Ví dụ lỗi · HTTP 400

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Cách nhận biết lỗi dùng được cho cả hai phiên bản: body có trường error.

Quy trình mua

Lấy dịch vụGọi services, lưu service (ID) và type.
Tạo đơnGọi add - hoặc add_vip nếu is_vip: true - kèm tham số riêng theo type.
Lưu mã đơnGiữ lại order trong phản hồi.
Theo dõiGọi status định kỳ; cần thì refill hoặc cancel.

Đơn hàng

Danh sách dịch vụ

POST action=services Chỉ đọc

Lấy toàn bộ dịch vụ đang mở bán cùng giá theo cấp tài khoản của bạn. Trường type cho biết khi tạo đơn cần gửi thêm tham số gì.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "services".

platform string

Chỉ lấy dịch vụ của một nền tảng.

FacebookInstagramTiktokTelegramTwitterYoutubeShopeeLazadaThreads

Trường trả về

service: ID dịch vụ, dùng cho tham số service khi tạo đơn.
type: Loại dịch vụ, quyết định tham số riêng khi tạo đơn (xem action add và add_vip).
rate: Giá cho mỗi 1000 đơn vị, tính bằng USD (chuỗi).
min / max: Số lượng mua tối thiểu / tối đa (chuỗi).
refill: Có cho bảo hành không.
refill_days: Số ngày được bảo hành, tính từ khi đơn hoàn thành.
cancel: Có cho huỷ đơn không.
is_vip: Dịch vụ VIP - mua bằng add_vip, không dùng add. Dịch vụ VIP không có refill/cancel.
data.allow_reaction: Được chọn cảm xúc qua tham số reaction không.
data.reactions: Các cảm xúc dịch vụ chạy được. Không có trường này nghĩa là chạy đủ cảm xúc.
data.has_custom_post: (VIP) Được chọn số bài mỗi ngày qua max_post không.
data.post_price_ratio: (VIP) Tỉ lệ số bài/giá. Ví dụ 5: 5 bài giá x1, 10 bài giá x2.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=services'

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

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "services",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "services",
})
print(res.json())

[
  {
    "service": 55,
    "name": "Member group",
    "sub_name": "buff_group",
    "type": "Default",
    "category": "buff_group",
    "description": "Member beta, Vietnamese [10k-20k/ 24 hours.]",
    "rate": "1",
    "min": "200",
    "max": "3000000",
    "refill": false,
    "refill_days": 0,
    "cancel": true,
    "currency": "USD",
    "platform": "Facebook",
    "data": {}
  },
  {
    "service": 63,
    "name": "Like Speed",
    "sub_name": "s_like",
    "type": "Reaction",
    "category": "Like",
    "description": "Like Vietnamese",
    "rate": "1",
    "min": "10",
    "max": "50000",
    "refill": false,
    "refill_days": 0,
    "cancel": true,
    "currency": "USD",
    "platform": "Facebook",
    "data": {
      "allow_reaction": true,
      "reactions": [
        "like",
        "love",
        "wow",
        "haha"
      ]
    }
  },
  {
    "service": 523,
    "name": "Vip Like V10",
    "sub_name": "vip_like_v10",
    "type": "Vip Default",
    "category": "VIP Like Theo Tháng",
    "description": "Thời gian chạy từ 7h-23h. Tùy chọn số bài theo khách hàng.",
    "rate": "87.5",
    "min": "50",
    "max": "1000",
    "currency": "USD",
    "platform": "Facebook",
    "data": {
      "has_custom_post": true,
      "post_price_ratio": 5
    },
    "is_vip": true
  }
]

{
  "error": "Key không hợp lệ*",
  "code": 401
}

{
  "code": "401",
  "status": "error",
  "error": "Key không hợp lệ*"
}

Tạo đơn

POST action=add Thay đổi dữ liệu

Mua một dịch vụ thường. Trừ tiền ngay khi tạo đơn thành công.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "add".

service integer bắt buộc

ID dịch vụ (trường service của action services).

link string bắt buộc

Link profile/bài viết, tối đa 200 ký tự. Dịch vụ profile Facebook cần link có UID dạng số, ví dụ https://www.facebook.com/100000000001 (lấy bằng action get_numeric_uid).

quantity integer bắt buộc

Số lượng mua, trong khoảng min-max của dịch vụ.

note string

Ghi chú, tối đa 100 ký tự.

Tham số riêng theo `type` của dịch vụ

Lấy type từ action services, rồi gửi thêm các tham số tương ứng.

Default

Không cần thêm tham số.

Custom Comments

comments string bắt buộc

Nội dung bình luận, mỗi dòng một bình luận, nối bằng \n. Số dòng phải BẰNG quantity.

Custom Reviews

comments string bắt buộc

Nội dung đánh giá, mỗi dòng một đánh giá, nối bằng \n. Mỗi dòng dài tối thiểu 26 ký tự. Số lượng mua tính theo SỐ DÒNG, giá trị quantity gửi lên không được dùng (vẫn phải gửi một số nguyên dương). Một số dịch vụ không nhận emoji.

Custom Checkin

comments string

Nội dung check-in, mỗi dòng một nội dung, nối bằng \n. Có thể bỏ trống; nếu gửi thì mỗi dòng dài tối thiểu 26 ký tự. Số lượng mua lấy theo quantity, không theo số dòng.

Reaction

reaction string

Cảm xúc, mặc định like. Chỉ chọn trong data.reactions của dịch vụ (nếu có).

likelovecarewowhahasadangry

Reaction Comment

reaction string

Cảm xúc thả vào bình luận, mặc định like.

likelovecarewowhahasadangry

View Special

Không cần thêm tham số.

Custom Livestream

minutes integer bắt buộc

Số phút xem livestream muốn mua.

Like Comment Tiktok

Không cần thêm tham số.

Trường trả về

order: Mã đơn, dùng cho status, refill, cancel.
start_count: Số lượng ban đầu lúc tạo đơn.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=63' \
  --data-urlencode 'link=https://www.facebook.com/100000000001' \
  --data-urlencode 'quantity=100'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "add",
        'service' => "63",
        'link' => "https://www.facebook.com/100000000001",
        'quantity' => "100",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "add",
    service: "63",
    link: "https://www.facebook.com/100000000001",
    quantity: "100",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": "63",
    "link": "https://www.facebook.com/100000000001",
    "quantity": "100",
})
print(res.json())

{
  "order": 673925,
  "start_count": 69
}

{
  "error": "Tài khoản không đủ tiền*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Tài khoản không đủ tiền*"
}

Trạng thái đơn

POST action=status Chỉ đọc

Xem trạng thái một hoặc nhiều đơn. Truyền một ID trả về một object; nhiều ID trả về object có khoá là từng ID.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "status".

order string bắt buộc

Một Order ID, hoặc nhiều ID nối bằng dấu phẩy.

Trường trả về

status: Một trong: Pending, Processing, In progress, Completed, Canceled, Refunded, Waiting Cancel.
charge: Đơn giá đã trừ cho mỗi đơn vị, tính bằng USD (chuỗi).
start_count: Số lượng ban đầu lúc bắt đầu chạy (chuỗi).
remains: Số lượng còn lại chưa chạy (chuỗi).
error: Có khi ID đó không tồn tại (chỉ trong kết quả nhiều đơn).

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=status' \
  --data-urlencode 'order=672792,672796'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "status",
        'order' => "672792,672796",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "status",
    order: "672792,672796",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": "672792,672796",
})
print(res.json())

{
  "672792": {
    "charge": "0.05833",
    "status": "Refunded",
    "start_count": "0",
    "remains": "100",
    "currency": "USD"
  },
  "672796": {
    "charge": "0.09583",
    "status": "Processing",
    "start_count": "69",
    "remains": "100",
    "currency": "USD"
  },
  "672800": {
    "error": "Không tìm thấy đơn hàng này*"
  }
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Bảo hành

POST action=refill Thay đổi dữ liệu

Yêu cầu bảo hành đơn đã hoàn thành (Completed), với dịch vụ có refill: true.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "refill".

order integer bắt buộc

Mã đơn hàng (Order ID).

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=refill' \
  --data-urlencode 'order=673925'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "refill",
        'order' => "673925",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "refill",
    order: "673925",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "673925",
})
print(res.json())

{
  "refill": 673925,
  "success": true,
  "updated_order_id": 673925
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Huỷ đơn

POST action=cancel Thay đổi dữ liệu

Huỷ đơn đang chạy và hoàn tiền phần chưa chạy (trừ phí huỷ), với dịch vụ có cancel: true. Có đơn chưa huỷ ngay mà trả status: "Waiting Cancel", tiền hoàn sau khi huỷ xong.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "cancel".

order integer bắt buộc

Mã đơn hàng (Order ID).

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=cancel' \
  --data-urlencode 'order=673925'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "cancel",
        'order' => "673925",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "cancel",
    order: "673925",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "cancel",
    "order": "673925",
})
print(res.json())

{
  "success": true,
  "refund_count": 100,
  "status": "Refunded"
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Dịch vụ VIP

Tạo đơn VIP

POST action=add_vip Thay đổi dữ liệu

Mua gói VIP theo ngày cho dịch vụ có is_vip: true. Trừ tiền ngay khi tạo đơn thành công.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "add_vip".

service integer bắt buộc

ID dịch vụ VIP (dòng có is_vip: true trong services).

link string bắt buộc

Link profile/kênh chạy VIP, tối đa 200 ký tự.

quantity integer bắt buộc

Số lượng muốn mua.

days integer bắt buộc

Số ngày mua.

306090120180

max_post integer

Số bài tối đa mỗi ngày, bắt buộc khi dịch vụ có data.has_custom_post: true.

name string

Tên hiển thị của profile, tối đa 150 ký tự.

note string

Ghi chú, tối đa 120 ký tự.

Tham số riêng theo `type` của dịch vụ

Lấy type từ action services, rồi gửi thêm các tham số tương ứng.

Vip Default

Không cần thêm tham số.

Vip Comment

comments string bắt buộc

Nội dung bình luận, mỗi dòng một bình luận, nối bằng \n.

Vip Livestream

minutes integer bắt buộc

Số phút mỗi lần live: bội số của 30, từ 30 đến 480.

order_count integer bắt buộc

Tổng số live trong gói.

Vip View Video

video_type integer bắt buộc

Loại video.

12345

speed integer

Tốc độ: 0 thường, 1 nhanh.

01

max_post integer

Số bài mỗi ngày.

51020

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add_vip' \
  --data-urlencode 'service=523' \
  --data-urlencode 'link=https://www.facebook.com/100000000001' \
  --data-urlencode 'quantity=50' \
  --data-urlencode 'days=30'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "add_vip",
        'service' => "523",
        'link' => "https://www.facebook.com/100000000001",
        'quantity' => "50",
        'days' => "30",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "add_vip",
    service: "523",
    link: "https://www.facebook.com/100000000001",
    quantity: "50",
    days: "30",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "add_vip",
    "service": "523",
    "link": "https://www.facebook.com/100000000001",
    "quantity": "50",
    "days": "30",
})
print(res.json())

{
  "order": 12345
}

{
  "error": "Tài khoản không đủ tiền*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Tài khoản không đủ tiền*"
}

Cập nhật VIP

POST action=update_vip Thay đổi dữ liệu

Đổi nội dung bình luận của đơn VIP bình luận.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "update_vip".

order integer bắt buộc

Mã đơn VIP (do add_vip trả về, khác mã đơn thường).

comments string bắt buộc

Nội dung bình luận mới, mỗi dòng một bình luận, nối bằng \n.

note string

Ghi chú, tối đa 120 ký tự.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=update_vip' \
  --data-urlencode 'order=12345' \
  --data-urlencode 'comments=Hay quá
Ủng hộ bạn'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "update_vip",
        'order' => "12345",
        'comments' => "Hay quá\nỦng hộ bạn",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "update_vip",
    order: "12345",
    comments: "Hay quá\nỦng hộ bạn",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "update_vip",
    "order": "12345",
    "comments": "Hay quá\nỦng hộ bạn",
})
print(res.json())

{
  "success": true
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Gia hạn VIP

POST action=extend_vip Thay đổi dữ liệu

Mua thêm ngày cho đơn VIP. Trừ tiền theo số ngày gia hạn.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "extend_vip".

order integer bắt buộc

Mã đơn VIP (do add_vip trả về, khác mã đơn thường).

days integer bắt buộc

Số ngày gia hạn.

306090120180

note string

Ghi chú, tối đa 120 ký tự.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=extend_vip' \
  --data-urlencode 'order=12345' \
  --data-urlencode 'days=30'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "extend_vip",
        'order' => "12345",
        'days' => "30",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "extend_vip",
    order: "12345",
    days: "30",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "extend_vip",
    "order": "12345",
    "days": "30",
})
print(res.json())

{
  "success": true
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Thêm bài viết VIP

POST action=add_post_vip Thay đổi dữ liệu

Thêm một bài viết cụ thể vào đơn VIP để chạy bù.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "add_post_vip".

order integer bắt buộc

Mã đơn VIP (do add_vip trả về, khác mã đơn thường).

link string bắt buộc

Link (hoặc ID) bài viết, tối đa 300 ký tự.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add_post_vip' \
  --data-urlencode 'order=12345' \
  --data-urlencode 'link=https://www.facebook.com/100000000001/posts/123456789'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "add_post_vip",
        'order' => "12345",
        'link' => "https://www.facebook.com/100000000001/posts/123456789",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "add_post_vip",
    order: "12345",
    link: "https://www.facebook.com/100000000001/posts/123456789",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "add_post_vip",
    "order": "12345",
    "link": "https://www.facebook.com/100000000001/posts/123456789",
})
print(res.json())

{
  "success": true
}

{
  "error": "Bài viết này đã tồn tại trong hệ thống*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Bài viết này đã tồn tại trong hệ thống*"
}

Hoàn tiền VIP

POST action=refund_vip Thay đổi dữ liệu

Dừng đơn VIP và hoàn tiền phần còn lại của gói.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "refund_vip".

order integer bắt buộc

Mã đơn VIP (do add_vip trả về, khác mã đơn thường).

Trường trả về

refund: Số tiền được hoàn, tính bằng USD (chuỗi).
days_left: Số ngày còn lại của gói.
subtract_days: Số ngày bị trừ khi hoàn.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=refund_vip' \
  --data-urlencode 'order=12345'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "refund_vip",
        'order' => "12345",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "refund_vip",
    order: "12345",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "refund_vip",
    "order": "12345",
})
print(res.json())

{
  "success": true,
  "refund": "7.36538",
  "currency": "USD",
  "days_left": 23,
  "subtract_days": 7
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Xoá đơn VIP hết hạn

POST action=delete_vip_expired Thay đổi dữ liệu

Xoá một đơn VIP đã hết hạn khỏi danh sách. Đơn còn hạn không xoá được.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "delete_vip_expired".

order integer bắt buộc

Mã đơn VIP (do add_vip trả về, khác mã đơn thường).

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=delete_vip_expired' \
  --data-urlencode 'order=12345'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "delete_vip_expired",
        'order' => "12345",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "delete_vip_expired",
    order: "12345",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "delete_vip_expired",
    "order": "12345",
})
print(res.json())

{
  "success": true
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Danh sách đơn VIP

POST action=list_vip Chỉ đọc

Xem chi tiết nhiều đơn VIP cùng lúc.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "list_vip".

orders string bắt buộc

Danh sách mã đơn VIP, nối bằng dấu phẩy.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=list_vip' \
  --data-urlencode 'orders=106,107'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "list_vip",
        'orders' => "106,107",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "list_vip",
    orders: "106,107",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "list_vip",
    "orders": "106,107",
})
print(res.json())

{
  "success": true,
  "data": [
    {
      "id": 106,
      "uid": "uid_profile",
      "type": "vip_love_tiktok",
      "time_expired": "2025-10-17",
      "server": "server_1",
      "status": 1,
      "post_today": 0,
      "max_post": 5,
      "time": "2025-09-17T15:14:41.000Z",
      "package": 100,
      "duration": "30 ngày",
      "quantity": 100
    }
  ]
}

{
  "error": "Không tìm thấy đơn hàng này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không tìm thấy đơn hàng này*"
}

Lịch sử VIP

POST action=vip_log Chỉ đọc

Các bài viết mà đơn VIP đã chạy.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "vip_log".

order integer bắt buộc

Mã đơn VIP (do add_vip trả về, khác mã đơn thường).

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=vip_log' \
  --data-urlencode 'order=12345'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "vip_log",
        'order' => "12345",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "vip_log",
    order: "12345",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "vip_log",
    "order": "12345",
})
print(res.json())

{
  "success": true,
  "posts": [
    {
      "post_id": "123",
      "post_type": "post",
      "time": "2025/09/18 10:47:32",
      "status": 0,
      "original": 69,
      "present": null,
      "note": "Bù đơn",
      "status_text": "In progress"
    }
  ]
}

{
  "error": "Đơn hàng này đã bị hết hạn hoặc không tồn tại*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Đơn hàng này đã bị hết hạn hoặc không tồn tại*"
}

Tài khoản & tiện ích

Số dư

POST action=balance Chỉ đọc

Số dư tài khoản, quy đổi sang USD theo tỉ giá rate (1 USD = rate VND).

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "balance".

Trường trả về

balance: Số dư, tính bằng USD (chuỗi).
rate: Tỉ giá đang dùng để quy đổi: 1 USD = rate VND (chuỗi).

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=balance'

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

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "balance",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "balance",
})
print(res.json())

{
  "balance": "863.17804",
  "currency": "USD",
  "rate": "26000",
  "success": true
}

{
  "error": "Key không hợp lệ*",
  "code": 401
}

{
  "code": "401",
  "status": "error",
  "error": "Key không hợp lệ*"
}

Lấy UID Facebook dạng số

POST action=get_numeric_uid Chỉ đọc

Đổi link profile Facebook (username, link chia sẻ) sang UID dạng số, dùng cho tham số link khi tạo đơn.

Tham số

key string bắt buộc

API Key của tài khoản, lấy ở trang Website & API.

action string bắt buộc

Cố định "get_numeric_uid".

link string bắt buộc

Link profile Facebook.

curl -X POST https://shopmxh.vn/api/v2 \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=get_numeric_uid' \
  --data-urlencode 'link=https://www.facebook.com/zuck'

<?php
$ch = curl_init('https://shopmxh.vn/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => "YOUR_API_KEY",
        'action' => "get_numeric_uid",
        'link' => "https://www.facebook.com/zuck",
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

// Node.js 18+ (fetch có sẵn)
const res = await fetch('https://shopmxh.vn/api/v2', {
  method: 'POST',
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "get_numeric_uid",
    link: "https://www.facebook.com/zuck",
  }),
});
console.log(await res.json());

import requests

res = requests.post('https://shopmxh.vn/api/v2', data={
    "key": "YOUR_API_KEY",
    "action": "get_numeric_uid",
    "link": "https://www.facebook.com/zuck",
})
print(res.json())

{
  "id": "100000000001",
  "link": "https://www.facebook.com/100000000001",
  "name": "Tên Khách Hàng",
  "success": true
}

{
  "error": "Không nhận dạng được uid/link này*",
  "code": 400
}

{
  "code": "400",
  "status": "error",
  "error": "Không nhận dạng được uid/link này*"
}

Trạng thái đơn

PendingProcessingIn progressCompletedCanceledRefundedWaiting Cancel

Tài liệu API

V2 và V3

Quy trình mua

Danh sách dịch vụ

Tham số

Trường trả về

Tạo đơn

Tham số

Tham số riêng theo type của dịch vụ

Trường trả về

Trạng thái đơn

Tham số

Trường trả về

Bảo hành

Tham số

Huỷ đơn

Tham số

Tạo đơn VIP

Tham số

Tham số riêng theo type của dịch vụ

Cập nhật VIP

Tham số

Gia hạn VIP

Tham số

Thêm bài viết VIP

Tham số

Hoàn tiền VIP

Tham số

Trường trả về

Xoá đơn VIP hết hạn

Tham số

Danh sách đơn VIP

Tham số

Lịch sử VIP

Tham số

Số dư

Tham số

Trường trả về

Lấy UID Facebook dạng số

Tham số

Trạng thái đơn

Tham số riêng theo `type` của dịch vụ

Tham số riêng theo `type` của dịch vụ