Hướng dẫn này cho biết cách mua proxy mới qua API từ đầu — kiểm tra những gì khả dụng, tính giá, đặt đơn và lấy các IP đã mua.

Mỗi yêu cầu sử dụng khóa API cá nhân của bạn từ bảng điều khiển tài khoản (cách lấy khóa API). Trong các ví dụ dưới đây, hãy thay YOUR_API_KEY bằng khóa của bạn. Để thanh toán bằng số dư tài khoản, dùng paymentId = 1.

⚠️ Bước đặt hàng trừ tiền từ số dư của bạn. Luôn kiểm tra chi phí ở bước tính toán trước.

Tổng quan quy trình

Kiểm tra số dư.
Xem những gì có thể đặt (quốc gia, thời hạn).
Chọn phương thức thanh toán (hoặc dùng số dư).
Tính giá.
Đặt đơn hàng.
Lấy các proxy đã mua.

Bước 1 — Kiểm tra số dư

Đảm bảo bạn có đủ số dư để mua.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get

Phản hồi

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Bước 2 — Xem những gì có thể đặt

Reference List trả về mọi thứ bạn cần để đặt hàng: quốc gia, thời hạn, mục tiêu, nhà mạng và vòng xoay (cho mobile). Sao chép countryId và periodId bạn cần.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}

Tham số đường dẫn

Tên	Giá trị	Mô tả
type	`ipv4`	Loại proxy (ipv4, ipv6, mobile, isp, mix, mix_isp).

Ví dụ

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4

Phản hồi

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

Bước 3 — Chọn phương thức thanh toán

Liệt kê các hệ thống thanh toán khả dụng và sao chép id bạn muốn làm paymentId. Để thanh toán bằng số dư, chỉ cần dùng paymentId = 1.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Phản hồi

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Bước 4 — Tính giá

Tính giá đơn hàng trước khi mua. Ưu đãi theo số lượng và thời hạn thuê được áp dụng như trên website. Bước này không trừ tiền.

Các trường body phụ thuộc loại proxy. Các trường chung ở dưới; với IPv6 truyền thêm protocol, với mobile operatorId + rotationId, với residential dùng tarifId — đều lấy từ Reference List.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Nội dung yêu cầu

Tên	Loại	Mô tả
countryId	Number	ID quốc gia từ Reference List (Bước 2).
periodId	String	ID kỳ thuê từ Reference List.
quantity	Number	Số lượng proxy cần đặt.
paymentId	Number	ID hệ thống thanh toán. `1` = số dư, `43` = thẻ đã thêm.
coupon (tùy chọn)	String	Mã giảm giá, nếu có.
authorization (tùy chọn)	String	Phương thức xác thực. Để trống để dùng login:password.
customTargetName (tùy chọn)	String	Tên mục tiêu tùy chỉnh, nếu cần.

Ví dụ

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Phản hồi — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Bước 5 — Đặt đơn hàng (trừ vào số dư)

Khi giá tính ra hợp lý, hãy đặt đơn. Bước này trừ vào số dư của bạn. Dùng cùng tham số như Bước 4. Sao chép orderId từ phản hồi.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Nội dung yêu cầu

Tên	Loại	Mô tả
countryId	Number	ID quốc gia từ Reference List (Bước 2).
periodId	String	ID kỳ thuê từ Reference List.
quantity	Number	Số lượng proxy cần đặt.
paymentId	Number	ID hệ thống thanh toán. `1` = số dư, `43` = thẻ đã thêm.
coupon (tùy chọn)	String	Mã giảm giá, nếu có.
authorization (tùy chọn)	String	Phương thức xác thực. Để trống để dùng login:password.
generateAuth (tùy chọn)	String	Y/N — tạo xác thực tùy chỉnh (mặc định N).

Ví dụ

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Phản hồi — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Bước 6 — Lấy các proxy đã mua

Lấy các proxy đã mua. Lọc theo orderId từ bước trước để xem chính xác những gì đã mua.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Phản hồi

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}