Lewati ke konten

Integrasi vendor ProxyMarket: jual proxy Anda sendiri

Tanya AI

Tugas siap pakaiBangun integrasi ProxyMarket di kode Anda

Agen coding

Claude CodeMembuka aplikasi desktopCodexMembuka aplikasi desktopCursorMembuka aplikasi dari web

Asisten chat

Buka di ChatGPTTab baruBuka di ClaudeTab baru

Salin

Lihat sebagai MarkdownTeks biasa untuk alat AI
Lihat prompt
I run my own proxy or VPN platform and want to sell it on ProxyMarket (market.xproxy.io). Read https://xproxy.io/document/proxymarket-vendor-integration.md and the OpenAPI spec https://xproxy.io/docs/api/market.openapi.yaml. If you cannot open links, download them with curl.
Then look at my codebase and add, in its language and framework:
1. GET/HEAD /health that answers fast.
2. The HMAC signature check of every webhook (sign the raw body, compare in constant time).
3. The /provision, /deprovision and /settings webhooks, wired to how my platform creates, deletes and updates proxy users or VPN configs.
4. Plan sync and stock updates with the Integration API.
5. Tests for the signature check and for each webhook.
Keep the API key in an environment variable. When done, tell me how to check it with one real order.
Never print or commit my API keys, passwords or customer logins. Ask me before you open firewall ports, restart services or change config files you did not create.
Other XProxy guides, each with a Markdown copy at its URL + .md, are listed in https://xproxy.io/llms.txt.
I am reading this page in Indonesian: https://xproxy.io/id/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Indonesian.

Aplikasi terbuka dengan prompt yang sudah terisi. Tidak ada yang berjalan sampai Anda menekan Enter.

Jual proxy atau VPN Anda sendiri di ProxyMarket (market.xproxy.io). Anda tetap menjalankan server Anda. ProxyMarket menjalankan toko, menerima pembayaran, dan melayani pelanggan. Sebuah connector kecil di sisi Anda menghubungkan keduanya: connector ini melakukan beberapa panggilan ke ProxyMarket dan menjawab empat webhook.

Yang Anda butuhkan: akun vendor yang sudah disetujui di market.xproxy.io, server yang bisa dijangkau ProxyMarket lewat HTTPS dengan sertifikat yang valid, dan seseorang yang bisa menulis web service kecil. Setiap endpoint, field, dan jawaban juga ada di referensi API ProxyMarket.

Tidak sempat menulis server sendiri? ProxyMarket connector adalah server siap pakai. Instal di server Anda, beri satu skrip kecil yang menambah dan menghapus login pelanggan di sistem Anda (tersedia versi siap pakai dalam Python, Node.js, dan shell), dan connector akan mengirim setiap pesanan. Tanpa kode, tanpa port terbuka, tanpa domain.

Singkatnya

Anda memanggil ProxyMarket

Kirim paket Anda, jaga stok dan kesehatan proxy tetap terbaru, dan kirim login belakangan jika perlu. Setiap panggilan membawa X-API-Key Anda.

ProxyMarket memanggil Anda

Health check setiap 10 menit, lalu webhook saat pelanggan membayar, saat pesanan berakhir, dan saat pelanggan mengubah pengaturan.

Anda mendapat 70%

Bagian Anda dari setiap penjualan dikreditkan begitu pembayaran dikonfirmasi. ProxyMarket mengambil 30% untuk toko, pembayaran, dukungan, dan refund.

Bagaimana cara kerjanya?

Server Andamodem, proxy, VPN
ProxyMarkettoko, pembayaran, dukungan
Pelangganterhubung ke proxy Anda
ProxyMarket yang menjual. Anda mengirim login proxy atau file konfigurasi VPN, lalu pelanggan terhubung langsung ke server Anda.

Apa saja langkah untuk mulai berjualan?

Lakukan dengan urutan ini. Langkah 1 sampai 3 menyiapkan akun Anda; langkah 4 sampai 7 adalah integrasinya.

  1. Buat akun biasa di market.xproxy.ioAnda
  2. Ajukan diri sebagai vendor (Become Vendor di menu atas)Anda
  3. Persetujuan, biasanya dalam 24 jam. Sampai saat itu menu atas menampilkan Vendor Pending…; kirim pesan ke @xproxyio dengan email akun Anda agar lebih cepatProxyMarket
  4. Sementara itu, buat health check Anda dan jalankan server webhook Anda secara onlineAnda
  5. Buat API key Anda di vendor dashboardAnda
  6. Daftarkan paket Anda, tangani pesanan, dan periksa signature webhookAnda
  7. Buat satu pesanan uji sungguhan dan pastikan pelanggan mendapat proxy yang berfungsiAnda + ProxyMarket

Mengapa health check dibuat lebih dulu?

ProxyMarket memeriksa server Anda dengan HEAD {webhook_url}/health. Inilah satu-satunya endpoint yang menentukan apakah paket Anda tetap dijual:

  • Saat Anda membuat key, ProxyMarket memanggilnya sekali. Status 5xx, koneksi ditolak, atau lebih dari 5 detik: key tidak dibuat (HTTP 422 beserta alasannya).
  • Setelah itu, setiap 10 menit, selama key memiliki paket yang dijual, ProxyMarket memanggilnya lagi. Setelah 2 kali gagal berturut-turut, semua paket yang dilayani key itu disembunyikan dari toko dan tidak bisa dibeli. Satu jawaban yang baik mengembalikan semuanya secara otomatis.
Dianggap aktifDianggap mati
Status apa pun di bawah 500, dalam 5 detik. Tidak perlu login dan body.Timeout, koneksi ditolak, atau status 5xx apa pun.
python
@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200   # no login, no database, no outside call

Taruh di bawah webhook URL Anda: dengan https://your-vendor-host.com/marketplace, endpoint ini menjawab di /marketplace/health.

Inilah penyebab paling umum toko yang berjalan baik diam-diam berhenti berjualan. Sebuah deploy, restart, atau firewall yang memblokir HEAD bisa mengosongkan seluruh katalog Anda dalam sekitar 20 menit. Jadikan /health route paling sederhana yang Anda punya: tanpa login, tanpa database, tanpa panggilan keluar, dan jawab GET juga.

Jangan tertukar dengan Melaporkan kesehatan proxy Anda (POST /api/integration/health). Itu adalah panggilan yang Anda lakukan tentang proxy satu per satu; panggilan itu tidak menjaga paket Anda tetap tampil.

Bagaimana cara mendapatkan API key?

Anda membuatnya sendiri setelah pengajuan vendor Anda disetujui; tidak ada yang mengirimkannya kepada Anda. Di vendor dashboard, beri key sebuah nama dan webhook URL Anda, misalnya https://your-vendor-host.com/marketplace. Anda juga bisa melakukannya dengan satu panggilan (referensi):

bash
curl -X POST "https://market.xproxy.io/api/vendor/integrations" \
  -H "Authorization: Bearer $PROXYMARKET_LOGIN_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "primary-instance", "webhook_url": "https://your-vendor-host.com/marketplace"}'

# {"api_key": "pm_..."}   <- shown only this once, save it now
Key hanya ditampilkan sekali. ProxyMarket hanya menyimpan hash-nya dan tidak bisa memberikannya lagi. Simpan segera. Jika hilang, buat yang baru.

Dari satu key itu Anda mendapat dua nilai. Jangan sampai tertukar:

NilaiApa ituDipakai untuk
api_keyKey itu sendiri, diawali pm_Header X-API-Key di setiap panggilan yang Anda lakukan
signing_keySHA256(api_key) sebagai hex 64 karakterMemeriksa X-Signature setiap webhook (caranya)

Key tidak pernah kedaluwarsa, dan webhook URL-nya tidak bisa diubah kemudian: untuk pindah server, buat key baru. Jika Anda menjalankan beberapa server yang terpisah, beri masing-masing key sendiri. Pesanan dikirim ke key yang diatur di API Key / Server setiap paket di vendor dashboard. Paket yang dibuat lewat sync mendapat key yang melakukan sync tersebut; paket lama tanpa pengaturan itu mengirim pesanannya ke key aktif Anda yang paling lama.

Menambahkan key kedua? Paket yang dibuat sebelumnya tetap dikirim ke key lama. Atur API Key / Server paket-paket itu ke key baru, atau nonaktifkan key lama. pm-connector test memberi peringatan jika ada paket yang dikirim ke tempat lain.

Error: panggilan tanpa header X-API-Key mendapat 422, key yang salah 401, dan key yang pengajuan vendornya masih menunggu 403. Tab Integration Status di vendor dashboard menampilkan, per key, kapan terakhir terlihat, versi connector, dan 20 pengiriman terakhir beserta hasilnya.

Bagaimana cara mendaftarkan paket saya?

Kirim semua produk Anda dengan Menerbitkan atau memperbarui paket saat connector Anda mulai berjalan, dan lagi setiap kali ada perubahan. Paket yang di-sync langsung disetujui (paket yang Anda tambahkan manual di dashboard menunggu admin). external_id Anda adalah ID milik Anda sendiri untuk produk itu (port, modem, kumpulan VPN), dan setiap panggilan serta webhook selanjutnya memakainya.

bash
curl -X POST "https://market.xproxy.io/api/integration/plans/sync" \
  -H "X-API-Key: $PROXYMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "external_id": "port-1",
    "name": "US Mobile 4G - Port 1",
    "proxy_type": "mobile",
    "protocol": "HTTP",
    "country": "United States",
    "duration_days": 30,
    "price_usd": 25.00,
    "stock": 1,
    "is_active": true
  }]'

# {"created": 1, "updated": 0, "plans": [{"plan_id": "...", "external_id": "port-1", "status": "created"}]}
Perlu diketahuiAlasannya
Mengirim external_id yang sama lagi akan memperbarui paketSync aman diulang; tidak pernah membuat duplikat.
Paket yang tidak Anda sertakan tetap dijualUntuk berhenti menjualnya, panggil Menarik paket dari penjualan.
Gunakan hanya mobile, residential, datacenter, isp, ipv6, atau vpn sebagai proxy_typeAPI menerima teks apa pun, tetapi nilai lain merusak pesanan: pelanggan tidak pernah mendapat login. Lihat VPN dan VLESS.
country adalah nama lengkap dalam bahasa Inggris, misalnya United StatesPelanggan memfilter berdasarkan teks yang persis sama, jadi eja dengan cara yang sama di setiap paket (selengkapnya). ProxyMarket tidak memeriksanya.
Paket hanya tampil jika aktif, ada stok, terdaftar, dan tidak disembunyikan oleh health checkstock biasanya 1 per port modem: satu pelanggan per port.
protocol yang tidak disertakan berarti HTTPTetap kirimkan untuk paket VPN dan SOCKS5.
Paket yang dibuat lewat sync terikat pada key yang melakukan syncPesanannya dikirim ke key itu. Sync tidak pernah mengubah key paket yang sudah ada (selengkapnya).

Apa yang terjadi saat seseorang membeli?

  1. Pelanggan membayar. 70% bagian Anda langsung dikreditkan ke saldo, bahkan sebelum server Anda dipanggil.
  2. ProxyMarket memanggil POST {webhook_url}/provision dengan order_id dan external_plan_id Anda (payload). Periksa signature, lalu buat akses untuk pelanggan.
  3. Anda menjawab dengan login atau konfigurasi (terbaik), dengan pending, atau dengan error. Lihat tabel di bawah.
  4. Pelanggan melihat login di ProxyMarket dan terhubung ke server Anda. ProxyMarket mengurangi stok paket satu unit secara otomatis.
  5. Saat waktunya habis, ProxyMarket mengakhiri pesanan secara otomatis (diperiksa setiap 5 menit) dan memanggil POST {webhook_url}/deprovision. Anda mencabut akses dan menjual kembali unit tersebut. Lihat Saat pesanan berakhir.
status yang Anda jawabKapan dipakaiYang terjadi
provisioned (terbaik)Anda bisa langsung membuat aksesPelanggan langsung menerimanya. Sertakan keempat field proxy_ip, proxy_port, proxy_username, proxy_password, atau vpn_config_file untuk VPN.
pendingPenyiapannya butuh waktuKirimkan dengan Mengirim login proxy atau konfigurasi VPN. ProxyMarket menunggu total 120 detik, dihitung dari awal; setelah itu pesanan di-refund dan pengiriman yang terlambat mendapat 409.
errorAnda tidak bisa mengirim (port offline, tidak ada profil kosong)Tidak ada yang dikirim. Setelah 120 detik, uang pelanggan dikembalikan ke wallet mereka dan pendapatan Anda dihapus.
Selalu jawab HTTP 200, bahkan untuk error. Jika /provision menjawab dengan status lain, timeout (setelah 30 detik), mengembalikan JSON tidak valid, atau menyatakan provisioned dengan login yang tidak lengkap, ProxyMarket memberi pelanggan login yang Anda sync di paket, jika ada. Login yang dikirim tidak pernah disalin ke paket, dan login paket yang sudah dimiliki pesanan lain tidak dipakai ulang: pesanan itu di-refund. Panggilan ini tidak diulang.

expires_at dalam jawaban Anda diabaikan: ProxyMarket menghitung waktu sejak aktivasi dan memberitahukannya di /deprovision.

Bisakah saya mengenkripsi jawaban pada URL http:// biasa?

Bisa, secara opsional. Jawab 200 dengan header X-PM-Encrypted: v1 dan X-PM-Signature: sha256= + HMAC-SHA256 hex dari body mentah dengan signing key Anda sebagai kunci, dan body {"enc": "v1", "nonce": "…", "ct": "…"}: nonce acak 12 byte dan ciphertext AES-256-GCM dari jawaban normal Anda (tag ditambahkan di akhir), keduanya dalam base64 standar. Kuncinya adalah HKDF-SHA256 atas byte UTF-8 signing key Anda (salt kosong, info pm-provision-v1, 32 byte), dan AAD-nya adalah order_id. ProxyMarket memeriksa signature, mendekripsi, dan membaca jawaban seperti biasa; amplop yang rusak dianggap seperti timeout. Format lengkap dan test vector ada di referensi API dan bagian 5.1 panduan. pm-connector melakukannya sendiri pada URL http://. HTTPS tetap disarankan, karena permintaan webhook tidak dienkripsi.

Simpan order_id: Anda membutuhkannya untuk mengirim belakangan, mengakhiri pesanan sendiri, dan mencocokkan webhook lainnya.

Bagaimana cara memastikan webhook benar-benar dari ProxyMarket?

Setiap POST webhook membawa X-Signature: sha256=…, yaitu HMAC-SHA256 dari body mentah. Kunci rahasianya adalah signing key Anda, SHA256(api_key) dalam hex, bukan API key itu sendiri. Periksa di /provision, /deprovision, dan /update-settings sebelum melakukan hal lain.

python
import hashlib, hmac, os

API_KEY = os.environ["PROXYMARKET_API_KEY"]
# The HMAC secret is SHA256(api_key) as hex, NOT the raw key. Compute it once.
SIGNING_KEY = hashlib.sha256(API_KEY.encode()).hexdigest()


def verify_signature(raw_body: bytes, header: str) -> bool:
    expected = "sha256=" + hmac.new(SIGNING_KEY.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header or "")


# Flask: sign the raw bytes, before you parse the JSON
@app.route("/provision", methods=["POST"])
def provision():
    if not verify_signature(request.get_data(), request.headers.get("X-Signature", "")):
        return jsonify({"status": "error", "message": "Invalid signature"}), 401
    data = request.get_json()
    ...

Gunakan body permintaan mentah. Mem-parse JSON lalu menyusunnya kembali mengubah byte-nya, sehingga signature tidak lagi cocok.

Bagaimana cara menguji sebelum pelanggan membeli?

  1. Dari luar jaringan Anda, jalankan curl -I https://your-vendor-host.com/marketplace/health dan pastikan Anda mendapat status di bawah 500 dalam 5 detik.
  2. Sync satu paket dan cari paket itu di Browse di market.xproxy.io.
  3. Buat satu pesanan sungguhan untuk paket itu. Server Anda seharusnya menerima /provision dengan signature yang valid, dan login seharusnya muncul di pesanan pelanggan.
  4. Terhubung dengan login itu, lalu tunggu pesanan berakhir (atau minta lewat Telegram untuk mengakhirinya) dan pastikan /deprovision mencabut akses dan stok kembali.

Beri tahu ProxyMarket lewat Telegram @xproxyio saat Anda membuat pesanan uji, agar bisa diperiksa juga dari sisi mereka.

Bagaimana cara menjaga stok dan kesehatan tetap terbaru?

Jika ini terjadi di sisi AndaPanggilan
Modem atau server offlinePATCH /plans/stock dengan stock: 0, is_active: false
Kembali online, atau port yang terjual kosong lagiPATCH /plans/stock dengan stock: 1, is_active: true
Harga, nama, atau konfigurasi berubahPOST /plans/sync dengan paket itu saja
Anda berhenti menjual sebuah produkDELETE /plans/{external_id}
Opsional, setiap beberapa menitPOST /health dengan status dan IP saat ini dari setiap proxy. Selalu sertakan current_ip: jika tidak, IP yang tersimpan akan dihapus. Panggilan ini tidak menjaga paket Anda tetap tampil; health check server Anda yang melakukannya.

Semua path diawali https://market.xproxy.io/api/integration.

Apa yang terjadi saat pesanan berakhir?

ProxyMarket memanggil POST {webhook_url}/deprovision dengan sebuah reason:

ReasonArti
expiredMasa sewa sudah habis. Dikirim otomatis, terlambat paling lama 5 menit.
renewedPelanggan membayar perpanjangan untuk pesanan yang masih berjalan. Pesanan lama berakhir sekarang dan menyusul /provision baru dengan order_id baru.
cancelledAdmin membatalkan pesanan.
admin_refundAdmin me-refund pelanggan. Pendapatan Anda dari pesanan itu ditarik kembali.

Hapus login pelanggan (atau nonaktifkan profil VPN mereka). Lalu kirim jumlah unit kosong Anda yang sebenarnya dengan PATCH /plans/stock: ProxyMarket mengembalikan stok secara otomatis setelah refund, tetapi tidak setelah kedaluwarsa. Jawab {"status": "deprovisioned"}; jawaban ini hanya dicatat di log.

Panggilan ini dikirim sekali dan tidak pernah diulang. Jika server Anda mati saat itu, pelanggan tetap punya akses. Akhiri juga setiap pesanan dengan timer Anda sendiri saat waktunya habis (Anda tahu durasinya dari /provision). Pesanan yang gagal di-provision dan di-refund otomatis sama sekali tidak mendapat /deprovision.

Menandai pesanan kedaluwarsa hanya mengubah statusnya di ProxyMarket, dalam status apa pun, bahkan yang sudah dibatalkan. Panggilan ini tidak me-refund pelanggan, tidak mengubah stok, dan tidak memanggil webhook Anda.

Bagaimana jika pelanggan mengubah whitelist IP atau TCP fingerprint?

Saat pelanggan menyimpan Proxy Settings pada pesanan aktif, ProxyMarket memanggil POST {webhook_url}/update-settings. Panggilan ini dikirim sekali, untuk jenis pesanan apa pun. Terapkan yang didukung sistem Anda dan jawab {"status": "ok"}; Anda boleh mengabaikan field yang tidak didukung. Body-nya tidak berisi external_plan_id, jadi cari paketnya dari order_id yang Anda simpan saat provision.

  • ip_whitelist: hanya IP ini yang boleh memakai proxy. Selalu berupa daftar alamat tunggal; [] berarti tanpa batasan IP.
  • tcp_fingerprint: OS yang ingin ditiru oleh koneksi (win1 Windows 11, mac1 macOS, ios1 iPhone 15, android1 Galaxy S24, dan lainnya). null menonaktifkannya.

Bagaimana cara menjual VPN dan VLESS?

Alur pesanannya sama; hanya yang Anda kirim yang berbeda. Kirim file klien lengkap, persis seperti yang harus diimpor pelanggan.

ProdukField paketYang Anda kirim
OpenVPNproxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn"Teks .ovpn lengkap, berisi sertifikat dan key
WireGuardproxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard".conf lengkap dengan [Interface] dan [Peer]
VLESS (Xray)proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless"Tautan vless:// satu baris, atau JSON klien Xray lengkap
Jangan pernah mengirim proxy_type: "xray". Toko menampilkan paket VLESS sebagai “Xray”, tetapi label itu berasal dari vpn_protocol. xray diterima oleh API lalu merusak paket: pelanggan membayar dan konfigurasinya tidak pernah tiba.

Tiga cara mengirim file:

  • File yang sama untuk semua pelanggan paket: taruh di vpn_config_template saat Anda melakukan sync.
  • File baru per pesanan: buat di /provision dan jawab dengan vpn_config_file.
  • File baru yang butuh waktu: jawab pending, lalu kirim vpn_config_file dengan Mengirim login proxy atau konfigurasi VPN.

Untuk VLESS, beri setiap pesanan UUID sendiri (jika satu UUID dipakai bersama, mencabut satu pelanggan berarti mencabut semuanya), sebutkan transport di deskripsi paket (misalnya XTLS-Reality atau WS+TLS), dan hapus UUID dari inbound Anda saat pesanan berakhir.

File OpenVPN harus berisi remote, dev tun atau dev tap, atau sekaligus client dan blok <ca>; blok <ca> saja akan ditolak. Setiap konfigurasi minimal 50 karakter.

Bagaimana cara kerja rotasi IP?

rotation_link yang Anda kirim adalah URL yang dipanggil oleh ProxyMarket sendiri, dengan GET biasa (redirect diikuti, sertifikat tidak diperiksa, timeout 15 detik). ProxyMarket memanggilnya saat pelanggan menekan Rotate dan sesuai timer rotasi otomatis yang dipilih pelanggan (setiap 5 sampai 60 menit), dan berhenti saat pesanan berakhir. Pelanggan juga melihat tautan itu dan bisa membukanya.

Jika rotation_link milik paket diberikan sebagai cadangan (lihat di atas), tautan itu tidak pernah yang sudah dimiliki pesanan lain.

Apakah ada server webhook siap pakai?

Ada: ProxyMarket connector (pm-connector) berjalan di server Linux atau Windows Anda dan melakukan semua yang ada di halaman ini untuk Anda. Anda hanya memberinya satu skrip kecil yang menambah dan menghapus login pelanggan di sistem Anda; skrip siap pakai dalam Python, Node.js, dan shell ada di halamannya.

  • Connector menjawab webhook dengan pemeriksaan signature, membuat username dan password pelanggan di sistem Anda, dan menghapusnya saat masa sewa berakhir.
  • Connector menjangkau ProxyMarket lewat ProxyMarket hook (tipe key ProxyMarket hook): satu koneksi keluar ke market-hook-service.xproxy.io, jadi server tidak perlu port terbuka atau domain. Pelanggan selalu terhubung langsung ke port proxy Anda.
  • Connector menyusul setelah downtime: pesanan yang berakhir selama connector offline langsung kehilangan user-nya begitu connector kembali.

Anda membuat paket di Vendor Dashboard. Jika Anda ingin ProxyMarket memanggil alamat HTTPS Anda sendiri, bukan hook, lihat memakai alamat Anda sendiri.

Bagaimana saya dibayar?

Bagian Anda70% dari setiap penjualan (tarif standar; bisa disepakati per vendor)
Bagian ProxyMarket30%, untuk toko, pembayaran, dukungan, dan refund
Kapan dikreditkanBegitu pembayaran pelanggan dikonfirmasi dan pesanan aktif, sebelum /provision Anda dipanggil
Di mana melihatnyaEarnings di vendor dashboard Anda: setiap penjualan beserta jumlahnya, jumlah bagian Anda, dan tarif yang dipakai
PencairanDibayarkan oleh admin ProxyMarket dari saldo Anda. Minta lewat Telegram saat Anda ingin menarik dana.
RefundRefund otomatis (tidak ada yang dikirim dalam 120 detik) atau refund oleh admin menghapus pendapatan itu dari saldo Anda. Kode promo menurunkan nilai penjualan, begitu pula bagian Anda.
PenarikanPencairan bisa sampai sebesar saldo Anda dan menandai pendapatan belum dibayar yang paling lama sebagai sudah dibayar.

Tarif disimpan bersama setiap penjualan, jadi perubahan tarif di kemudian hari tidak pernah memengaruhi uang yang sudah Anda peroleh.

Di mana paket saya tampil di toko?

Browse menampilkan paket dari yang termurah, dengan satu aturan yang perlu diketahui sebelum menentukan harga: paket dari vendor yang memakai software XProxy tampil lebih dulu, di bawah Powered by xProxy, dengan lencana xProxy. Paket dari connector Anda sendiri menyusul, di bawah Other vendors, juga dari yang termurah.

Di manaYang menentukan urutan
Browse, defaultKelompok XProxy lebih dulu, lalu milik Anda, masing-masing dari yang termurah
Browse, saat pelanggan mengurutkanPengurutan berlaku di dalam setiap kelompok, jadi paket Anda yang lebih murah tetap berada di bawah kelompok XProxy
Kartu “from $X” di berandaPaket XProxy termurah di setiap kategori; paket Anda hanya jika XProxy tidak punya stok di sana
Filter negara, protokol, dan pencarian, halaman toko AndaPersis sama untuk setiap vendor

Jika semua yang tampil berasal dari satu kelompok, Browse menampilkan satu daftar tanpa judul. Sebagian besar pelanggan datang dengan memfilter negara atau protokol, dan di sana paket Anda berdampingan dengan paket semua vendor.

Apa arti kode error?

KodeArtiYang perlu dilakukan
401Invalid API key (key salah atau dinonaktifkan), Missing API key (header kosong), atau Vendor inactivePeriksa header X-API-Key dan pastikan key aktif di dashboard
403Pengajuan vendor Anda masih menunggu (pada panggilan apa pun), atau akun bukan vendor yang disetujui (saat membuat key)Tunggu persetujuan
404external_id atau order_id tidak dikenalPeriksa ID-nya; sync paket lebih dulu
409Mengirim kredensial ke pesanan yang sudah tidak berstatus paid atau activeBiasanya 120 detik sudah lewat dan pesanan sudah di-refund. Jangan diulang
422Ada nilai yang tidak valid, atau header X-API-Key tidak ada sama sekalidetail dalam jawaban menyebutkan field-nya
500Error di ProxyMarketUlangi dengan jeda yang makin lama

Error dikembalikan sebagai {"detail": "…"}. Tidak ada batas laju (rate limit) yang dipublikasikan; lakukan sync saat ada perubahan, bukan dalam loop yang rapat.

Apakah ada contoh lengkap?

Ada. Connector Python ini melakukan sync satu paket proxy, melaporkan kesehatan setiap 5 menit, dan menjawab keempat webhook. Ganti dua fungsi di bagian atas dengan panggilan ke sistem Anda sendiri, dan tambahkan timer yang mengakhiri setiap pesanan saat waktunya habis.

python
"""Minimal ProxyMarket connector: sync plans, report health, answer the four webhooks."""
import hashlib
import hmac
import os
import secrets
import threading
import time

import requests
from flask import Flask, jsonify, request

API_KEY = os.environ["PROXYMARKET_API_KEY"]          # pm_... from "Create your API key"
MARKET = "https://market.xproxy.io/api/integration"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
SIGNING_KEY = hashlib.sha256(API_KEY.encode()).hexdigest()


# ── Your system (replace with your own code) ─────────────────────────
PORTS = {
    "port-1": {"name": "US Mobile 4G - Port 1", "country": "United States", "protocol": "HTTP",
               "price": 25.00, "days": 30, "online": True, "ip": "203.0.113.1", "port": 8080},
}

def add_proxy_login(port_id, username, password): ...   # create the customer's login
def remove_proxy_login(port_id, order_id): ...          # delete it again


# ── Calls you make ───────────────────────────────────────────────────
def sync_plans():
    plans = [{
        "external_id": pid, "name": p["name"], "proxy_type": "mobile", "protocol": p["protocol"],
        "country": p["country"], "duration_days": p["days"], "price_usd": p["price"],
        "stock": 1 if p["online"] else 0, "is_active": p["online"],
    } for pid, p in PORTS.items()]
    r = requests.post(f"{MARKET}/plans/sync", json=plans, headers=HEADERS, timeout=15)
    print("[sync]", r.status_code, r.json())


def set_stock(port_id, free):
    requests.patch(f"{MARKET}/plans/stock", headers=HEADERS, timeout=15,
                   json=[{"external_id": port_id, "stock": 1 if free else 0, "is_active": free}])


def health_reporter():
    while True:
        try:
            reports = [{"external_id": pid, "status": "online" if p["online"] else "offline",
                        "current_ip": p["ip"]} for pid, p in PORTS.items()]
            requests.post(f"{MARKET}/health", json=reports, headers=HEADERS, timeout=15)
        except requests.RequestException as e:
            print("[health]", e)
        time.sleep(300)  # every 5 minutes


# ── Webhooks ProxyMarket calls ───────────────────────────────────────
app = Flask(__name__)


def signed():
    expected = "sha256=" + hmac.new(SIGNING_KEY.encode(), request.get_data(), hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, request.headers.get("X-Signature", ""))


@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200


@app.route("/provision", methods=["POST"])
def provision():
    if not signed():
        return jsonify({"status": "error", "message": "Invalid signature"}), 401
    data = request.get_json()
    port = PORTS.get(data["external_plan_id"])
    if not port or not port["online"]:
        return jsonify({"status": "error", "message": "Port offline"})  # ProxyMarket refunds the customer
    username = f"cust_{data['order_id'][:8]}"
    password = secrets.token_urlsafe(16)
    add_proxy_login(data["external_plan_id"], username, password)
    set_stock(data["external_plan_id"], free=False)
    return jsonify({
        "status": "provisioned",
        "proxy_ip": port["ip"], "proxy_port": port["port"],
        "proxy_username": username, "proxy_password": password,
    })


@app.route("/deprovision", methods=["POST"])
def deprovision():
    if not signed():
        return jsonify({"status": "error", "message": "Invalid signature"}), 401
    data = request.get_json()
    remove_proxy_login(data["external_plan_id"], data["order_id"])  # must be safe to run twice
    set_stock(data["external_plan_id"], free=True)
    return jsonify({"status": "deprovisioned"})


@app.route("/update-settings", methods=["POST"])
def update_settings():
    if not signed():
        return jsonify({"status": "error", "message": "Invalid signature"}), 401
    data = request.get_json()
    # data["ip_whitelist"]: [] = allow everyone, None = leave as it is
    # data["tcp_fingerprint"]: "win1", "ios1", ... or None = no spoofing
    return jsonify({"status": "ok"})  # apply what you support, ignore the rest


if __name__ == "__main__":
    sync_plans()
    threading.Thread(target=health_reporter, daemon=True).start()
    # Serve this behind HTTPS at your webhook_url, for example https://your-vendor-host.com/marketplace
    app.run(host="0.0.0.0", port=9090)

Di mana referensi API lengkapnya?

Setiap panggilan dan webhook, dengan semua field, contoh jawaban, dan kode dalam curl, Python, Node.js, dan PHP, ada di referensi API ProxyMarket. File OpenAPI 3.1 ada di market.openapi.yaml.

ArahEndpointFungsinya
Anda memanggilPOST /api/vendor/integrationsMembuat API key Anda
Anda memanggilPOST /plans/syncMenerbitkan atau memperbarui paket
Anda memanggilPATCH /plans/stockMengubah stok dan visibilitas
Anda memanggilDELETE /plans/{external_id}Menarik paket dari penjualan
Anda memanggilPOST /healthMelaporkan status proxy Anda
Anda memanggilPOST /orders/{order_id}/credentialsMengirim login atau konfigurasi belakangan
Anda memanggilPOST /orders/{order_id}/expireMenandai pesanan kedaluwarsa (tanpa refund)
Kami memanggil AndaHEAD /healthHealth check yang menjaga paket Anda tetap tampil
Kami memanggil AndaPOST /provisionPelanggan sudah membayar: kirimkan
Kami memanggil AndaPOST /deprovisionPesanan berakhir: cabut akses
Kami memanggil AndaPOST /update-settingsTerapkan whitelist IP atau TCP fingerprint baru
Anda memanggilGET /orders/activePesanan paid dan active yang diarahkan ke key Anda

Negara mana saja yang bisa saya daftarkan?

Semua negara. Kirim nama lengkap negara dalam bahasa Inggris, misalnya United States, Germany, atau Vietnam, dan eja dengan cara yang sama di setiap paket: pelanggan memfilter berdasarkan teks yang persis sama. ProxyMarket tidak memeriksa namanya; daftar di panduan dan di vendor dashboard adalah ejaan yang harus dipakai. pm-connector test menolak nama yang tidak ada di daftar itu.

Apa yang berubah di versi 1.13?

  • Panggilan baru: Menampilkan pesanan yang diarahkan ke key Anda (GET /orders/active, dengan routed_plans dan ETag), untuk menyusul setelah downtime.
  • Cadangan yang lebih aman: login yang dikirim tidak lagi disalin ke paket, dan login paket atau tautan rotasi yang dimiliki pesanan lain tidak pernah diberikan.
  • Waktu provision: /provision baru dikirim setelah pembayaran tercatat, sehingga pengiriman kredensial secara langsung diterima. /update-settings selalu membawa nilai yang baru saja disimpan pelanggan.
  • ProxyMarket connector: server webhook siap pakai, termasuk cara menjangkaunya di balik NAT. Lihat connector.
  • Jawaban provision terenkripsi (opsional): pada webhook URL http:// biasa, segel jawaban /provision Anda dengan X-PM-Encrypted: v1. Lihat di atas.
  • Pengikatan paket: paket yang dibuat lewat sync dikirim ke key yang melakukan sync.
  • Rotasi: ProxyMarket memanggil rotation_link Anda dengan GET. Lihat rotasi IP.
  • Tab Integration Status di vendor dashboard, dan header opsional X-PM-Connector.
  • Didokumentasikan sesuai kode: 422 tanpa header X-API-Key, 403 selama pengajuan Anda menunggu, timeout provision 30 detik, negara dan port sync yang tidak divalidasi, protocol default HTTP, laporan /health tanpa current_ip menghapus IP tersebut, aturan <ca> OpenVPN, dan tidak ada external_plan_id di /update-settings.

FAQ

Saya memakai XProxy. Apakah saya perlu membuat ini?

Tidak. Aktifkan ProxyMarket di panel (Selling Platform → ProxyMarket) dan panel melakukan semua ini untuk Anda, termasuk webhook. Lihat Jual di ProxyMarket. Paket Anda juga mendapat lencana xProxy.

Mengapa semua paket saya hilang dari toko?

Hampir selalu karena health check: HEAD {webhook_url}/health gagal dua kali berturut-turut (mati, lebih lambat dari 5 detik, status 5xx, atau HEAD diblokir). Perbaiki, dan paket akan kembali setelah pemeriksaan berikutnya berhasil, dalam 10 menit.

API key saya hilang. Bisakah ProxyMarket mengirimkannya lagi?

Tidak. Yang disimpan hanya hash-nya. Buat key baru, dan ingat bahwa signing key ikut berubah.

Pemeriksaan signature saya selalu gagal. Mengapa?

Biasanya karena salah satu dari dua hal: Anda memakai API key mentah sebagai kunci rahasia HMAC, bukan SHA256(api_key) dalam hex, atau Anda menandatangani JSON yang sudah di-parse dan disusun ulang, bukan body permintaan mentah.

Apakah saya tetap dibayar jika server saya gagal mengirim?

Tidak. Jika tidak ada yang bisa dipakai tiba dalam 120 detik, pelanggan mendapat refund dan pendapatan itu dihapus dari saldo Anda.

Mengapa pelanggan mendapat login lama?

/provision Anda menjawab dengan status selain 200, timeout, atau mengirim JSON tidak valid, sehingga ProxyMarket memberikan login yang Anda sync di paket. Login yang dikirim tidak pernah disimpan di paket, dan login paket tidak dipakai ulang jika sudah dimiliki pesanan lain (pesanan itu di-refund). Selalu jawab 200, dengan error jika Anda tidak bisa mengirim.

Bisakah saya menghubungkan beberapa server?

Bisa. Buat satu key per server, masing-masing dengan webhook URL sendiri. Paket yang dibuat lewat sync dikirim ke key yang melakukan sync; untuk paket yang lebih lama, atur API Key / Server di dashboard, atau pesanannya akan dikirim ke key Anda yang paling lama.

Apa yang terjadi saat pelanggan memperpanjang?

Memperpanjang pesanan yang sudah kedaluwarsa sama dengan pesanan baru biasa. Memperpanjang pesanan yang masih berjalan lebih dulu mengirim /deprovision dengan reason: renewed untuk pesanan lama, lalu /provision untuk pesanan baru, dengan order_id baru.

Apa selanjutnya?

Buka referensi lengkap, atau tanyakan ke ProxyMarket lewat Telegram.

Masih bingung?Teknisi bisa memeriksa perangkat Anda dengan PIN sekali pakai, atau chat dengan kami di Telegram.