Panduan ini menunjukkan cara membeli proxy baru melalui API dari awal — memeriksa ketersediaan, menghitung harga, membuat pesanan, dan mengambil IP yang dibeli.

Setiap permintaan menggunakan kunci API pribadi Anda dari dasbor akun (cara mendapatkan kunci API). Pada contoh di bawah, ganti YOUR_API_KEY dengan kunci Anda sendiri. Untuk membayar dari saldo akun, gunakan paymentId = 1.

⚠️ Langkah pemesanan memotong saldo Anda. Selalu periksa biayanya dulu di langkah perhitungan.

Alur secara singkat

Periksa saldo Anda.
Lihat apa yang bisa dipesan (negara, periode).
Pilih metode pembayaran (atau gunakan saldo).
Hitung harga.
Buat pesanan.
Ambil proxy yang dibeli.

Langkah 1 — Periksa saldo

Pastikan saldo Anda cukup untuk pembelian.

Endpoint

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

Respons

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

Langkah 2 — Lihat apa yang bisa dipesan

Reference List mengembalikan semua yang diperlukan untuk memesan: negara, periode, target, operator, dan rotasi (untuk mobile). Salin countryId dan periodId yang Anda butuhkan.

Endpoint

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

Parameter path

Nama	Nilai	Deskripsi
type	`ipv4`	Tipe proxy (ipv4, ipv6, mobile, isp, mix, mix_isp).

Contoh

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

Respons

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

Langkah 3 — Pilih metode pembayaran

Tampilkan sistem pembayaran yang tersedia dan salin id yang Anda inginkan sebagai paymentId. Untuk membayar dari saldo, cukup gunakan paymentId = 1.

Endpoint

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

Respons

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

Langkah 4 — Hitung harga

Hitung harga pesanan sebelum membeli. Diskon volume dan periode sewa diterapkan seperti di situs. Langkah ini tidak memotong apa pun.

Field body bergantung pada tipe proxy. Field umum ada di bawah; untuk IPv6 sertakan juga protocol, untuk mobile operatorId + rotationId, untuk residential gunakan tarifId — semuanya dari Reference List.

Endpoint

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

Body permintaan

Nama	Tipe	Deskripsi
countryId	Number	ID negara dari Reference List (Langkah 2).
periodId	String	ID periode sewa dari Reference List.
quantity	Number	Jumlah proxy yang dipesan.
paymentId	Number	ID sistem pembayaran. `1` = saldo, `43` = kartu yang ditambahkan.
coupon (opsional)	String	Kode kupon, jika ada.
authorization (opsional)	String	Metode otorisasi. Kosongkan untuk memakai login:password.
customTargetName (opsional)	String	Nama target khusus, jika diperlukan.

Contoh

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

Respons — 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": []
}

Langkah 5 — Buat pesanan (memotong saldo)

Jika harga yang dihitung sudah sesuai, buat pesanan. Langkah ini memotong saldo Anda. Gunakan parameter yang sama seperti Langkah 4. Salin orderId dari respons.

Endpoint

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

Body permintaan

Nama	Tipe	Deskripsi
countryId	Number	ID negara dari Reference List (Langkah 2).
periodId	String	ID periode sewa dari Reference List.
quantity	Number	Jumlah proxy yang dipesan.
paymentId	Number	ID sistem pembayaran. `1` = saldo, `43` = kartu yang ditambahkan.
coupon (opsional)	String	Kode kupon, jika ada.
authorization (opsional)	String	Metode otorisasi. Kosongkan untuk memakai login:password.
generateAuth (opsional)	String	Y/N — buat otorisasi khusus (default N).

Contoh

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

Respons — returns the new order ID and your updated balance:

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

Langkah 6 — Ambil proxy yang dibeli

Ambil proxy yang dibeli. Filter berdasarkan orderId dari langkah sebelumnya untuk melihat persis apa yang dibeli.

Endpoint

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

Respons

{
  "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": []
}

Referensi API lengkap

Order actions — daftar referensi, hitung & pesan
Retrieve active proxy — daftar proxy Anda
Balance — saldo & sistem pembayaran

Membuat pesanan baru

Alur secara singkat

Langkah 1 — Periksa saldo

Langkah 2 — Lihat apa yang bisa dipesan

Langkah 3 — Pilih metode pembayaran

Langkah 4 — Hitung harga

Langkah 5 — Buat pesanan (memotong saldo)

Langkah 6 — Ambil proxy yang dibeli

Referensi API lengkap