İçeriğe geç

ProxyMarket Satıcı Entegrasyonu: Kendi Proxy’lerinizi Satın

AI'a sor

Hazır görevProxyMarket entegrasyonunu kodunuzda oluşturun

Kodlama ajanları

Claude CodeMasaüstü uygulamasını açarCodexMasaüstü uygulamasını açarCursorUygulamayı web'de açar

Sohbet asistanları

ChatGPT ile açYeni sekmeClaude ile açYeni sekme

Kopyala

Markdown olarak görüntüleAI araçları için düz metin
İstemi gör
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 Turkish: https://xproxy.io/tr/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Turkish.

Uygulama, istem doldurulmuş olarak açılır. Enter'a basana kadar hiçbir şey çalışmaz.

Kendi proxy’lerinizi veya VPN’inizi ProxyMarket’te (market.xproxy.io) satın. Sunucularınızı siz çalıştırmaya devam edersiniz. Mağazayı ProxyMarket yönetir, ödemeleri alır ve müşterilere yanıt verir. Sizin tarafınızdaki küçük bir connector ikisini birbirine bağlar: ProxyMarket’e birkaç çağrı yapar ve dört webhook’a yanıt verir.

Gerekenler: market.xproxy.io’da onaylı bir satıcı hesabı, ProxyMarket’in geçerli sertifikalı HTTPS üzerinden ulaşabildiği bir sunucu ve küçük bir web servisi yazabilecek biri. Her endpoint, alan ve yanıt ProxyMarket API referansında da yer alır.

Sunucuyu yazmaya vaktiniz yok mu? ProxyMarket connector hazır bir sunucudur. Onu sunucunuza kurun, sisteminizde müşterinin giriş bilgilerini ekleyip silen küçük bir betik verin (Python, Node.js ve shell için hazırları var); her siparişi o teslim eder. Kod yok, açık port yok, alan adı yok.

Kısaca

Siz ProxyMarket’i çağırırsınız

Planlarınızı gönderin, stoğu ve proxy sağlık durumunu güncel tutun ve gerekirse giriş bilgilerini sonradan teslim edin. Her çağrı X-API-Key’inizi taşır.

ProxyMarket sizi çağırır

10 dakikada bir sağlık kontrolü, ardından bir müşteri ödeme yaptığında, bir sipariş bittiğinde ve bir müşteri bir ayarı değiştirdiğinde bir webhook.

%70 sizde kalır

Her satıştaki payınız ödeme onaylanır onaylanmaz hesabınıza geçer. ProxyMarket %30’unu mağaza, ödemeler, destek ve iadeler için alır.

Nasıl çalışır?

Sunucunuzmodemler, proxy’ler, VPN
ProxyMarketmağaza, ödemeler, destek
Müşteriproxy’nize bağlanır
ProxyMarket satar. Siz proxy giriş bilgilerini veya VPN yapılandırma dosyasını teslim edersiniz; müşteri de ardından doğrudan sunucunuza bağlanır.

Yayına geçmenin adımları nelerdir?

Bu sırayla yapın. 1–3. adımlar hesabınızı hazırlar; 4–7. adımlar entegrasyondur.

  1. market.xproxy.io üzerinde normal bir hesap oluşturunSiz
  2. Satıcı olmak için başvurun (üst menüde Become Vendor)Siz
  3. Onay, genellikle 24 saat içinde. O zamana kadar üst menüde Vendor Pending… görünür; hızlandırmak için hesap e-postanızla @xproxyio’ya yazınProxyMarket
  4. Bu arada sağlık kontrolünüzü oluşturun ve webhook sunucunuzu yayına alınSiz
  5. Satıcı panelinde API anahtarınızı oluşturunSiz
  6. Planlarınızı listeleyin, siparişleri işleyin ve webhook imzalarını kontrol edinSiz
  7. Gerçek bir test siparişi verin ve müşterinin çalışan bir proxy aldığını kontrol edinSiz + ProxyMarket

Sağlık kontrolünü neden önce oluşturmalıyım?

ProxyMarket sunucunuzu HEAD {webhook_url}/health ile kontrol eder. Planlarınızın satışta kalıp kalmayacağına karar veren tek endpoint budur:

  • Anahtarınızı oluşturduğunuzda ProxyMarket onu bir kez çağırır. 5xx, reddedilen bağlantı veya 5 saniyeden uzun süre: anahtar yok (nedeniyle birlikte HTTP 422).
  • Bundan sonra 10 dakikada bir, anahtarın satışta planı olduğu sürece yeniden çağırır. Üst üste 2 başarısızlıktan sonra, o anahtarın sunduğu tüm planlar mağazada gizlenir ve satın alınamaz. Tek bir başarılı yanıt hepsini kendiliğinden geri getirir.
Çalışıyor sayılırÇalışmıyor sayılır
5 saniye içinde 500’ün altındaki herhangi bir durum kodu. Giriş ve gövde gerekmez.Zaman aşımı, reddedilen bağlantı veya herhangi bir 5xx durum kodu.
python
@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200   # no login, no database, no outside call

Webhook URL’nizin altına koyun: https://your-vendor-host.com/marketplace ile /marketplace/health adresinde yanıt verir.

Çalışan bir mağazanın sessizce satışı durdurmasının en yaygın nedeni budur. Bir deploy, bir yeniden başlatma veya HEAD’i engelleyen bir güvenlik duvarı, tüm kataloğunuzu yaklaşık 20 dakikada boşaltabilir. /health’i elinizdeki en basit route yapın: giriş yok, veritabanı yok, dış çağrı yok; GET’e de yanıt verin.

Bunu Proxy’lerinizin sağlık durumunu bildirme (POST /api/integration/health) ile karıştırmayın. O, tek tek proxy’ler hakkında sizin yaptığınız bir çağrıdır; planlarınızı listede tutmaz.

API anahtarımı nasıl alırım?

Satıcı başvurunuz onaylandıktan sonra anahtarı kendiniz oluşturursunuz; kimse size göndermez. Satıcı panelinde anahtara bir ad ve webhook URL’nizi verin, örneğin https://your-vendor-host.com/marketplace. Bunu tek bir çağrıyla da yapabilirsiniz (referans):

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
Anahtar yalnızca bir kez gösterilir. ProxyMarket yalnızca bir hash saklar ve anahtarı geri veremez. Hemen kaydedin. Kaybederseniz yenisini oluşturun.

Bu tek anahtardan iki değer elde edersiniz. Bunları birbirinden ayrı tutun:

DeğerNedirNe için kullanılır
api_keyAnahtarın kendisi, pm_ ile başlarYaptığınız her çağrıdaki X-API-Key başlığı
signing_key64 karakterlik hex olarak SHA256(api_key)Her webhook’un X-Signature’ını kontrol etmek (nasıl)

Anahtarın süresi hiç dolmaz ve webhook URL’si sonradan değiştirilemez: sunucu değiştirmek için yeni bir anahtar oluşturun. Birkaç bağımsız sunucu çalıştırıyorsanız her birine kendi anahtarını verin. Siparişler, satıcı panelinde her planın API Key / Server alanında ayarlı anahtara gider. Bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtarı alır; bu ayarı olmayan eski bir plan siparişlerini en eski aktif anahtarınıza gönderir.

İkinci bir anahtar mı ekliyorsunuz? Ondan önce oluşturulan planlar eski anahtara gitmeye devam eder. Bu planların API Key / Server’ını yeni anahtara ayarlayın veya eski anahtarı kapatın. pm-connector test, bir plan başka yere gittiğinde uyarır.

Hatalar: X-API-Key başlığı olmayan bir çağrı 422, yanlış bir anahtar 401, satıcı başvurusu hâlâ beklemede olan bir anahtar 403 alır. Satıcı panelinin Integration Status sekmesi her anahtar için en son ne zaman görüldüğünü, connector sürümünü ve son 20 teslimatı sonuçlarıyla gösterir.

Planlarımı nasıl listelerim?

Connector’ınız başladığında ve bir şey her değiştiğinde tüm ürünlerinizi Planlarınızı yayınlama veya güncelleme ile gönderin. Senkronize edilen planlar hemen onaylanır (panelde elle eklediğiniz planlar bir yöneticiyi bekler). external_id, ürün için kendi kimliğinizdir (bir port, bir modem, bir VPN havuzu) ve sonraki her çağrı ile webhook bunu kullanır.

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"}]}
Bilmekte fayda varNeden
Aynı external_id’yi yeniden göndermek planı güncellerSenkronizasyonu tekrarlamak güvenlidir; asla kopya oluşturmaz.
Göndermediğiniz bir plan satışta kalırSatışı durdurmak için Bir planı satıştan kaldırma çağrısını yapın.
proxy_type olarak yalnızca mobile, residential, datacenter, isp, ipv6 veya vpn kullanınAPI her metni kabul eder ama başka bir değer siparişi bozar: müşteri hiçbir zaman giriş bilgisi almaz. VPN ve VLESS’e bakın.
country, tam İngilizce addır, örneğin United StatesMüşteriler tam metne göre filtreler, bu yüzden her planda aynı şekilde yazın (daha fazlası). ProxyMarket bunu kontrol etmez.
Bir plan yalnızca aktif, stokta, listelenmiş ve sağlık kontrolüyle gizlenmemişse gösterilirstock genellikle modem portu başına 1’dir: port başına bir müşteri.
protocol gönderilmezse HTTP sayılırVPN ve SOCKS5 planları için yine de gönderin.
Bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtara sabitlenirSiparişleri o anahtara gider. Senkronizasyon, zaten var olan bir planın anahtarını asla değiştirmez (daha fazlası).

Biri satın aldığında ne olur?

  1. Müşteri öder. %70’iniz, sunucunuz daha çağrılmadan hemen bakiyenize eklenir.
  2. ProxyMarket, order_id ve external_plan_id’nizle POST {webhook_url}/provision çağrısını yapar (payload). İmzayı kontrol edin, ardından müşterinin erişimini oluşturun.
  3. Giriş bilgileri veya yapılandırmayla (en iyisi), pending ile ya da error ile yanıt verirsiniz. Aşağıdaki tabloya bakın.
  4. Müşteri giriş bilgilerini ProxyMarket’te görür ve sunucunuza bağlanır. ProxyMarket planın stoğunu kendiliğinden bir azaltır.
  5. Süre dolduğunda ProxyMarket siparişi kendiliğinden bitirir (5 dakikada bir kontrol eder) ve POST {webhook_url}/deprovision çağrısını yapar. Siz erişimi kaldırır ve birimi yeniden satışa çıkarırsınız. Bir sipariş bittiğinde bölümüne bakın.
Yanıt verdiğiniz statusNe zaman kullanılırNe olur
provisioned (en iyisi)Erişimi hemen oluşturabiliyorsunuzMüşteri hemen alır. proxy_ip, proxy_port, proxy_username, proxy_password dördünü birden, VPN için de vpn_config_file’ı ekleyin.
pendingKurulum biraz zaman alıyorBilgileri Proxy giriş bilgilerini veya VPN yapılandırmasını teslim etme ile gönderin. ProxyMarket, başlangıçtan itibaren toplam 120 saniye bekler; sonrasında sipariş iade edilir ve geç bir teslimat 409 alır.
errorTeslim edemiyorsunuz (port çevrimdışı, boş profil yok)Hiçbir şey teslim edilmez. 120 saniyeden sonra müşteriye cüzdanına iade yapılır ve kazancınız düşülür.
Hata için bile her zaman HTTP 200 ile yanıt verin. /provision başka bir durum koduyla yanıt verir, zaman aşımına uğrar (30 saniye sonra), geçersiz JSON döndürür veya eksik giriş bilgileriyle provisioned derse ProxyMarket müşteriye, varsa planda senkronize ettiğiniz giriş bilgilerini verir. Teslim edilen bir giriş asla plana kopyalanmaz ve zaten başka bir siparişe ait olan plan girişi yeniden kullanılmaz: o sipariş iade edilir. Çağrı tekrarlanmaz.

Yanıtınızdaki expires_at yok sayılır: ProxyMarket süreyi aktivasyondan itibaren sayar ve size /deprovision’da bildirir.

Düz bir http:// URL’sinde yanıtı şifreleyebilir miyim?

Evet, isteğe bağlı olarak. X-PM-Encrypted: v1 ve X-PM-Signature: sha256= + ham gövdenin imzalama anahtarınızla oluşturulan hex HMAC-SHA256 değeri başlıklarıyla ve {"enc": "v1", "nonce": "…", "ct": "…"} gövdesiyle 200 yanıtı verin: rastgele 12 baytlık bir nonce ve normal yanıtınızın AES-256-GCM şifreli metni (tag sona eklenmiş), ikisi de standart base64. Anahtar, imzalama anahtarınızın UTF-8 baytları üzerinde HKDF-SHA256’dır (boş salt, info pm-provision-v1, 32 bayt), AAD ise order_id’dir. ProxyMarket imzayı kontrol eder, şifreyi çözer ve yanıtı her zamanki gibi okur; hatalı bir zarf zaman aşımı gibi sayılır. Tam biçim ve bir test vektörü API referansında ve rehberin 5.1 bölümündedir. pm-connector bunu bir http:// URL’sinde kendiliğinden yapar. Webhook istekleri şifrelenmediği için HTTPS yine de önerilir.

order_id’yi kaydedin: geç teslimat yapmak, siparişi kendiniz bitirmek ve diğer webhook’larla eşleştirmek için ona ihtiyacınız var.

Bir webhook’un gerçekten ProxyMarket’ten geldiğini nasıl kontrol ederim?

Her webhook POST’u, ham gövdenin HMAC-SHA256 değeri olan X-Signature: sha256=… taşır. Gizli anahtar, API anahtarının kendisi değil, hex olarak SHA256(api_key) olan imzalama anahtarınızdır. Başka bir şey yapmadan önce bunu /provision, /deprovision ve /update-settings’te kontrol edin.

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()
    ...

Ham istek gövdesini kullanın. JSON’u ayrıştırıp yeniden yazdırmak baytları değiştirir ve imza artık eşleşmez.

Müşteriler satın almadan önce nasıl test ederim?

  1. Ağınızın dışından curl -I https://your-vendor-host.com/marketplace/health çalıştırın ve 5 saniye içinde 500’ün altında bir durum kodu aldığınızı kontrol edin.
  2. Bir planı senkronize edin ve market.xproxy.io’da Browse içinde bulun.
  3. Onun için gerçek bir sipariş verin. Sunucunuz geçerli imzalı /provision almalı ve giriş bilgileri müşterinin siparişinde görünmelidir.
  4. Bu girişle bağlanın, ardından siparişin bitmesini bekleyin (veya bitirilmesini Telegram’dan isteyin) ve /deprovision’ın erişimi kaldırdığını ve stoğun geri geldiğini kontrol edin.

Test siparişini verdiğinizde ProxyMarket’e Telegram @xproxyio üzerinden haber verin; böylece onlar da kendi taraflarından kontrol edebilir.

Stoğu ve sağlık durumunu nasıl güncel tutarım?

Sizin tarafınızda bu olduğundaÇağrı
Bir modem veya sunucu çevrimdışı olurstock: 0, is_active: false ile PATCH /plans/stock
Yeniden çevrimiçi olur veya satılmış bir port yeniden boşalırstock: 1, is_active: true ile PATCH /plans/stock
Bir fiyat, ad veya yapılandırma değişirYalnızca o planla POST /plans/sync
Bir ürünü satmayı bırakırsınızDELETE /plans/{external_id}
İsteğe bağlı, birkaç dakikada birHer proxy’nin durumu ve güncel IP’siyle POST /health. Her zaman current_ip ekleyin: göndermezseniz kayıtlı IP silinir. Planlarınızı listede tutmaz; bunu sunucunuzun sağlık kontrolü yapar.

Tüm yollar https://market.xproxy.io/api/integration ile başlar.

Bir sipariş bittiğinde ne olur?

ProxyMarket bir reason ile POST {webhook_url}/deprovision çağrısını yapar:

NedenAnlamı
expiredKiralama süresi doldu. Otomatik gönderilir, en fazla 5 dakika gecikmeyle.
renewedMüşteri çalışan bir siparişi yenilemek için ödeme yaptı. Eski sipariş şimdi biter ve ardından yeni bir order_id ile yeni bir /provision gelir.
cancelledBir yönetici siparişi iptal etti.
admin_refundBir yönetici müşteriye iade yaptı. Bu siparişten kazancınız geri alınır.

Müşterinin girişini kaldırın (veya VPN profilini kapatın). Ardından gerçek boş birim sayınızı PATCH /plans/stock ile gönderin: ProxyMarket bir iadeden sonra stoğu kendiliğinden geri koyar, ama süre dolduktan sonra koymaz. {"status": "deprovisioned"} ile yanıt verin; yanıt yalnızca günlüğe kaydedilir.

Bu çağrı bir kez gönderilir ve asla tekrarlanmaz. Sunucunuz o anda kapalıysa müşterinin erişimi devam eder. Her siparişi süresi dolduğunda kendi zamanlayıcınızla da bitirin (süreyi /provision’dan bilirsiniz). Kurulumu başarısız olup otomatik iade edilen bir sipariş hiç /deprovision almaz.

Bir siparişi süresi dolmuş olarak işaretleme, yalnızca ProxyMarket’teki durumunu değiştirir; her durumda, iptal edilmiş olsa bile. Müşteriye iade yapmaz, stoğu değiştirmez ve webhook’unuzu çağırmaz.

Bir müşteri IP beyaz listesini veya TCP parmak izini değiştirirse ne olur?

Bir müşteri aktif bir siparişte Proxy Settings’i kaydettiğinde ProxyMarket POST {webhook_url}/update-settings çağrısını yapar. Her sipariş türü için bir kez gönderilir. Sisteminizin desteklediğini uygulayın ve {"status": "ok"} ile yanıt verin; desteklemediğiniz bir alanı yok sayabilirsiniz. Gövdede external_plan_id yoktur, bu yüzden planı provision sırasında kaydettiğiniz order_id’den bulun.

  • ip_whitelist: proxy’yi yalnızca bu IP’ler kullanabilir. Her zaman tek tek adreslerden oluşan bir listedir; [], IP sınırı olmadığı anlamına gelir.
  • tcp_fingerprint: bağlantının hangi işletim sistemi gibi görüneceği (win1 Windows 11, mac1 macOS, ios1 iPhone 15, android1 Galaxy S24 ve diğerleri). null bunu kapatır.

VPN ve VLESS nasıl satarım?

Sipariş akışı aynıdır; yalnızca teslim ettiğiniz şey değişir. Eksiksiz istemci dosyasını, müşterinin içe aktarması gerektiği haliyle gönderin.

ÜrünPlan alanlarıTeslim ettiğiniz
OpenVPNproxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn"Sertifikalar ve anahtarlar içinde olan tam .ovpn metni
WireGuardproxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard"[Interface] ve [Peer] içeren tam .conf
VLESS (Xray)proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless"Tek satırlık bir vless:// bağlantısı veya tam Xray istemci JSON’u
Asla proxy_type: "xray" göndermeyin. Mağaza VLESS planlarını “Xray” olarak gösterir, ama bu etiket vpn_protocol’den gelir. xray API tarafından kabul edilir ve ardından planı bozar: müşteri öder ve yapılandırma hiç gelmez.

Dosyayı teslim etmenin üç yolu:

  • Plandaki herkes için aynı dosya: senkronize ederken onu vpn_config_template’e koyun.
  • Her sipariş için yeni bir dosya: onu /provision’da oluşturun ve vpn_config_file ile yanıt verin.
  • Zaman alan yeni bir dosya: pending ile yanıt verin, ardından vpn_config_file’ı Proxy giriş bilgilerini veya VPN yapılandırmasını teslim etme ile gönderin.

VLESS için her siparişe kendi UUID’sini verin (tek UUID paylaşmak, bir müşteriyi iptal etmenin herkesi iptal etmesi demektir), aktarım yöntemini plan açıklamasında belirtin (örneğin XTLS-Reality veya WS+TLS) ve sipariş bitince UUID’yi inbound’unuzdan kaldırın.

Bir OpenVPN dosyası remote, dev tun veya dev tap ya da hem client hem bir <ca> bloğu içermelidir; tek başına bir <ca> bloğu reddedilir. Her yapılandırma en az 50 karakter olmalıdır.

IP rotasyonu nasıl çalışır?

Teslim ettiğiniz rotation_link, ProxyMarket’in kendisinin düz bir GET ile çağırdığı bir URL’dir (yönlendirmeler izlenir, sertifika kontrol edilmez, 15 saniyelik zaman aşımı). Bunu müşteri Rotate’e bastığında ve müşterinin seçtiği otomatik rotasyon zamanlayıcısında (5 ila 60 dakikada bir) yapar, sipariş bitince durur. Müşteri bağlantıyı da görür ve açabilir.

Planın kendi rotation_link’i yedek olarak verilirse (yukarıya bakın), bu asla başka bir siparişe zaten ait olan bir bağlantı olmaz.

Hazır bir webhook sunucusu var mı?

Evet: ProxyMarket connector (pm-connector), Linux veya Windows sunucunuzda çalışır ve bu sayfadaki her şeyi sizin yerinize yapar. Ona yalnızca sisteminizde müşterinin giriş bilgilerini ekleyip silen küçük bir betik verirsiniz; Python, Node.js ve shell için hazır betikler kendi sayfasındadır.

  • Webhook’lara imza kontrolüyle yanıt verir, müşterinin kullanıcı adını ve şifresini sisteminizde oluşturur ve kiralama bitince siler.
  • ProxyMarket’e ProxyMarket hook üzerinden ulaşır (anahtar türü ProxyMarket hook): market-hook-service.xproxy.io’ya giden tek bir bağlantı; bu yüzden sunucunun açık porta ve alan adına ihtiyacı yoktur. Müşteriler her zaman proxy portunuza doğrudan bağlanır.
  • Kesintiden sonra eksikleri tamamlar: çevrimdışıyken biten siparişlerin kullanıcıları, connector geri gelir gelmez kaldırılır.

Planları Vendor Dashboard’da oluşturursunuz. ProxyMarket’in hook yerine kendi HTTPS adresinizi çağırmasını istiyorsanız kendi adresinizi kullanma bölümüne bakın.

Nasıl ödeme alırım?

PayınızHer satışın %70’i (standart oran; satıcı bazında kararlaştırılabilir)
ProxyMarket payı%30, mağaza, ödemeler, destek ve iadeler için
Ne zaman eklenirMüşterinin ödemesi onaylanıp sipariş aktif olur olmaz, /provision’ınız çağrılmadan önce
Nerede görülürSatıcı panelinizdeki Earnings: her satış, tutarı, sizin tutarınız ve kullanılan oranla
ÖdemelerProxyMarket yöneticisi tarafından bakiyenizden ödenir. Çekmek istediğinizde Telegram’dan yazın.
İadelerOtomatik bir iade (120 saniye içinde hiçbir şey teslim edilmedi) veya yönetici iadesi kazancı bakiyenizden düşer. Promosyon kodu satış tutarını, onunla birlikte de payınızı düşürür.
Para çekmeBir ödeme en fazla bakiyeniz kadar olabilir ve en eski ödenmemiş kazançlarınızı ödendi olarak işaretler.

Oran her satışla birlikte kaydedilir; bu yüzden sonraki bir oran değişikliği zaten kazandığınız paraya asla dokunmaz.

Planlarım mağazada nerede görünür?

Browse planları en ucuzdan başlayarak listeler; fiyat belirlemeden önce bilmeniz gereken bir kural var: XProxy yazılımı çalıştıran satıcıların planları önce gelir, Powered by xProxy başlığı altında ve xProxy rozetiyle. Kendi connector’ınızdan gelen planlar ardından, Other vendors başlığı altında, yine en ucuzdan başlayarak gelir.

NeredeSırayı ne belirler
Browse, varsayılanÖnce XProxy grubu, sonra sizinki; her biri en ucuzdan başlayarak
Browse, müşteri sıraladığındaSıralama her grubun içinde uygulanır; bu yüzden sizin daha ucuz planınız yine XProxy grubunun altında kalır
Ana sayfadaki “from $X” kartlarıHer kategorinin en ucuz XProxy planı; sizinki yalnızca XProxy’nin orada stoğu yoksa
Ülke, protokol ve arama filtreleri, mağaza sayfanızHer satıcı için tamamen aynı

Listelenen her şey tek bir gruba aitse Browse başlıksız tek düz bir liste gösterir. Müşterilerin çoğu bir ülkeye veya protokole göre filtreleyerek gelir; orada planlarınız herkesinkinin yanında durur.

Hata kodları ne anlama gelir?

KodAnlamıYapmanız gereken
401Invalid API key (yanlış veya kapatılmış anahtar), Missing API key (boş başlık) veya Vendor inactiveX-API-Key başlığını ve anahtarın panelde açık olduğunu kontrol edin
403Satıcı başvurunuz hâlâ beklemede (her çağrıda) veya hesap onaylı bir satıcı değil (anahtar oluşturma)Onayı bekleyin
404Bilinmeyen external_id veya order_idKimliği kontrol edin; önce planı senkronize edin
409Artık ödenmiş veya aktif olmayan bir siparişe giriş bilgisi teslim etmekGenellikle 120 saniye geçmiş ve sipariş iade edilmiştir. Tekrar denemeyin
422Bir değer geçersiz veya X-API-Key başlığı hiç yokYanıttaki detail alanı adlandırır
500ProxyMarket hatasıGiderek artan bir bekleme süresiyle tekrar deneyin

Hatalar {"detail": "…"} olarak döner. Yayınlanmış bir istek sınırı yoktur; sıkı bir döngüde değil, değişiklik olduğunda senkronize edin.

Tam bir örnek var mı?

Evet. Bu Python connector bir proxy planını senkronize eder, 5 dakikada bir sağlık durumunu bildirir ve dört webhook’un hepsine yanıt verir. En üstteki iki fonksiyonu kendi sisteminize yapılan çağrılarla değiştirin ve süresi dolan her siparişi bitiren bir zamanlayıcı ekleyin.

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)

Tam API referansı nerede?

Her çağrı ve webhook, tüm alanları, örnek yanıtları ve curl, Python, Node.js ve PHP kodlarıyla ProxyMarket API referansında yer alır. OpenAPI 3.1 dosyası market.openapi.yaml adresindedir.

YönEndpointNe yapar
Siz çağırırsınızPOST /api/vendor/integrationsAPI anahtarınızı oluşturur
Siz çağırırsınızPOST /plans/syncPlanları yayınlar veya günceller
Siz çağırırsınızPATCH /plans/stockStoğu ve görünürlüğü değiştirir
Siz çağırırsınızDELETE /plans/{external_id}Bir planı satıştan kaldırır
Siz çağırırsınızPOST /healthProxy’lerinizin durumunu bildirir
Siz çağırırsınızPOST /orders/{order_id}/credentialsGiriş bilgilerini veya yapılandırmayı sonradan teslim eder
Siz çağırırsınızPOST /orders/{order_id}/expireBir siparişi süresi dolmuş olarak işaretler (iade yok)
Biz sizi çağırırızHEAD /healthPlanlarınızı listede tutan sağlık kontrolü
Biz sizi çağırırızPOST /provisionBir müşteri ödedi: teslim edin
Biz sizi çağırırızPOST /deprovisionBir sipariş bitti: erişimi kaldırın
Biz sizi çağırırızPOST /update-settingsYeni bir IP beyaz listesi veya TCP parmak izi uygulayın
Siz çağırırsınızGET /orders/activeAnahtarınıza yönlendirilen ödenmiş ve aktif siparişler

Hangi ülkeleri listeleyebilirim?

Hepsini. Tam İngilizce ülke adını gönderin, örneğin United States, Germany veya Vietnam, ve her planda aynı şekilde yazın: müşteriler tam metne göre filtreler. ProxyMarket adı kontrol etmez; rehberdeki ve satıcı panelindeki liste, kullanılacak yazımdır. pm-connector test, bu listede olmayan bir adı reddeder.

1.13 sürümünde neler değişti?

  • Yeni çağrı: kesintiden sonra eksikleri tamamlamak için Anahtarınıza yönlendirilen siparişleri listeleme (routed_plans ve ETag ile GET /orders/active).
  • Daha güvenli yedek: teslim edilen bir giriş artık plana kopyalanmaz ve başka bir siparişe ait olan bir plan girişi veya rotasyon bağlantısı asla verilmez.
  • Provision zamanlaması: /provision yalnızca ödeme kesinleştikten sonra gönderilir; bu yüzden hemen yapılan bir giriş bilgisi gönderimi kabul edilir. /update-settings her zaman müşterinin az önce kaydettiği değerleri taşır.
  • ProxyMarket connector: NAT arkasında ona nasıl ulaşılacağı dahil hazır bir webhook sunucusu. Connector bölümüne bakın.
  • Şifreli provision yanıtı (isteğe bağlı): düz bir http:// webhook URL’sinde /provision yanıtınızı X-PM-Encrypted: v1 ile mühürleyin. Yukarıya bakın.
  • Plan sabitleme: bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtara gider.
  • Rotasyon: ProxyMarket rotation_link’inizi GET ile çağırır. IP rotasyonu bölümüne bakın.
  • Satıcı panelinde Integration Status sekmesi ve isteğe bağlı X-PM-Connector başlığı.
  • Koda uygun olarak belgelendi: X-API-Key başlığı olmadan 422, başvurunuz beklemedeyken 403, 30 saniyelik provision zaman aşımı, doğrulanmayan ülke ve senkronizasyon portu, protocol’ün varsayılanı HTTP, current_ip olmayan bir /health raporunun onu silmesi, OpenVPN <ca> kuralı ve /update-settings’te external_plan_id olmaması.

SSS

XProxy kullanıyorum. Bunu geliştirmem gerekir mi?

Hayır. Panelde ProxyMarket’i açın (Selling Platform → ProxyMarket); webhook’lar dahil bunların hepsini sizin yerinize yapar. ProxyMarket’te satış sayfasına bakın. Planlarınız ayrıca xProxy rozetini de alır.

Neden tüm planlarım mağazadan kayboldu?

Neredeyse her zaman sağlık kontrolü yüzünden: HEAD {webhook_url}/health üst üste iki kez başarısız oldu (kapalı, 5 saniyeden yavaş, 5xx veya HEAD engellenmiş). Düzeltin; planlar bir sonraki başarılı kontrolden sonra, 10 dakika içinde geri gelir.

API anahtarımı kaybettim. ProxyMarket yeniden gönderebilir mi?

Hayır. Yalnızca bir hash saklanır. Yeni bir anahtar oluşturun ve imzalama anahtarının da onunla birlikte değiştiğini unutmayın.

İmza kontrolüm hep başarısız oluyor. Neden?

Genellikle iki şeyden biri: HMAC gizli anahtarı olarak hex SHA256(api_key) yerine ham API anahtarını kullandınız ya da ham istek gövdesi yerine ayrıştırılıp yeniden kodlanmış JSON’u imzaladınız.

Sunucum teslim edemezse ödeme alır mıyım?

Hayır. 120 saniye içinde kullanılabilir bir şey gelmezse müşteriye iade yapılır ve kazanç bakiyenizden düşülür.

Bir müşteri neden eski bir giriş bilgisi aldı?

/provision’ınız 200 dışında bir durum koduyla yanıt verdi, zaman aşımına uğradı veya geçersiz JSON gönderdi; bu yüzden ProxyMarket planda senkronize ettiğiniz girişi verdi. Teslim edilen bir giriş asla plana kaydedilmez ve plan girişi zaten başka bir siparişe aitse yeniden kullanılmaz (bunun yerine o sipariş iade edilir). Her zaman 200 ile, teslim edemiyorsanız error ile yanıt verin.

Birkaç sunucu bağlayabilir miyim?

Evet. Her sunucu için, her biri kendi webhook URL’siyle bir anahtar oluşturun. Bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtara gider; eski planlar için panelde API Key / Server’ı ayarlayın, aksi halde siparişleri en eski anahtarınıza gider.

Bir müşteri yenileme yaptığında ne olur?

Süresi dolmuş bir siparişi yenilemek normal bir yeni sipariştir. Çalışan bir siparişi yenilemek önce eski sipariş için reason: renewed ile /deprovision, ardından yeni sipariş için yeni bir order_id ile /provision gönderir.

Sırada ne var?

Tam referansı açın veya ProxyMarket’e Telegram’dan sorun.

Hâlâ çözemediniz mi?Bir teknisyen tek kullanımlık bir PIN ile cihazınıza bakabilir ya da Telegram'dan bize yazabilirsiniz.