Integração de vendedor no ProxyMarket: venda seus próprios proxies
Perguntar à IA
Tarefa prontaCrie a integração com o ProxyMarket no seu código
Agentes de código
Claude CodeAbre o app para desktopCodexAbre o app para desktopCursorAbre o app pela webAssistentes de chat
Abrir no ChatGPTNova abaAbrir no ClaudeNova abaCopiar
Ver como MarkdownTexto simples para ferramentas de IAVer o 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 Brazilian Portuguese: https://xproxy.io/pt-BR/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Brazilian Portuguese.
O app abre com o prompt preenchido. Nada é executado até você pressionar Enter.
Venda seus próprios proxies ou VPN no ProxyMarket (market.xproxy.io). Você continua operando seus servidores. O ProxyMarket cuida da loja, recebe os pagamentos e atende os clientes. Um pequeno conector do seu lado liga os dois: ele faz algumas chamadas ao ProxyMarket e responde a quatro webhooks.
Você precisa de: uma conta de vendedor aprovada em market.xproxy.io, um servidor que o ProxyMarket consiga acessar por HTTPS com um certificado válido e alguém que saiba escrever um pequeno serviço web. Cada endpoint, campo e resposta também está na referência da API do ProxyMarket.
Em resumo
Envie seus planos, mantenha o estoque e a saúde dos proxies atualizados e entregue um login mais tarde, se precisar. Toda chamada leva a sua X-API-Key.
Uma verificação de integridade a cada 10 minutos e um webhook quando um cliente paga, quando um pedido termina e quando um cliente altera uma configuração.
Sua parte de cada venda é creditada assim que o pagamento é confirmado. O ProxyMarket fica com 30% pela loja, pagamentos, suporte e reembolsos.
Como funciona?
Quais são os passos para entrar no ar?
Faça nesta ordem. Os passos 1 a 3 preparam a sua conta; os passos 4 a 7 são a integração.
- Crie uma conta normal em market.xproxy.ioVocê
- Peça para virar vendedor (Become Vendor no menu superior)Você
- Aprovação, normalmente em até 24 horas. Até lá, o menu superior mostra Vendor Pending…; mande uma mensagem para @xproxyio com o e-mail da sua conta para agilizarProxyMarket
- Enquanto isso, crie sua verificação de integridade e coloque seu servidor de webhooks no arVocê
- Crie sua API key no painel de vendedorVocê
- Anuncie seus planos, processe os pedidos e verifique as assinaturas dos webhooksVocê
- Faça um pedido de teste real e confira se o cliente recebe um proxy funcionandoVocê + ProxyMarket
Por que criar a verificação de integridade primeiro?
O ProxyMarket verifica seu servidor com HEAD {webhook_url}/health. É o único endpoint que decide se seus planos continuam à venda:
- Quando você cria sua chave, o ProxyMarket o chama uma vez. Um 5xx, uma conexão recusada ou mais de 5 segundos: nada de chave (HTTP 422 com o motivo).
- Depois disso, a cada 10 minutos, enquanto a chave tiver planos à venda, ele o chama de novo. Depois de 2 falhas seguidas, todos os planos atendidos por essa chave ficam ocultos na loja e não podem ser comprados. Uma única resposta boa traz todos de volta sozinha.
| Conta como no ar | Conta como fora do ar |
|---|---|
| Qualquer status abaixo de 500, em até 5 segundos. Sem login e sem corpo. | Um timeout, uma conexão recusada ou qualquer status 5xx. |
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200 # no login, no database, no outside callColoque-o sob a sua URL de webhook: com https://your-vendor-host.com/marketplace, ele responde em /marketplace/health.
HEAD pode esvaziar todo o seu catálogo em cerca de 20 minutos. Faça de /health a rota mais simples que você tem: sem login, sem banco de dados, sem chamada externa, e responda a GET também. Não confunda com Informar a saúde dos seus proxies (POST /api/integration/health). Essa é uma chamada que você faz sobre proxies individuais; ela não mantém seus planos listados.
Como consigo minha API key?
Você mesmo a cria depois que seu pedido de vendedor é aprovado; ninguém a envia para você. No painel de vendedor, dê um nome à chave e informe sua URL de webhook, por exemplo https://your-vendor-host.com/marketplace. Você também pode fazer isso com uma chamada (referência):
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 nowDessa única chave saem dois valores. Não os confunda:
| Valor | O que é | Para que serve |
|---|---|---|
api_key | A própria chave, começando com pm_ | O header X-API-Key de toda chamada que você faz |
signing_key | SHA256(api_key) em hex de 64 caracteres | Verificar o X-Signature de cada webhook (como) |
A chave nunca expira, e a URL de webhook dela não pode ser alterada depois: para trocar de servidor, crie uma nova chave. Se você opera vários servidores independentes, dê a cada um a sua própria chave. Os pedidos vão para a chave definida em API Key / Server de cada plano no painel de vendedor. Um plano criado por uma sincronização recebe a chave que o sincronizou; um plano mais antigo sem essa configuração envia os pedidos para a sua chave ativa mais antiga.
pm-connector test avisa quando um plano vai para outro lugar. Erros: uma chamada sem o header X-API-Key recebe 422, uma chave errada 401, e uma chave cujo pedido de vendedor ainda está pendente 403. A aba Integration Status do painel de vendedor mostra, por chave, quando ela foi vista pela última vez, a versão do conector e as últimas 20 entregas com o resultado.
Como anuncio meus planos?
Envie todos os seus produtos com Publicar ou atualizar seus planos quando o seu conector iniciar, e de novo sempre que algo mudar. Planos sincronizados são aprovados na hora (planos que você adiciona manualmente no painel esperam um admin). O seu external_id é o seu próprio ID para o produto (uma porta, um modem, um pool de VPN), e todas as chamadas e webhooks seguintes o usam.
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"}]}| Bom saber | Por quê |
|---|---|
Enviar o mesmo external_id de novo atualiza o plano | A sincronização pode ser repetida com segurança; ela nunca cria duplicatas. |
| Um plano que você deixa de fora continua à venda | Para parar de vendê-lo, chame Tirar um plano de venda. |
Use apenas mobile, residential, datacenter, isp, ipv6 ou vpn como proxy_type | A API aceita qualquer texto, mas outro valor quebra o pedido: o cliente nunca recebe um login. Veja VPN e VLESS. |
country é o nome completo em inglês, por exemplo United States | Os clientes filtram pelo texto exato, então escreva igual em todos os planos (mais). O ProxyMarket não verifica isso. |
| Um plano só aparece quando está ativo, com estoque, listado e não ocultado pela verificação de integridade | stock normalmente é 1 por porta de modem: um cliente por porta. |
protocol omitido significa HTTP | Envie-o mesmo assim para planos de VPN e SOCKS5. |
| Um plano criado por uma sincronização fica vinculado à chave que o sincronizou | Os pedidos dele vão para essa chave. Uma sincronização nunca muda a chave de um plano que já existe (mais). |
O que acontece quando alguém compra?
- O cliente paga. Seus 70% são creditados no seu saldo na hora, antes mesmo de o seu servidor ser chamado.
- O ProxyMarket chama
POST {webhook_url}/provisioncom oorder_ide o seuexternal_plan_id(payload). Verifique a assinatura e depois crie o acesso do cliente. - Você responde com o login ou a configuração (o ideal), com
pendingou comerror. Veja a tabela abaixo. - O cliente vê o login no ProxyMarket e se conecta ao seu servidor. O ProxyMarket reduz o estoque do plano em um sozinho.
- Quando o tempo acaba, o ProxyMarket encerra o pedido sozinho (ele verifica a cada 5 minutos) e chama
POST {webhook_url}/deprovision. Você remove o acesso e coloca a unidade de volta à venda. Veja Quando um pedido termina.
status que você responde | Quando usar | O que acontece |
|---|---|---|
provisioned (o ideal) | Você consegue criar o acesso na hora | O cliente o recebe imediatamente. Inclua os quatro: proxy_ip, proxy_port, proxy_username, proxy_password, ou vpn_config_file para VPN. |
pending | A preparação demora um pouco | Envie com Entregar o login do proxy ou a configuração da VPN. O ProxyMarket espera 120 segundos no total, contados desde o início; depois disso o pedido é reembolsado e uma entrega atrasada recebe 409. |
error | Você não consegue entregar (porta offline, nenhum perfil livre) | Nada é entregue. Depois dos 120 segundos, o cliente é reembolsado na carteira e o seu ganho é removido. |
/provision responder com outro status, der timeout (depois de 30 segundos), retornar JSON inválido ou disser provisioned com um login incompleto, o ProxyMarket entrega ao cliente o login que você sincronizou no plano, se houver um. Um login entregue nunca é copiado para o plano, e um login do plano que já pertence a outro pedido não é reutilizado: esse pedido é reembolsado. A chamada não é repetida. O expires_at da sua resposta é ignorado: o ProxyMarket conta o tempo a partir da ativação e informa você no /deprovision.
Posso criptografar a resposta em uma URL http:// simples?
Sim, opcionalmente. Responda 200 com os headers X-PM-Encrypted: v1 e X-PM-Signature: sha256= + o HMAC-SHA256 em hex do corpo bruto, com a sua signing key como chave, e o corpo {"enc": "v1", "nonce": "…", "ct": "…"}: um nonce aleatório de 12 bytes e o texto cifrado AES-256-GCM da sua resposta normal (com a tag no final), ambos em base64 padrão. A chave é HKDF-SHA256 sobre os bytes UTF-8 da sua signing key (salt vazio, info pm-provision-v1, 32 bytes), e o AAD é o order_id. O ProxyMarket verifica a assinatura, descriptografa e lê a resposta normalmente; um envelope inválido conta como timeout. O formato completo e um vetor de teste estão na referência da API e na seção 5.1 do guia. O pm-connector faz isso sozinho em uma URL http://. Ainda assim, recomenda-se HTTPS, porque as requisições de webhook não são criptografadas.
Salve o order_id: você precisa dele para entregar mais tarde, para encerrar o pedido você mesmo e para relacionar os outros webhooks.
Como verifico se um webhook vem mesmo do ProxyMarket?
Todo POST de webhook traz X-Signature: sha256=…, um HMAC-SHA256 do corpo bruto. O segredo é a sua signing key, SHA256(api_key) em hex, e não a própria API key. Verifique-a em /provision, /deprovision e /update-settings antes de fazer qualquer outra coisa.
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()
...Use o corpo bruto da requisição. Fazer o parse do JSON e serializá-lo de novo altera os bytes, e a assinatura deixa de bater.
Como testo antes que os clientes comprem?
- De fora da sua rede, execute
curl -I https://your-vendor-host.com/marketplace/healthe confira se recebe um status abaixo de 500 em até 5 segundos. - Sincronize um plano e encontre-o em Browse em market.xproxy.io.
- Faça um pedido real dele. Seu servidor deve receber o
/provisioncom uma assinatura válida, e o login deve aparecer no pedido do cliente. - Conecte-se com esse login, espere o pedido terminar (ou peça pelo Telegram para encerrá-lo) e confira se o
/deprovisionremove o acesso e o estoque volta.
Avise o ProxyMarket pelo Telegram @xproxyio quando fizer o pedido de teste, para que ele também seja verificado do lado deles.
Como mantenho o estoque e a saúde atualizados?
| Quando isto acontece do seu lado | Chamada |
|---|---|
| Um modem ou servidor fica offline | PATCH /plans/stock com stock: 0, is_active: false |
| Ele volta a ficar online, ou uma porta vendida fica livre de novo | PATCH /plans/stock com stock: 1, is_active: true |
| Um preço, nome ou configuração muda | POST /plans/sync só com esse plano |
| Você para de vender um produto | DELETE /plans/{external_id} |
| Opcional, a cada poucos minutos | POST /health com o estado e o IP atual de cada proxy. Sempre inclua current_ip: omiti-lo apaga o IP salvo. Isso não mantém seus planos listados; quem faz isso é a verificação de integridade do seu servidor. |
Todos os caminhos começam com https://market.xproxy.io/api/integration.
O que acontece quando um pedido termina?
O ProxyMarket chama POST {webhook_url}/deprovision com um reason:
| Motivo | Significado |
|---|---|
expired | O tempo de aluguel acabou. Enviado automaticamente, com até 5 minutos de atraso. |
renewed | O cliente pagou para renovar um pedido em andamento. O pedido antigo termina agora e em seguida vem um novo /provision com um novo order_id. |
cancelled | Um admin cancelou o pedido. |
admin_refund | Um admin reembolsou o cliente. O seu ganho com ele é estornado. |
Remova o login do cliente (ou desative o perfil de VPN dele). Depois, envie o seu número real de unidades livres com PATCH /plans/stock: o ProxyMarket devolve o estoque sozinho depois de um reembolso, mas não depois de uma expiração. Responda {"status": "deprovisioned"}; a resposta só é registrada no log.
/provision). Um pedido que falhou no provisionamento e foi reembolsado automaticamente não recebe /deprovision. Marcar um pedido como expirado só muda o status dele no ProxyMarket, em qualquer estado, mesmo cancelado. Não reembolsa o cliente, não altera o estoque e não chama o seu webhook.
E se um cliente alterar a whitelist de IPs ou o fingerprint TCP?
Quando um cliente salva Proxy Settings em um pedido ativo, o ProxyMarket chama POST {webhook_url}/update-settings. Ele é enviado uma vez, para qualquer tipo de pedido. Aplique o que o seu sistema suporta e responda {"status": "ok"}; você pode ignorar um campo que não suporta. O corpo não tem external_plan_id, então encontre o plano pelo order_id que você salvou no provisionamento.
ip_whitelist: só esses IPs podem usar o proxy. Sempre uma lista de endereços individuais;[]significa sem limite de IP.tcp_fingerprint: com qual sistema operacional a conexão deve parecer (win1Windows 11,mac1macOS,ios1iPhone 15,android1Galaxy S24, entre outros).nulldesativa.
Como vendo VPN e VLESS?
O fluxo do pedido é o mesmo; só muda o que você entrega. Envie o arquivo de cliente completo, exatamente como o cliente deve importá-lo.
| Produto | Campos do plano | Você entrega |
|---|---|---|
| OpenVPN | proxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn" | O texto .ovpn completo, com certificados e chaves dentro |
| WireGuard | proxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard" | O .conf completo, com [Interface] e [Peer] |
| VLESS (Xray) | proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless" | Um link vless:// de uma linha, ou o JSON completo do cliente Xray |
proxy_type: "xray". A loja mostra os planos VLESS como “Xray”, mas esse rótulo vem de vpn_protocol. A API aceita xray e depois isso quebra o plano: o cliente paga e a configuração nunca chega. Três formas de entregar o arquivo:
- O mesmo arquivo para todos do plano: coloque-o em
vpn_config_templateao sincronizar. - Um arquivo novo por pedido: crie-o no
/provisione responda comvpn_config_file. - Um arquivo novo que demora: responda
pendinge depois envievpn_config_filecom Entregar o login do proxy ou a configuração da VPN.
Para VLESS, dê a cada pedido o seu próprio UUID (compartilhar um significa que revogar um cliente revoga todos), informe o transporte na descrição do plano (por exemplo XTLS-Reality ou WS+TLS) e remova o UUID do seu inbound quando o pedido terminar.
Um arquivo OpenVPN precisa conter remote, dev tun ou dev tap, ou então client e um bloco <ca> juntos; um bloco <ca> sozinho é rejeitado. Toda configuração precisa ter pelo menos 50 caracteres.
Como funciona a rotação de IP?
O rotation_link que você entrega é uma URL que o próprio ProxyMarket chama, com um GET simples (segue redirecionamentos, não verifica o certificado, timeout de 15 segundos). Ele faz isso quando o cliente clica em Rotate e no timer de rotação automática que o cliente escolhe (a cada 5 a 60 minutos), e para quando o pedido termina. O cliente também vê o link e pode abri-lo.
Se o rotation_link do próprio plano for entregue como fallback (veja acima), ele nunca será um que já pertence a outro pedido.
Existe um servidor de webhooks pronto?
Sim: o conector do ProxyMarket (pm-connector) roda no seu servidor Linux ou Windows e faz por você tudo o que está nesta página. Você só entrega a ele um pequeno script que cria e apaga o login de um cliente no seu sistema; scripts prontos em Python, Node.js e shell estão na página dele.
- Ele responde aos webhooks com verificação de assinatura, cria o usuário e a senha do cliente no seu sistema e os apaga quando o aluguel termina.
- Ele acessa o ProxyMarket pelo ProxyMarket hook (tipo de chave ProxyMarket hook): uma conexão de saída para
market-hook-service.xproxy.io, então o servidor não precisa de porta aberta nem de domínio. Os clientes sempre se conectam diretamente à porta do seu proxy. - Ele se atualiza depois de um período fora do ar: os pedidos que terminaram enquanto ele estava offline perdem o usuário assim que ele volta.
Você cria os planos no Vendor Dashboard. Se quiser que o ProxyMarket chame o seu próprio endereço HTTPS em vez do hook, veja como usar seu próprio endereço.
Como eu recebo?
| Sua parte | 70% de cada venda (a taxa padrão; pode ser negociada por vendedor) |
|---|---|
| Parte do ProxyMarket | 30%, pela loja, pagamentos, suporte e reembolsos |
| Quando é creditado | Assim que o pagamento do cliente é confirmado e o pedido fica ativo, antes de o seu /provision ser chamado |
| Onde ver | Earnings no seu painel de vendedor: cada venda com o valor, o seu valor e a taxa usada |
| Pagamentos | Feitos pelo admin do ProxyMarket a partir do seu saldo. Peça no Telegram quando quiser sacar. |
| Reembolsos | Um reembolso automático (nada entregue em 120 segundos) ou um reembolso feito por um admin remove o ganho do seu saldo. Um código promocional reduz o valor da venda e, com ele, a sua parte. |
| Saque | Um saque pode ser de até o seu saldo e marca como pagos os seus ganhos não pagos mais antigos. |
A taxa é salva com cada venda, então uma mudança de taxa posterior nunca afeta o dinheiro que você já ganhou.
Onde meus planos aparecem na loja?
Browse lista os planos do mais barato para o mais caro, com uma regra para saber antes de definir preços: os planos de vendedores que usam o software XProxy vêm primeiro, em Powered by xProxy, com o selo xProxy. Os planos do seu próprio conector vêm depois, em Other vendors, também do mais barato para o mais caro.
| Onde | O que decide a ordem |
|---|---|
| Browse, padrão | Primeiro o grupo XProxy, depois o seu, cada um do mais barato para o mais caro |
| Browse, quando o cliente ordena | A ordenação vale dentro de cada grupo, então um plano seu mais barato continua abaixo do grupo XProxy |
| Cards “from $X” da página inicial | O plano XProxy mais barato de cada categoria; o seu só quando o XProxy não tem estoque ali |
| Filtros de país, protocolo e busca, sua página de loja | Exatamente iguais para todos os vendedores |
Quando tudo o que está listado pertence a um único grupo, Browse mostra uma lista única, sem títulos. A maioria dos clientes chega filtrando por país ou protocolo, e aí seus planos ficam ao lado dos de todos os outros.
O que significam os códigos de erro?
| Código | Significado | O que fazer |
|---|---|---|
401 | Invalid API key (chave errada ou desativada), Missing API key (header vazio) ou Vendor inactive | Confira o header X-API-Key e se a chave está ativa no painel |
403 | Seu pedido de vendedor ainda está pendente (em qualquer chamada), ou a conta não é de um vendedor aprovado (criação de chave) | Aguarde a aprovação |
404 | external_id ou order_id desconhecido | Confira o ID; sincronize o plano primeiro |
409 | Entrega de credenciais para um pedido que não está mais pago ou ativo | Normalmente os 120 segundos passaram e o pedido foi reembolsado. Não tente de novo |
422 | Um valor não é válido, ou falta totalmente o header X-API-Key | O detail na resposta indica o campo |
500 | Erro do ProxyMarket | Tente de novo com um intervalo crescente |
Os erros voltam como {"detail": "…"}. Não há limites de requisição publicados; sincronize quando algo mudar, e não em um loop apertado.
Existe um exemplo completo?
Sim. Este conector em Python sincroniza um plano de proxy, informa a saúde a cada 5 minutos e responde aos quatro webhooks. Substitua as duas funções do topo por chamadas ao seu próprio sistema e adicione um timer que encerre cada pedido quando o tempo dele acabar.
"""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)Onde está a referência completa da API?
Cada chamada e webhook, com todos os campos, exemplos de resposta e código em curl, Python, Node.js e PHP, está na referência da API do ProxyMarket. O arquivo OpenAPI 3.1 está em market.openapi.yaml.
| Direção | Endpoint | O que faz |
|---|---|---|
| Você chama | POST /api/vendor/integrations | Criar sua API key |
| Você chama | POST /plans/sync | Publicar ou atualizar planos |
| Você chama | PATCH /plans/stock | Alterar estoque e visibilidade |
| Você chama | DELETE /plans/{external_id} | Tirar um plano de venda |
| Você chama | POST /health | Informar o estado dos seus proxies |
| Você chama | POST /orders/{order_id}/credentials | Entregar um login ou configuração mais tarde |
| Você chama | POST /orders/{order_id}/expire | Marcar um pedido como expirado (sem reembolso) |
| Nós chamamos você | HEAD /health | Verificação de integridade que mantém seus planos listados |
| Nós chamamos você | POST /provision | Um cliente pagou: entregue |
| Nós chamamos você | POST /deprovision | Um pedido terminou: remova o acesso |
| Nós chamamos você | POST /update-settings | Aplicar uma nova whitelist de IPs ou fingerprint TCP |
| Você chama | GET /orders/active | Os pedidos pagos e ativos direcionados à sua chave |
Quais países posso anunciar?
Qualquer um. Envie o nome completo do país em inglês, por exemplo United States, Germany ou Vietnam, e escreva igual em todos os planos: os clientes filtram pelo texto exato. O ProxyMarket não verifica o nome; a lista no guia e no painel de vendedor é a grafia a usar. O pm-connector test rejeita um nome que não está nessa lista.
O que mudou na versão 1.13?
- Nova chamada: Listar os pedidos direcionados à sua chave (
GET /orders/active, comrouted_planse ETag), para se atualizar depois de um período fora do ar. - Fallback mais seguro: um login entregue não é mais copiado para o plano, e um login ou link de rotação do plano que pertence a outro pedido nunca é entregue.
- Momento do provisionamento: o
/provisionsó é enviado depois que o pagamento é registrado, então um envio imediato de credenciais é aceito. O/update-settingssempre traz os valores que o cliente acabou de salvar. - Conector do ProxyMarket: um servidor de webhooks pronto, incluindo como acessá-lo atrás de NAT. Veja o conector.
- Resposta de provisionamento criptografada (opcional): em uma URL de webhook
http://simples, proteja a sua resposta do/provisioncomX-PM-Encrypted: v1. Veja acima. - Vínculo do plano: um plano criado por uma sincronização vai para a chave que o sincronizou.
- Rotação: o ProxyMarket chama o seu
rotation_linkcomGET. Veja Rotação de IP. - Aba Integration Status no painel de vendedor e o header opcional
X-PM-Connector. - Documentado para bater com o código: 422 sem o header
X-API-Key, 403 enquanto o seu pedido está pendente, timeout de 30 segundos no provisionamento, país e porta de sincronização não validados,protocolpadrão HTTP, um relatório/healthsemcurrent_ipapaga o IP, a regra do<ca>no OpenVPN e nenhumexternal_plan_idno/update-settings.
Perguntas frequentes
Uso o XProxy. Preciso construir isso?
Não. Ative o ProxyMarket no painel (Selling Platform → ProxyMarket) e ele faz tudo isso por você, incluindo os webhooks. Veja Vender no ProxyMarket. Seus planos também ganham o selo xProxy.
Por que todos os meus planos sumiram da loja?
Quase sempre é a verificação de integridade: HEAD {webhook_url}/health falhou duas vezes seguidas (fora do ar, mais lento que 5 segundos, um 5xx ou HEAD bloqueado). Corrija e os planos voltam depois da próxima verificação boa, em até 10 minutos.
Perdi minha API key. O ProxyMarket pode enviá-la de novo?
Não. Só um hash é guardado. Crie uma nova chave e lembre-se de que a signing key muda junto.
Minha verificação de assinatura sempre falha. Por quê?
Normalmente é uma de duas coisas: você usou a API key pura como segredo do HMAC em vez de SHA256(api_key) em hex, ou assinou o JSON já parseado e recodificado em vez do corpo bruto da requisição.
Recebo se o meu servidor não conseguir entregar?
Não. Se nada utilizável chegar em 120 segundos, o cliente é reembolsado e o ganho é removido do seu saldo.
Por que um cliente recebeu um login antigo?
O seu /provision respondeu com um status diferente de 200, deu timeout ou enviou JSON inválido, então o ProxyMarket entregou o login que você sincronizou no plano. Um login entregue nunca é salvo no plano, e o login do plano não é reutilizado quando já pertence a outro pedido (nesse caso, o pedido é reembolsado). Sempre responda 200, com error se não conseguir entregar.
Posso conectar vários servidores?
Sim. Crie uma chave por servidor, cada uma com a sua URL de webhook. Um plano criado por uma sincronização vai para a chave que o sincronizou; para planos mais antigos, defina API Key / Server no painel, senão os pedidos deles vão para a sua chave mais antiga.
O que acontece quando um cliente renova?
Renovar um pedido expirado é um pedido novo normal. Renovar um pedido em andamento primeiro envia /deprovision com reason: renewed para o pedido antigo e depois /provision para o novo, com um novo order_id.
E agora?
Abra a referência completa ou pergunte ao ProxyMarket pelo Telegram.

