Veryotp Logo
Veryotp
Thuê số điện thoại và Mail ảo

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

Hệ thống REST API tốc độ cao, hỗ trợ thuê SIM số ảo nhận mã OTP tự động cho bot, script và tool nuôi tài khoản.

Xem bảng giá dịch vụ Dịch vụ thuê số

Khóa API của bạn (API Key)

Dùng khóa này để xác thực khi gửi yêu cầu đến hệ thống Veryotp API.

Yêu cầu đăng ký / đăng nhập để xem và sao chép API Key của bạn.
Chính sách Hỗ trợ Đối tác & Nhà phát triển (Developer / MMO)
Veryotp luôn sẵn sàng đồng hành, tư vấn và hỗ trợ kỹ thuật tận tình cho các khách hàng sử dụng dịch vụ qua API:
🚀 Hỗ trợ mở Website con (Web Đại lý riêng)
Hỗ trợ kỹ thuật thiết lập website riêng có gắn thương hiệu của bạn, kết nối trực tiếp nguồn API Veryotp để bạn tự làm chủ kinh doanh dịch vụ số.
🛠️ Hỗ trợ tích hợp Tool & Bot tự động
Hỗ trợ kỹ thuật 1:1 trong quá trình kết nối API vào phần mềm MMO, script auto reg, bot nuôi tài khoản hoặc các công cụ tự động hóa của bạn.
👉 Cần tư vấn mở web con hoặc hỗ trợ tích hợp tool? Liên hệ hỗ trợ ngay

1. Tổng quan & Xác thực API

Mọi yêu cầu API đều sử dụng giao thức HTTPS và trả về định dạng JSON chuẩn.

Base URL: https://veryotp.com/api/v1

Để gọi các API cần quyền hạn (xem số dư, thuê số, kiểm tra OTP), bạn gửi kèm API Key qua một trong các cách sau:

  • Qua Header (Khuyên dùng): X-API-Key: YOUR_API_KEY hoặc Authorization: Bearer YOUR_API_KEY
  • Qua Query URL (Dễ cho tool đơn giản): Thêm tham số ?api_key=YOUR_API_KEY vào đường dẫn.

Lưu ý bảo mật: Không chia sẻ API Key cho người khác. Nếu nghi ngờ bị lộ, bạn có thể bấm nút "Đổi khóa mới" ở trên để tạo khóa mới ngay lập tức.

2. Kiểm tra số dư ví

Lấy số dư khả dụng hiện tại trong tài khoản Veryotp của bạn.

GET https://veryotp.com/api/v1/balance
curl -X GET "https://veryotp.com/api/v1/balance" \
     -H "X-API-Key: YOUR_API_KEY"

Phản hồi thành công (200 OK):

{
  "success": true,
  "balance": 50000,
  "currency": "VND",
  "user": {
    "username": "user123",
    "email": "[email protected]"
  }
}

3. Danh sách dịch vụ & Bảng giá

Lấy mã dịch vụ (service ID), tên dịch vụ và giá bán tại Veryotp.

GET https://veryotp.com/api/v1/services

Cần gửi kèm API Key (lấy ở mục Tài khoản). Có thể thêm tham số ?search=telegram để tìm nhanh dịch vụ. Trường success_rate là tỷ lệ có mã (%) tính từ lịch sử đơn thật, total_orders là số đơn đã kết thúc của dịch vụ đó.

curl -X GET "https://veryotp.com/api/v1/services?search=telegram" \
     -H "X-API-Key: YOUR_API_KEY"

Phản hồi mẫu:

{
  "success": true,
  "total": 1,
  "currency": "VND",
  "services": [
    {
      "id": "telegram",
      "name": "Telegram",
      "price": 6300,
      "success_rate": 78,
      "total_orders": 124,
      "carrierFilterable": false,
      "status": "available"
    }
  ]
}

4. Yêu cầu thuê số điện thoại

Hệ thống tự động trừ tiền ví và cấp số điện thoại khả dụng để nhận mã OTP.

POST https://veryotp.com/api/v1/rent

Hỗ trợ cả phương thức POST (Body JSON) và GET (Query string URL) để thuận tiện cho mọi loại tool.

Tham sốKiểuBắt buộcMô tả
service string Bắt buộc Mã dịch vụ cần thuê trong danh sách Thuê số (ví dụ: telegram, facebook, google, tiktok_veryna, grab_veryna, shopee...)
network string Tùy chọn Nhà mạng mong muốn: viettel, mobifone, vinaphone (áp dụng cho các dịch vụ hỗ trợ lọc mạng như Shopee Đá Số F02, ShopeeFood)
prefix string Tùy chọn Đầu số mong muốn (ví dụ: 09, 03, 08 - áp dụng cho các cổng hỗ trợ lọc đầu số)
curl -X POST "https://veryotp.com/api/v1/rent" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"service": "telegram"}'

Phản hồi thành công:

{
  "success": true,
  "data": {
    "order_id": "8f3b2190-674e-4a9c-9c71-382a901e7492",
    "phone_number": "0389123456",
    "phone_local": "0389123456",
    "service": "telegram",
    "price": 2500,
    "currency": "VND",
    "expires_in": 420,
    "created_at": "2026-10-21T20:00:00.000Z"
  },
  "balance": 47500
}

5. Lấy mã OTP & Tự động hoàn tiền

Gọi lặp lại (polling) mỗi 3-5 giây để kiểm tra khi nào mã OTP về.

GET https://veryotp.com/api/v1/session/{order_id}

Bạn có thể truyền order_id trên đường dẫn URL hoặc qua query ?order_id=....

Chính sách hoàn tiền tự động 100%: Đơn thuê có hiệu lực chờ trong 7 phút (420 giây). Nếu nhà mạng không gửi tin nhắn OTP về trong thời gian này, hệ thống sẽ tự động chuyển trạng thái đơn sang expired và hoàn 100% tiền thuê vào ví Veryotp của bạn ngay lập tức.
curl -X GET "https://veryotp.com/api/v1/session/ORDER_ID" \
     -H "X-API-Key: YOUR_API_KEY"

Các trạng thái trả về:

waiting : Đang chờ tin nhắn từ dịch vụ gửi về.
completed : Đã nhận được mã OTP thành công.
expired : Hết hạn 7 phút, tiền đã được tự động hoàn lại vào ví.

6. Tích hợp Tool MMO tự động (MaxCare, FPlus, Genlogin...)

Chạy trực tiếp trên các phần mềm nuôi nick, auto reg tài khoản mà không cần biết lập trình.

Veryotp hỗ trợ cổng tương thích (Compatible Endpoint) giúp kết nối trực tiếp với các phần mềm MMO phổ biến:

  • Đường dẫn Server API: https://veryotp.com/api/v1/compatible
  • Token / API Key: Điền mã API Key trong tài khoản Veryotp của bạn.

Khi cấu hình trong tool nuôi nick, chỉ cần chọn loại API tương thích hoặc Custom Endpoint, dán URL và API Key là tool sẽ tự động thuê số và lấy OTP hoàn toàn tự động.