Bắt Đầu

Tổng Quan & Chuẩn Kết Nối API

Tài liệu đặc tả các giao diện lập trình ứng dụng (REST API) dành riêng cho User tương tác với Shopee. Hệ thống hỗ trợ xử lý Cookie linh hoạt qua Header và Body, tối ưu hóa tốc độ và khả năng tự động hóa.

Base URL: https://api.vubel.store. Định dạng phản hồi: application/json; charset=utf-8.

Headers Yêu Cầu

Tên Header	Kiểu Dữ Liệu	Bắt Buộc	Chi Tiết
x-api-key	string	Bắt buộc	API Key tài khoản của bạn (định dạng `vubel_<hex32>`).
Cookie	string	Khuyên dùng	Chuỗi Cookie Shopee: `SPC_ST=xxx; SPC_F=yyy`. Khuyến nghị truyền qua header theo chuẩn Shopee API.
Content-Type	string	Bắt buộc	Giá trị luôn là `application/json` đối với mọi request POST/PUT/DELETE.

Cấu Hình Proxy

Mọi API thao tác với Shopee đều hỗ trợ trường proxy trong body để đảm bảo IP sạch: http://ip:port hoặc http://user:pass@ip:port.

Bắt Đầu

Phương Thức Xác Thực

Hầu hết các API nghiệp vụ Shopee đều hỗ trợ 2 phương thức xác thực linh hoạt. Bạn chọn 1 trong 2 cách tùy theo dữ liệu đang có:

Cách 1: Sử dụng Cookie (Đã có Session)

Khi bạn đã có sẵn token SPC_ST từ phiên đăng nhập trước. Gửi qua Header Cookie: SPC_ST=... hoặc qua body "spc_st": "...". Xử lý nhanh nhất vì không cần đăng nhập lại.

Cách 2: Sử dụng Tài khoản / Mật khẩu (Auto-login)

Khi bạn chỉ có thông tin đăng nhập Shopee. Truyền username (hoặc phone / email), password và spc_f. Hệ thống sẽ tự đăng nhập, lấy session và thực thi nghiệp vụ trong cùng 1 request. Response trả về Set-Cookie để bạn lưu dùng lại.

Trường tài khoản: Hệ thống hỗ trợ 3 field đồng nghĩa — username, phone, hoặc email (chọn 1). Ví dụ: "phone": "0987654321" tương đương "username": "0987654321".

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

Hướng Dẫn Chung

Thông Tin Tài Khoản API Key

GET /v1/account

Tra cứu thông tin tài khoản gắn với API Key hiện tại: số dư credits, trạng thái gói dịch vụ, thống kê sử dụng, cấu hình proxy/SMS, sheet và referral.

Lưu ý: Endpoint này không yêu cầu Cookie Shopee. Chỉ cần header x-api-key là đủ.

cURL Mẫu

curl -X GET "https://api.vubel.store/v1/account" \
  -H "x-api-key: vubel_xxxxxx"

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "account_info",
  "data": {
    "userId": "5780773973",
    "credits": 150,
    "subscriptions": {
      "reg": { "active": true, "until": "2026-09-15T00:00:00.000Z" },
      "sv": { "active": false, "until": null }
    },
    "stats": {
      "regToday": 5,
      "vcToday": 3,
      "regMonth": 120,
      "vcMonth": 80
    },
    "limits": { "limit": 0, "voucherLimit": 0 },
    "proxy": {
      "proxy": null,
      "proxyXoay": "..."
    },
    "sms": {
      "boss": null,
      "viotp": "..."
    },
    "sheet": { "sheetId": null, "sheetTab": null },
    "referral": {
      "referredBy": null,
      "totalReferred": 5,
      "totalEarned": 10
    }
  }
}

Giải Thích Response

Trường	Kiểu	Mô Tả
credits	number	Số dư credits còn lại trong tài khoản.
subscriptions	object	Trạng thái gói dịch vụ (`reg` = đăng ký, `sv` = save voucher). `active`: đang hoạt động, `until`: ngày hết hạn.
stats	object	Thống kê sử dụng: số lượt reg/voucher hôm nay và tháng này.
limits	object	Giới hạn sử dụng (0 = không giới hạn).
proxy	object	Cấu hình proxy đang dùng.
sms	object	Cấu hình dịch vụ SMS OTP.
sheet	object	Google Sheet ID và tab đang liên kết.
referral	object	Thông tin giới thiệu: người giới thiệu, tổng số referral và credits đã nhận.

1. Đăng Nhập & Phiên

Đăng Nhập Tài Khoản Shopee

POST /v1/shopee/login

Đăng nhập tài khoản Shopee bằng tài khoản/mật khẩu. Nếu có SPC_F hợp lệ, API trả về ngay thông tin và Set-Cookie. Nếu tài khoản dính checkpoint xác minh bảo mật, API trả về need_verify: true kèm sessionId để tiếp tục xác nhận.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
username / email / phone	string	Bắt buộc	Tên đăng nhập, email hoặc số điện thoại Shopee.
password	string	Bắt buộc	Mật khẩu tài khoản.
spc_f	string	Tùy chọn	Fingerprint thiết bị (nếu không truyền sẽ chuyển sang chế độ xác minh).
proxy	string	Tùy chọn	Địa chỉ proxy (`http://user:pass@ip:port`).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/login" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": "http://127.0.0.1:8080"
  }'

curl -X POST "https://api.vubel.store/v1/shopee/login" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "user123",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/login" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "login",
  "data": {
    "account": {
      "username": "user123",
      "email": "u***@gmail.com",
      "phone": "098***4321"
    }
  }
}

1. Đăng Nhập & Phiên

Chọn Phương Thức Xác Minh

POST /v1/shopee/login/select

Khi đăng nhập gặp need_verify: true, gọi API này để chọn phương thức xác minh: 20 (Phê duyệt trên App Shopee), 8 (Gửi Link qua Email), 7 (Quét mã QR trên App).

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
sessionId	string	Bắt buộc	ID phiên xác minh trả về từ bước login.
method	number	Bắt buộc	Mã phương thức: `20` (App Push), `8` (Email), `7` (QR).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/login/select" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "method": "sms"
  }'

curl -X POST "https://api.vubel.store/v1/shopee/login/select" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "method": "zalo"
  }'

curl -X POST "https://api.vubel.store/v1/shopee/login/select" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "method": "call"
  }'

curl -X POST "https://api.vubel.store/v1/shopee/login/select" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "method": "email"
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "login_select",
  "data": {
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "method": 20,
    "methodName": "device_approval",
    "status": "pending",
    "message": "Vui lòng mở App Shopee trên điện thoại và bấm 'Chấp thuận' đăng nhập."
  }
}

1. Đăng Nhập & Phiên

Kiểm Tra Trạng Thái Xác Minh

GET /v1/shopee/login/status?sessionId=sess_xxx

Polling trạng thái xác minh. Khi người dùng bấm Chấp thuận / nhấn Link / quét QR thành công, API hoàn tất phiên đăng nhập và trả về Set-Cookie SPC_ST + SPC_F.

cURL Mẫu

curl -X GET "https://api.vubel.store/v1/shopee/login/status?sessionId=sess_7c8d9e0f1a2b3c4d5e6f" \
  -H "x-api-key: vubel_xxxxxx"

Response Mẫu (Đã xác minh thành công)

{
  "ok": true,
  "action": "login",
  "status": "success",
  "data": {
    "account": {
      "username": "user123",
      "email": "u***@gmail.com",
      "coins": 5000
    }
  }
}

2. Thay Đổi Thông Tin Tài Khoản

Đổi Mật Khẩu Shopee

POST /v1/shopee/change-password

Tự động hóa toàn diện quy trình đổi mật khẩu Shopee qua hệ thống xác thực 6 bước. Truyền Cookie qua Header Cookie: SPC_ST=xxx; SPC_F=yyy.

Request Body

Lưu ý xác thực: API hỗ trợ 2 chế độ:

Cookie mode: Truyền qua Cookie header (hoặc trường spc_st trong body).
Login mode: Truyền username / phone / email, password, spc_f (hoặc input: "user|pass|SPC_F=...").

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).
oldPassword	string	Bắt buộc	Mật khẩu hiện tại của tài khoản.
newPassword	string	Bắt buộc	Mật khẩu mới (8-16 ký tự, gồm chữ hoa, chữ thường và số/ký tự đặc biệt).
proxy	string	Tùy chọn	Proxy định tuyến.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/change-password" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx; SPC_F=yyyy" \
  -H "Content-Type: application/json" \
  -d '{
    "oldPassword": "OldPassword@123",
    "newPassword": "NewPassword@456",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/change-password" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "OldPassword@123",
    "newPassword": "NewPassword@456",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/change-password" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "OldPassword@123",
    "newPassword": "NewPassword@456",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/change-password" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "OldPassword@123",
    "newPassword": "NewPassword@456",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "change_password",
  "data": {
    "account": "user123",
    "message": "Đổi mật khẩu thành công"
  }
}

1. Đăng Nhập & Phiên

Hủy Phiên Đăng Nhập

POST /v1/shopee/delete-session

Hủy phiên đăng nhập hiện tại. Sau khi gọi, phiên sẽ không còn hiệu lực. Endpoint này chỉ nhận SPC_ST, không hỗ trợ auto-login.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
spc_st	string	Bắt buộc	Token phiên đăng nhập Shopee cần hủy. Gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `"spc_st": "..."`.
proxy	string	Tùy chọn	Địa chỉ proxy (`http://user:pass@ip:port`).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/delete-session" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/delete-session" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "spc_st": "1.xxxx",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "delete_session",
  "data": {
    "message": "Cookie đã được vô hiệu hóa thành công"
  }
}

1. Đăng Nhập & Phiên

Tạo Phiên Mã QR Đăng Nhập

POST /v1/shopee/qr/generate

Khởi tạo phiên quét mã QR Shopee và nhận về sessionId cùng ảnh Base64 và URL mã QR.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/qr/generate" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/qr/generate" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": "http://user:[email protected]:8080"
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "qr_generate",
  "data": {
    "sessionId": "qr_m0abc123_def456",
    "qrBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "qrPngDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "expiresAt": "2026-08-19T12:00:00.000Z",
    "ttlMs": 300000
  }
}

1. Đăng Nhập & Phiên

Kiểm Tra Trạng Thái Quét QR

GET /v1/shopee/qr/status?sessionId=xxx

Kiểm tra trạng thái quét mã QR. Khi hoàn tất xác nhận, API trả về Set-Cookie thành công.

cURL Mẫu

curl -X GET "https://api.vubel.store/v1/shopee/qr/status?sessionId=sess_7c8d9e0f1a2b3c4d5e6f" \
  -H "x-api-key: vubel_xxxxxx"

5. Thông Tin & Đơn Hàng

Tra Cứu Thông Tin Tài Khoản

POST /v1/shopee/info

Tra cứu thông tin cơ bản: số xu Shopee (coins), username, avatar, email, số điện thoại liên kết.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/info" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "info",
  "data": {
    "account": {
      "username": "hoang_an_99",
      "email": "h***@gmail.com",
      "coins": 15200,
      "userid": 123456789
    }
  }
}

5. Thông Tin & Đơn Hàng

Lấy Danh Sách Đơn Hàng Chi Tiết

POST /v1/shopee/get_order

Lấy danh sách 5 đơn hàng gần nhất kèm mã vận đơn SPX, trạng thái, người nhận, địa chỉ và lộ trình.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/get_order" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/get_order" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/get_order" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/get_order" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "get_order",
  "data": {
    "account": {
      "username": "hoang_an_99",
      "userId": 123456789
    },
    "total": 5,
    "returned": 5,
    "orders": [
      {
        "orderId": "231127921272509",
        "orderSn": "260814BC1A4UER",
        "tracking": "SPXVN061857044824",
        "statusText": "Đang giao",
        "statusLabel": "Đang giao hàng",
        "total": "48.000đ",
        "recipient": "Hà An",
        "phone": "08458237698",
        "address": "332 Trường Thi, Phường Điện Biên, TP. Thanh Hóa"
      }
    ]
  }
}

5. Thông Tin & Đơn Hàng

Hủy Đơn Hàng Shopee

POST /v1/shopee/orders/cancel

Gửi lệnh hủy đơn hàng trực tiếp lên hệ thống Shopee theo orderId hoặc checkoutId.

Request Body

Lưu ý xác thực: API hỗ trợ 2 chế độ:

Cookie mode: Truyền qua Cookie header (hoặc trường spc_st trong body).
Login mode: Truyền username / phone / email, password, spc_f (hoặc input: "user|pass|SPC_F=...").

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).
orderId	string	Bắt buộc	Mã ID đơn hàng hoặc checkout ID.
isCheckout	boolean	Tùy chọn	Đặt `true` nếu hủy theo checkout ID.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/orders/cancel" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "260814BC1A4UER",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/orders/cancel" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "orderId": "260814BC1A4UER",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/orders/cancel" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "orderId": "260814BC1A4UER",
    "proxy": ""
  }'

5. Thông Tin & Đơn Hàng

Xác Nhận Đã Nhận Hàng (Nhận Xu)

POST /v1/shopee/orders/confirm

Xác nhận đã nhận hàng cho đơn Shopee và tự động cộng Shopee Xu thưởng vào tài khoản.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/orders/confirm" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "260814BC1A4UER",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/orders/confirm" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "orderId": "260814BC1A4UER",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/orders/confirm" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "orderId": "260814BC1A4UER",
    "proxy": ""
  }'

5. Thông Tin & Đơn Hàng

Kiểm Tra Hàng Loạt Tài Khoản

POST /v1/shopee/checkacc

Kiểm tra trạng thái sống/chết cho danh sách tài khoản (tối đa 5 tài khoản mỗi lượt gọi).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/checkacc" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": [
      "0987654321|ShopeePass@123|SPC_F=device_fingerprint_1",
      "0912345678|ShopeePass@456|SPC_F=device_fingerprint_2"
    ],
    "proxy": ""
  }'

2. Thay Đổi Thông Tin Tài Khoản

Kiểm Tra Số Điện Thoại & Khả Năng Back Số

GET /v1/shopee/check-phone?phone=0987654321

Kiểm tra trạng thái đăng ký, clean và khả năng tái sử dụng (back số) của số điện thoại trên Shopee.

cURL Mẫu

curl -X GET "https://api.vubel.store/v1/shopee/check-phone?phone=0987654321" \
  -H "x-api-key: vubel_xxxxxx"

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "check_phone",
  "data": {
    "phone": "0987654321",
    "clean": false,
    "exist": true,
    "backSo": true,
    "reusable": true,
    "backSoStatus": "So da dang ky - BACK duoc"
  }
}

6. Voucher

Lưu Danh Sách Voucher Vào Ví

POST /v1/shopee/save-voucher

Lưu mã giảm giá vào ví Shopee. Hỗ trợ 2 chế độ: truyền mã voucher trực tiếp (codes / code) hoặc tự lấy từ danh sách admin đã cấu hình.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
spc_st	string	Tùy chọn	Token phiên đăng nhập (gửi qua Header `Cookie: SPC_ST=...` hoặc body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login).
codes	string[]	Tùy chọn	Mảng mã voucher cần lưu. VD: `["SHOPEE2026", "FREESHIP50K"]`. Không truyền → tự lấy từ danh sách admin.
code	string	Tùy chọn	Mã voucher đơn lẻ (thay thế `codes` khi chỉ cần lưu 1 mã).
proxy	string	Tùy chọn	Địa chỉ proxy (`http://user:pass@ip:port`).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/save-voucher" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "codes": ["SHOPEE2026", "FREESHIP50K"],
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/save-voucher" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SHOPEE2026",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/save-voucher" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/save-voucher" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "codes": ["SHOPEE2026"],
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/save-voucher" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "codes": ["SHOPEE2026"],
    "proxy": ""
  }'

6. Voucher

Tra Cứu Chi Tiết Voucher Đang Hoạt Động

GET /v1/shopee/voucher-list?simple=0

Tra cứu danh sách các voucher đang active, tỷ lệ giảm, giá trị tối đa, đơn tối thiểu và tình trạng lượt dùng voucher.

cURL Mẫu

curl -X GET "https://api.vubel.store/v1/shopee/voucher-list?simple=0" \
  -H "x-api-key: vubel_xxxxxx"

curl -X GET "https://api.vubel.store/v1/shopee/voucher-list?simple=1" \
  -H "x-api-key: vubel_xxxxxx"

3. Xác Minh Tự Động

Auto Duyệt Thiết Bị Đăng Nhập

POST /v1/verify/device

Tự động duyệt hoặc từ chối tất cả thiết bị đang chờ xác minh trong 1 lần gọi. Hỗ trợ đăng nhập bằng user|pass hoặc cookie SPC_ST.

Auth: Cần SPC_ST (qua body input hoặc Cookie header).

Request Body

Lưu ý xác thực: API hỗ trợ 2 chế độ:

Cookie mode: Truyền qua Cookie header (hoặc trường spc_st trong body).
Login mode: Truyền username / phone / email, password, spc_f (hoặc input: "user|pass|SPC_F=...").

Tham Số	Kiểu	Bắt Buộc	Mô Tả
input	string	Bắt buộc	Cookie hoặc tài khoản. VD: "SPC_ST=xxx" hoặc "user\|pass\|SPC_F=xxx".
decision	string	Tùy chọn	"approve" (mặc định) hoặc "deny".
token	string	Tùy chọn	Token thiết bị cụ thể. Bỏ trống = duyệt TẤT CẢ.
proxy	string	Tùy chọn	Proxy ip:port.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/verify/device" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "SPC_ST=1.xxxx",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/verify/device" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/verify/device" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/verify/device" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "decision": "deny",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "verify_device",
  "data": {
    "account": "0987654321",
    "decision": "approve",
    "total": 2,
    "success": 2,
    "failed": 0,
    "results": [
      {
        "token": "abc123",
        "status": "approved",
        "deviceName": "Samsung Galaxy S24",
        "ip": "113.160.xx.xx",
        "location": "Hà Nội"
      }
    ]
  }
}

3. Xác Minh Tự Động

Auto Xác Minh Link Email Bảo Mật

POST /v1/verify/email

Đọc inbox email, tìm email chứa link xác minh Shopee (SendGrid/shp.ee), tự động click xác nhận. Không cần cookie Shopee.

Auth: Không cần cookie Shopee.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
email	string	Bắt buộc	Địa chỉ email.
password	string	Bắt buộc	Mật khẩu email.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/verify/email" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "mail_password_123"
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "verify_email",
  "data": {
    "email": "[email protected]",
    "totalEmails": 5,
    "verificationLinks": 1,
    "verified": 1,
    "results": [
      {
        "index": 0,
        "subject": "Shopee - Xác minh thiết bị",
        "status": "verified",
        "username": "0987654321",
        "device": "Chrome Windows",
        "location": "Hà Nội"
      }
    ]
  }
}

3. Xác Minh Tự Động

Quét & Xác Nhận Mã QR Đăng Nhập

POST /v1/verify/qr

Nhận ảnh QR (URL hoặc base64) hoặc qr_id trực tiếp, tự động quét và xác nhận đăng nhập. Hỗ trợ decode QR có logo Shopee.

Auth: Cần SPC_ST.
Note: Cần truyền 1 trong 3: qr_url, qr_data, hoặc qr_id.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).
input	string	Bắt buộc	Cookie SPC_ST. VD: "SPC_ST=xxx".
qr_url	string	Tùy chọn	URL ảnh QR code.
qr_data	string	Tùy chọn	Ảnh QR dạng base64.
qr_id	string	Tùy chọn	QR ID trực tiếp (nếu đã biết).
decision	string	Tùy chọn	"approve" (mặc định) hoặc "deny".
proxy	string	Tùy chọn	Proxy ip:port.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/verify/qr" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "SPC_ST=1.xxxx",
    "qr_url": "https://link-to-qr-image.png",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/verify/qr" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "SPC_ST=1.xxxx",
    "qr_data": "data:image/png;base64,iVBORw0KGgo...",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/verify/qr" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "qr_url": "https://link-to-qr-image.png",
    "decision": "approve",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "verify_qr",
  "data": {
    "decision": "approved",
    "qrId": "abc-def-123",
    "device": "iPhone 15",
    "userName": "0987654321",
    "location": "TP. Hồ Chí Minh",
    "message": "Đã xác nhận đăng nhập QR thành công"
  }
}

4. Email

Thêm / Cấp Phát Email Vào Tài Khoản

POST /v1/shopee/addmail

Hỗ trợ 2 chế độ: Truyền email cụ thể để liên kết email chỉ định, hoặc đặt mode: "random" để hệ thống tự cấp email domain miễn phí và liên kết tự động.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/addmail" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/addmail" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "random",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/addmail" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "email": "[email protected]",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/addmail" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "email": "[email protected]",
    "proxy": ""
  }'

4. Email

Đọc Mã OTP / Link Xác Thực Email

POST /v1/email/get

Quét hòm thư để lấy mã OTP hoặc đường link xác thực tài khoản Shopee.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/email/get" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "mail_password_123"
  }'

4. Email

Lịch Sử Email & Mã Xác Thực

GET /v1/email/history?limit=50&offset=0

Truy xuất danh sách email domain đã tạo và các mã OTP nhận được gần đây.

cURL Mẫu

curl -X GET "https://api.vubel.store/v1/email/history?limit=20&offset=0" \
  -H "x-api-key: vubel_xxxxxx"

7. Địa Chỉ Nhận Hàng

Xem Danh Sách Địa Chỉ

POST /v1/shopee/addresses/list

Lấy toàn bộ danh sách địa chỉ nhận hàng đã lưu của tài khoản Shopee.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/addresses/list" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/addresses/list" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/addresses/list" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

Response Mẫu (200 OK)

{
  "ok": true,
  "action": "addresses_list",
  "data": {
    "count": 1,
    "addresses": [
      {
        "id": 12345678,
        "name": "Nguyễn Văn A",
        "phone": "0987654321",
        "address": "Số 10 Ngõ 20",
        "city": "Quận 1",
        "state": "TP. Hồ Chí Minh",
        "isDeliveryDefault": true,
        "isPickupDefault": false
      }
    ]
  }
}

7. Địa Chỉ Nhận Hàng

Thêm Địa Chỉ Mới

POST /v1/shopee/create-address

Thêm địa chỉ giao hàng mới vào tài khoản Shopee (hỗ trợ cả toạ độ lat/lon và mapLink).

Request Body

Lưu ý xác thực: API hỗ trợ 2 chế độ:

Cookie mode: Truyền qua Cookie header (hoặc trường spc_st trong body).
Login mode: Truyền username / phone / email, password, spc_f (hoặc input: "user|pass|SPC_F=...").

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).
name	string	Bắt buộc	Tên người nhận hàng.
detail	string	Bắt buộc	Địa chỉ chi tiết (số nhà, tên đường).
state / city / district	string	Tùy chọn	Tỉnh/Thành phố, Quận/Huyện, Phường/Xã (hoặc truyền `area` để tự phân giải).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/create-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nguyễn Văn A",
    "phone": "0987654321",
    "detail": "Số 123 Đường Cầu Giấy",
    "state": "Hà Nội",
    "city": "Quận Cầu Giấy",
    "district": "Phường Dịch Vọng",
    "mapLink": "https://maps.app.goo.gl/xxx",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/create-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "name": "Nguyễn Văn A",
    "detail": "Số 123 Đường Cầu Giấy",
    "state": "Hà Nội",
    "city": "Quận Cầu Giấy",
    "district": "Phường Dịch Vọng",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/create-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "name": "Nguyễn Văn A",
    "detail": "Số 123 Đường Cầu Giấy",
    "state": "Hà Nội",
    "city": "Quận Cầu Giấy",
    "district": "Phường Dịch Vọng",
    "proxy": ""
  }'

7. Địa Chỉ Nhận Hàng

Đặt Địa Chỉ Mặc Định

POST /v1/shopee/set-default-address

Đặt một addressId làm địa chỉ giao hàng mặc định.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/set-default-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "addressId": "12345678",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/set-default-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "addressId": "12345678",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/set-default-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "addressId": "12345678",
    "proxy": ""
  }'

7. Địa Chỉ Nhận Hàng

Xóa Địa Chỉ Giao Hàng

POST /v1/shopee/delete-address

Xóa địa chỉ nhận hàng khỏi tài khoản theo addressId.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/delete-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "addressId": "12345678",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/delete-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "addressId": "12345678",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/delete-address" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "addressId": "12345678",
    "proxy": ""
  }'

1. Đăng Nhập & Phiên

Lấy Danh Sách Thiết Bị Chờ Duyệt

POST /v1/shopee/device/pending

Lấy danh sách các yêu cầu đăng nhập từ thiết bị lạ đang chờ xác thực trên tài khoản.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/device/pending" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/device/pending" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/device/pending" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/device/pending" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "proxy": ""
  }'

1. Đăng Nhập & Phiên

Phê Duyệt / Từ Chối Thiết Bị

POST /v1/shopee/device/approve

Gửi lệnh phê duyệt (approve) hoặc từ chối (deny) quyền đăng nhập cho thiết bị.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/device/approve" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "device_token_abc123",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/device/approve" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "device_token_abc123",
    "decision": "deny",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/device/approve" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "token": "device_token_abc123",
    "decision": "approve",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/device/approve" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "token": "device_token_abc123",
    "decision": "approve",
    "proxy": ""
  }'

8. Giỏ Hàng

Thêm Sản Phẩm Vào Giỏ Hàng

POST /v1/shopee/cart/add

Trích xuất shopId/itemId từ link sản phẩm (hỗ trợ cả link rút gọn s.shopee.vn / shp.ee) và tự động thêm vào giỏ hàng Shopee.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/cart/add" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "productUrl": "https://shopee.vn/product/123456/789012",
    "quantity": 1,
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/cart/add" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "productUrl": "https://shopee.vn/product/123456/789012",
    "quantity": 1,
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/cart/add" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "productUrl": "https://shopee.vn/product/123456/789012",
    "quantity": 1,
    "proxy": ""
  }'

2. Thay Đổi Thông Tin Tài Khoản

Xem & Cập Nhật Định Danh KYC CCCD

POST /v1/shopee/kyc

Hỗ trợ 2 chế độ: mode: "view" để xem thông tin định danh CCCD đã gắn trên tài khoản; mode: "submit" (hoặc truyền kyc_name, ic_number) để cập nhật thông tin định danh CCCD (hỗ trợ tự sinh CCCD ngẫu nhiên hợp lệ).

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/kyc" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "random",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/kyc" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "custom",
    "idNumber": "001201012345",
    "fullName": "NGUYEN VAN A",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/kyc" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "action": "random",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/kyc" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "action": "random",
    "proxy": ""
  }'

2. Thay Đổi Thông Tin Tài Khoản

Khởi Tạo Phiên OTP (Đổi SĐT / Đổi Mail)

POST /v1/shopee/init

Khởi tạo quy trình OTP cho các nghiệp vụ: change_phone (đổi SĐT mới), change_mail (đổi email mới), add_phone (gắn SĐT), unbind_phone (gỡ SĐT). Trả về sessionId và danh sách kênh OTP khả dụng (SMS, Call, Zalo).

Request Body

Lưu ý xác thực: API hỗ trợ 2 chế độ:

Cookie mode: Truyền qua Cookie header (hoặc trường spc_st trong body).
Login mode: Truyền username / phone / email, password, spc_f (hoặc input: "user|pass|SPC_F=...").

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).
action	string	Bắt buộc	`change_phone` \| `change_mail` \| `add_phone` \| `unbind_phone`
phone / email	string	Tùy action	Số điện thoại mới hoặc Email mới cần đổi.

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/init" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "change_phone",
    "phone": "0987654321",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/init" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Cookie: SPC_ST=1.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "change_mail",
    "email": "[email protected]",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/init" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "0987654321",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "action": "change_phone",
    "phone": "0912345678",
    "proxy": ""
  }'

curl -X POST "https://api.vubel.store/v1/shopee/init" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shopee_user",
    "password": "ShopeePassword@123",
    "spc_f": "device_fingerprint_here",
    "action": "change_mail",
    "email": "[email protected]",
    "proxy": ""
  }'

2. Thay Đổi Thông Tin Tài Khoản

Gửi Mã OTP Qua Kênh Đã Chọn

POST /v1/shopee/send_code

Kích hoạt gửi mã OTP qua kênh xác định: 1 (SMS), 2 (Cuộc gọi thoại Call), 5 (Zalo).

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/send_code" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "channel": 1
  }'

curl -X POST "https://api.vubel.store/v1/shopee/send_code" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "channel": 2
  }'

curl -X POST "https://api.vubel.store/v1/shopee/send_code" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "channel": 3
  }'

2. Thay Đổi Thông Tin Tài Khoản

Xác Thực Mã OTP & Hoàn Tất

POST /v1/shopee/verify_code

Gửi mã OTP 6 số người dùng nhận được để hoàn tất nghiệp vụ đổi SĐT / đổi Email / gắn SĐT.

Request Body

Tham Số	Kiểu	Bắt Buộc	Mô Tả
SPC_ST	string	Tùy chọn	Token phiên đăng nhập Shopee (gửi qua Header `Cookie: SPC_ST=...` hoặc JSON body `spc_st`).
username / email / phone	string	Tùy chọn	Tên đăng nhập, email hoặc SĐT Shopee (dùng khi auto-login).
password	string	Tùy chọn	Mật khẩu tài khoản (dùng khi auto-login).
spc_f	string	Tùy chọn	Device fingerprint (bắt buộc khi auto-login hoặc đổi pass).

cURL Mẫu

curl -X POST "https://api.vubel.store/v1/shopee/verify_code" \
  -H "x-api-key: vubel_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "sess_7c8d9e0f1a2b3c4d5e6f",
    "otp": "123456"
  }'

Tham Chiếu

Bảng Mã Lỗi Chuẩn

Danh sách các mã lỗi trả về trong cấu trúc JSON: { "error": "error_code" }.

Mã Lỗi	HTTP Status	Mô Tả Chi Tiết
cookie_required	`400`	Thiếu Cookie SPC_ST. Cần truyền qua Header hoặc Body.
cookie_expired	`401`	Cookie Shopee đã hết hạn hoặc không hợp lệ.
insufficient_credits	`402`	Số dư credit trong tài khoản không đủ để thực hiện thao tác.
user_not_found	`404`	Không tìm thấy tài khoản tương ứng với API Key.
max_5_accounts	`400`	Vượt quá giới hạn 5 tài khoản trong một lượt kiểm tra hàng loạt.
unauthorized	`401`	API Key thiếu hoặc không hợp lệ.