Integración de vendedores de ProxyMarket: vende tus propios proxies
Preguntar a la IA
Tarea listaCrea la integración con ProxyMarket en tu código
Agentes de código
Claude CodeAbre la app de escritorioCodexAbre la app de escritorioCursorAbre la app desde la webAsistentes de chat
Abrir en ChatGPTNueva pestañaAbrir en ClaudeNueva pestañaCopiar
Ver como MarkdownTexto plano para herramientas de IAVer el 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 Spanish: https://xproxy.io/es/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Spanish.
La app se abre con el prompt ya escrito. No se ejecuta nada hasta que pulses Enter.
Vende tus propios proxies o VPN en ProxyMarket (market.xproxy.io). Tú sigues gestionando tus servidores. ProxyMarket gestiona la tienda, cobra los pagos y atiende a los clientes. Un pequeño conector en tu lado une ambos: hace unas pocas llamadas a ProxyMarket y responde a cuatro webhooks.
Necesitas: una cuenta de vendedor aprobada en market.xproxy.io, un servidor al que ProxyMarket pueda llegar por HTTPS con un certificado válido, y alguien que sepa escribir un pequeño servicio web. Cada endpoint, campo y respuesta también está en la referencia de la API de ProxyMarket.
En resumen
Envía tus planes, mantén al día el stock y el estado de los proxies, y entrega un acceso más tarde si lo necesitas. Cada llamada lleva tu X-API-Key.
Una comprobación de estado cada 10 minutos y un webhook cuando un cliente paga, cuando termina un pedido y cuando un cliente cambia un ajuste.
Tu parte de cada venta se abona en cuanto se confirma el pago. ProxyMarket se queda con el 30 % por la tienda, los pagos, el soporte y los reembolsos.
¿Cómo funciona?
¿Qué pasos hay que seguir para empezar a vender?
Hazlos en este orden. Los pasos 1 a 3 configuran tu cuenta; los pasos 4 a 7 son la integración.
- Crea una cuenta normal en market.xproxy.ioTú
- Solicita ser vendedor (Become Vendor en el menú superior)Tú
- Aprobación, normalmente en 24 horas. Hasta entonces, el menú superior muestra Vendor Pending…; escribe a @xproxyio con el email de tu cuenta para acelerarlaProxyMarket
- Mientras tanto, crea tu comprobación de estado y pon en línea tu servidor de webhooksTú
- Crea tu clave API en el panel de vendedorTú
- Publica tus planes, gestiona los pedidos y comprueba las firmas de los webhooksTú
- Haz un pedido de prueba real y comprueba que el cliente recibe un proxy que funcionaTú + ProxyMarket
¿Por qué crear primero la comprobación de estado?
ProxyMarket comprueba tu servidor con HEAD {webhook_url}/health. Es el único endpoint que decide si tus planes siguen a la venta:
- Cuando creas tu clave, ProxyMarket lo llama una vez. Un 5xx, una conexión rechazada o más de 5 segundos: no hay clave (HTTP 422 con el motivo).
- Después, cada 10 minutos, mientras la clave tenga planes a la venta, lo vuelve a llamar. Tras 2 fallos seguidos, todos los planes que atiende esa clave se ocultan de la tienda y no se pueden comprar. Una sola respuesta correcta los vuelve a mostrar todos automáticamente.
| Cuenta como activo | Cuenta como caído |
|---|---|
| Cualquier estado por debajo de 500, en menos de 5 segundos. No hace falta acceso ni cuerpo. | Un tiempo de espera agotado, una conexión rechazada o cualquier estado 5xx. |
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200 # no login, no database, no outside callColócalo bajo tu webhook URL: con https://your-vendor-host.com/marketplace responde en /marketplace/health.
HEAD puede vaciar todo tu catálogo en unos 20 minutos. Haz que /health sea la ruta más sencilla que tengas: sin acceso, sin base de datos, sin llamadas externas, y que responda también a GET. No lo confundas con Informar del estado de tus proxies (POST /api/integration/health). Esa es una llamada que haces tú sobre proxies concretos; no mantiene tus planes publicados.
¿Cómo obtengo mi clave API?
La creas tú mismo en cuanto se aprueba tu solicitud de vendedor; nadie te la envía. En el panel de vendedor, da a la clave un nombre y tu webhook URL, por ejemplo https://your-vendor-host.com/marketplace. También puedes hacerlo con una llamada (referencia):
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 nowDe esa clave obtienes dos valores. No los mezcles:
| Valor | Qué es | Para qué sirve |
|---|---|---|
api_key | La clave en sí, que empieza por pm_ | La cabecera X-API-Key de cada llamada que haces |
signing_key | SHA256(api_key) en hexadecimal de 64 caracteres | Comprobar la X-Signature de cada webhook (cómo) |
La clave nunca caduca y su webhook URL no se puede cambiar después: para cambiar de servidor, crea una clave nueva. Si tienes varios servidores independientes, da a cada uno su propia clave. Los pedidos van a la clave indicada en API Key / Server de cada plan en el panel de vendedor. Un plan creado por una sincronización recibe la clave que lo sincronizó; un plan antiguo sin ese ajuste envía sus pedidos a tu clave activa más antigua.
pm-connector test avisa cuando un plan va a otro sitio. Errores: una llamada sin la cabecera X-API-Key recibe 422, una clave incorrecta 401 y una clave cuya solicitud de vendedor sigue pendiente 403. La pestaña Integration Status del panel de vendedor muestra, por clave, cuándo se vio por última vez, la versión del conector y las 20 últimas entregas con su resultado.
¿Cómo publico mis planes?
Envía todos tus productos con Publicar o actualizar tus planes cuando arranque tu conector, y de nuevo cada vez que algo cambie. Los planes sincronizados se aprueban al instante (los que añades a mano en el panel esperan a un administrador). Tu external_id es tu propio ID del producto (un puerto, un módem, un grupo de VPN), y todas las llamadas y webhooks posteriores lo usan.
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"}]}| Conviene saber | Por qué |
|---|---|
Enviar de nuevo el mismo external_id actualiza el plan | Puedes repetir la sincronización sin problema; nunca crea duplicados. |
| Un plan que no incluyes sigue a la venta | Para dejar de venderlo, llama a Retirar un plan de la venta. |
Usa solo mobile, residential, datacenter, isp, ipv6 o vpn como proxy_type | La API acepta cualquier texto, pero otro valor rompe el pedido: el cliente nunca recibe un acceso. Consulta VPN y VLESS. |
country es el nombre completo en inglés, por ejemplo United States | Los clientes filtran por el texto exacto, así que escríbelo igual en todos los planes (más). ProxyMarket no lo comprueba. |
| Un plan solo se muestra cuando está activo, tiene stock, está publicado y no lo ha ocultado la comprobación de estado | Normalmente stock es 1 por puerto de módem: un cliente por puerto. |
Si omites protocol, se usa HTTP | Envíalo de todos modos en los planes VPN y SOCKS5. |
| Un plan creado por una sincronización queda vinculado a la clave que lo sincronizó | Sus pedidos van a esa clave. Una sincronización nunca cambia la clave de un plan que ya existe (más). |
¿Qué ocurre cuando alguien compra?
- El cliente paga. Tu 70 % se abona en tu saldo al instante, incluso antes de llamar a tu servidor.
- ProxyMarket llama a
POST {webhook_url}/provisioncon elorder_idy tuexternal_plan_id(payload). Comprueba la firma y después crea el acceso del cliente. - Respondes con el acceso o la configuración (lo mejor), con
pendingo conerror. Consulta la tabla de abajo. - El cliente ve el acceso en ProxyMarket y se conecta a tu servidor. ProxyMarket baja en uno el stock del plan automáticamente.
- Cuando se acaba el tiempo, ProxyMarket termina el pedido automáticamente (lo comprueba cada 5 minutos) y llama a
POST {webhook_url}/deprovision. Tú eliminas el acceso y vuelves a poner la unidad a la venta. Consulta Cuando termina un pedido.
status que respondes | Cuándo usarlo | Qué ocurre |
|---|---|---|
provisioned (lo mejor) | Puedes crear el acceso al momento | El cliente lo recibe al instante. Incluye los cuatro valores proxy_ip, proxy_port, proxy_username, proxy_password, o vpn_config_file para VPN. |
pending | Prepararlo lleva un tiempo | Envíalo con Entregar el acceso al proxy o la configuración de VPN. ProxyMarket espera 120 segundos en total, contados desde el inicio; después, el pedido se reembolsa y una entrega tardía recibe 409. |
error | No puedes entregarlo (puerto fuera de línea, sin perfil libre) | No se entrega nada. Pasados los 120 segundos, al cliente se le reembolsa en su monedero y se elimina tu ganancia. |
/provision responde con otro estado, agota el tiempo de espera (a los 30 segundos), devuelve JSON no válido o dice provisioned con un acceso incompleto, ProxyMarket entrega al cliente el acceso que sincronizaste en el plan, si lo hay. Un acceso entregado nunca se copia en el plan, y un acceso del plan que ya pertenece a otro pedido no se reutiliza: ese pedido se reembolsa. La llamada no se reintenta. El expires_at de tu respuesta se ignora: ProxyMarket cuenta el tiempo desde la activación y te lo indica en /deprovision.
¿Puedo cifrar la respuesta en una URL http:// sin cifrar?
Sí, de forma opcional. Responde 200 con las cabeceras X-PM-Encrypted: v1 y X-PM-Signature: sha256= + el HMAC-SHA256 en hexadecimal del cuerpo sin procesar con tu clave de firma, y el cuerpo {"enc": "v1", "nonce": "…", "ct": "…"}: un nonce aleatorio de 12 bytes y el texto cifrado AES-256-GCM de tu respuesta normal (con la etiqueta al final), ambos en base64 estándar. La clave es HKDF-SHA256 sobre los bytes UTF-8 de tu clave de firma (salt vacío, info pm-provision-v1, 32 bytes), y el AAD es el order_id. ProxyMarket comprueba la firma, descifra y lee la respuesta como siempre; un sobre incorrecto cuenta como un tiempo de espera agotado. El formato completo y un vector de prueba están en la referencia de la API y en la sección 5.1 de la guía. pm-connector lo hace por sí solo en una URL http://. Se sigue recomendando HTTPS, porque las peticiones de los webhooks no van cifradas.
Guarda el order_id: lo necesitas para entregar más tarde, para terminar el pedido tú mismo y para relacionar los demás webhooks.
¿Cómo compruebo que un webhook viene realmente de ProxyMarket?
Cada POST de webhook lleva X-Signature: sha256=…, un HMAC-SHA256 del cuerpo sin procesar. El secreto es tu clave de firma, SHA256(api_key) en hexadecimal, no la propia clave API. Compruébalo en /provision, /deprovision y /update-settings antes de hacer nada más.
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()
...Usa el cuerpo sin procesar de la petición. Si analizas el JSON y lo vuelves a serializar, cambian los bytes y la firma ya no coincide.
¿Cómo hago pruebas antes de que compren los clientes?
- Desde fuera de tu red, ejecuta
curl -I https://your-vendor-host.com/marketplace/healthy comprueba que obtienes un estado por debajo de 500 en menos de 5 segundos. - Sincroniza un plan y búscalo en Browse, en market.xproxy.io.
- Haz un pedido real de ese plan. Tu servidor debería recibir
/provisioncon una firma válida, y el acceso debería aparecer en el pedido del cliente. - Conéctate con ese acceso, espera a que termine el pedido (o pide por Telegram que lo terminen) y comprueba que
/deprovisionelimina el acceso y que el stock vuelve.
Avisa a ProxyMarket por Telegram @xproxyio cuando hagas el pedido de prueba, para que también puedan revisarlo desde su lado.
¿Cómo mantengo al día el stock y el estado?
| Cuando ocurre esto en tu lado | Llamada |
|---|---|
| Un módem o un servidor se queda fuera de línea | PATCH /plans/stock con stock: 0, is_active: false |
| Vuelve a estar en línea, o un puerto vendido vuelve a quedar libre | PATCH /plans/stock con stock: 1, is_active: true |
| Cambia un precio, un nombre o una configuración | POST /plans/sync solo con ese plan |
| Dejas de vender un producto | DELETE /plans/{external_id} |
| Opcional, cada pocos minutos | POST /health con el estado y la IP actual de cada proxy. Incluye siempre current_ip: si lo omites, se borra la IP guardada. No mantiene tus planes publicados; eso lo hace la comprobación de estado de tu servidor. |
Todas las rutas empiezan por https://market.xproxy.io/api/integration.
¿Qué ocurre cuando termina un pedido?
ProxyMarket llama a POST {webhook_url}/deprovision con un reason:
| Motivo | Significado |
|---|---|
expired | El tiempo de alquiler ha terminado. Se envía automáticamente, con hasta 5 minutos de retraso. |
renewed | El cliente pagó para renovar un pedido en curso. El pedido antiguo termina ahora y le sigue un nuevo /provision con un order_id nuevo. |
cancelled | Un administrador canceló el pedido. |
admin_refund | Un administrador reembolsó al cliente. Se retira tu ganancia por ese pedido. |
Elimina el acceso del cliente (o desactiva su perfil de VPN). Después envía tu número real de unidades libres con PATCH /plans/stock: ProxyMarket repone el stock automáticamente tras un reembolso, pero no tras una caducidad. Responde {"status": "deprovisioned"}; la respuesta solo se registra.
/provision). Un pedido cuyo aprovisionamiento falló y se reembolsó automáticamente no recibe ningún /deprovision. Marcar un pedido como caducado solo cambia su estado en ProxyMarket, en cualquier situación, incluso si está cancelado. No reembolsa al cliente, no cambia el stock y no llama a tu webhook.
¿Y si un cliente cambia su lista blanca de IP o su huella TCP?
Cuando un cliente guarda Proxy Settings en un pedido activo, ProxyMarket llama a POST {webhook_url}/update-settings. Se envía una vez, para cualquier tipo de pedido. Aplica lo que admita tu sistema y responde {"status": "ok"}; puedes ignorar un campo que no admitas. El cuerpo no incluye external_plan_id, así que localiza el plan a partir del order_id que guardaste al aprovisionar.
ip_whitelist: solo estas IP pueden usar el proxy. Siempre es una lista de direcciones sueltas;[]significa sin límite de IP.tcp_fingerprint: a qué sistema operativo debe parecerse la conexión (win1Windows 11,mac1macOS,ios1iPhone 15,android1Galaxy S24, y más).nulllo desactiva.
¿Cómo vendo VPN y VLESS?
El flujo del pedido es el mismo; solo cambia lo que entregas. Envía el archivo de cliente completo, tal como el cliente debe importarlo.
| Producto | Campos del plan | Qué entregas |
|---|---|---|
| OpenVPN | proxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn" | El texto .ovpn completo, con los certificados y las claves dentro |
| WireGuard | proxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard" | El .conf completo con [Interface] y [Peer] |
| VLESS (Xray) | proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless" | Un enlace vless:// de una línea, o el JSON completo de cliente Xray |
proxy_type: "xray". La tienda muestra los planes VLESS como «Xray», pero esa etiqueta sale de vpn_protocol. La API acepta xray y luego el plan deja de funcionar: el cliente paga y la configuración nunca llega. Tres formas de entregar el archivo:
- El mismo archivo para todos los clientes del plan: ponlo en
vpn_config_templateal sincronizar. - Un archivo nuevo por pedido: créalo en
/provisiony responde convpn_config_file. - Un archivo nuevo que lleva tiempo: responde
pendingy después envíavpn_config_filecon Entregar el acceso al proxy o la configuración de VPN.
Para VLESS, da a cada pedido su propio UUID (si compartes uno, al revocar a un cliente los revocas a todos), indica el transporte en la descripción del plan (por ejemplo XTLS-Reality o WS+TLS) y elimina el UUID de tu inbound cuando termine el pedido.
Un archivo de OpenVPN debe contener remote, dev tun o dev tap, o bien client junto con un bloque <ca>; un bloque <ca> solo se rechaza. Cada configuración necesita al menos 50 caracteres.
¿Cómo funciona la rotación de IP?
El rotation_link que entregas es una URL a la que llama el propio ProxyMarket, con un GET simple (sigue las redirecciones, no comprueba el certificado, tiempo de espera de 15 segundos). Lo hace cuando el cliente pulsa Rotate y según el temporizador de rotación automática que elija el cliente (cada 5 a 60 minutos), y deja de hacerlo cuando termina el pedido. El cliente también ve el enlace y puede abrirlo.
Si se entrega como alternativa el rotation_link del propio plan (consulta más arriba), nunca es uno que ya pertenezca a otro pedido.
¿Hay un servidor de webhooks ya hecho?
Sí: el conector de ProxyMarket (pm-connector) se ejecuta en tu servidor Linux o Windows y hace por ti todo lo que explica esta página. Solo tienes que darle un pequeño script que añade y elimina el acceso de un cliente en tu sistema; en su página hay scripts listos en Python, Node.js y shell.
- Responde a los webhooks comprobando las firmas, crea el usuario y la contraseña del cliente en tu sistema y los elimina cuando termina el alquiler.
- Llega a ProxyMarket a través del ProxyMarket hook (tipo de clave ProxyMarket hook): una conexión saliente a
market-hook-service.xproxy.io, así que el servidor no necesita puertos abiertos ni dominio. Los clientes siempre se conectan directamente al puerto de tu proxy. - Se pone al día tras una caída: los pedidos que terminaron mientras estaba fuera de línea pierden su usuario en cuanto vuelve.
Los planes se crean en el Vendor Dashboard. Si quieres que ProxyMarket llame a tu propia dirección HTTPS en lugar de usar el hook, consulta usar tu propia dirección.
¿Cómo cobro?
| Tu parte | El 70 % de cada venta (la tarifa estándar; se puede acordar por vendedor) |
|---|---|
| Parte de ProxyMarket | El 30 %, por la tienda, los pagos, el soporte y los reembolsos |
| Cuándo se abona | En cuanto se confirma el pago del cliente y el pedido se activa, antes de llamar a tu /provision |
| Dónde verlo | En Earnings de tu panel de vendedor: cada venta con su importe, tu importe y la tarifa aplicada |
| Pagos | Los hace el administrador de ProxyMarket a partir de tu saldo. Pídelo por Telegram cuando quieras retirar. |
| Reembolsos | Un reembolso automático (nada entregado en 120 segundos) o un reembolso de un administrador resta la ganancia de tu saldo. Un código promocional reduce el importe de la venta, y con él tu parte. |
| Retiradas | Un pago puede llegar hasta tu saldo y marca como pagadas tus ganancias pendientes más antiguas. |
La tarifa se guarda con cada venta, así que un cambio posterior de tarifa nunca afecta al dinero que ya ganaste.
¿Dónde aparecen mis planes en la tienda?
Browse muestra los planes del más barato al más caro, con una regla que debes conocer antes de fijar precios: los planes de vendedores que usan el software XProxy van primero, bajo Powered by xProxy, con una insignia xProxy. Los planes de tu propio conector van después, bajo Other vendors, también del más barato al más caro.
| Dónde | Qué decide el orden |
|---|---|
| Browse, por defecto | Primero el grupo XProxy y después el tuyo, cada uno del más barato al más caro |
| Browse, cuando el cliente ordena | El orden se aplica dentro de cada grupo, así que un plan tuyo más barato sigue quedando por debajo del grupo XProxy |
| Tarjetas «from $X» de la página de inicio | El plan XProxy más barato de cada categoría; el tuyo solo cuando XProxy no tiene stock ahí |
| Filtros de país, protocolo y búsqueda, tu página de tienda | Exactamente igual para todos los vendedores |
Cuando todo lo publicado pertenece a un solo grupo, Browse muestra una lista única sin encabezados. La mayoría de los clientes llegan filtrando por país o protocolo, y ahí tus planes aparecen junto a los de todos los demás.
¿Qué significan los códigos de error?
| Código | Significado | Qué hacer |
|---|---|---|
401 | Invalid API key (clave incorrecta o desactivada), Missing API key (cabecera vacía) o Vendor inactive | Revisa la cabecera X-API-Key y que la clave esté activada en el panel |
403 | Tu solicitud de vendedor sigue pendiente (en cualquier llamada), o la cuenta no es un vendedor aprobado (al crear la clave) | Espera a la aprobación |
404 | external_id u order_id desconocido | Revisa el ID; sincroniza antes el plan |
409 | Entrega de credenciales a un pedido que ya no está pagado ni activo | Normalmente pasaron los 120 segundos y el pedido se reembolsó. No lo reintentes |
422 | Un valor no es válido, o falta por completo la cabecera X-API-Key | El detail de la respuesta indica el campo |
500 | Error de ProxyMarket | Reintenta con una espera cada vez mayor |
Los errores llegan como {"detail": "…"}. No hay límites de frecuencia publicados; sincroniza cuando haya cambios en lugar de hacerlo en un bucle continuo.
¿Hay un ejemplo completo?
Sí. Este conector en Python sincroniza un plan de proxy, informa del estado cada 5 minutos y responde a los cuatro webhooks. Sustituye las dos funciones de arriba por llamadas a tu propio sistema y añade un temporizador que termine cada pedido cuando se acabe su tiempo.
"""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)¿Dónde está la referencia completa de la API?
Cada llamada y cada webhook, con todos los campos, respuestas de ejemplo y código en curl, Python, Node.js y PHP, están en la referencia de la API de ProxyMarket. El archivo OpenAPI 3.1 está en market.openapi.yaml.
| Dirección | Endpoint | Qué hace |
|---|---|---|
| Tú llamas | POST /api/vendor/integrations | Crea tu clave API |
| Tú llamas | POST /plans/sync | Publica o actualiza planes |
| Tú llamas | PATCH /plans/stock | Cambia el stock y la visibilidad |
| Tú llamas | DELETE /plans/{external_id} | Retira un plan de la venta |
| Tú llamas | POST /health | Informa del estado de tus proxies |
| Tú llamas | POST /orders/{order_id}/credentials | Entrega un acceso o una configuración más tarde |
| Tú llamas | POST /orders/{order_id}/expire | Marca un pedido como caducado (sin reembolso) |
| Te llamamos | HEAD /health | Comprobación de estado que mantiene tus planes publicados |
| Te llamamos | POST /provision | Un cliente ha pagado: entrega |
| Te llamamos | POST /deprovision | Un pedido ha terminado: elimina el acceso |
| Te llamamos | POST /update-settings | Aplica una nueva lista blanca de IP o huella TCP |
| Tú llamas | GET /orders/active | Los pedidos pagados y activos asignados a tu clave |
¿Qué países puedo publicar?
Cualquiera. Envía el nombre completo del país en inglés, por ejemplo United States, Germany o Vietnam, y escríbelo igual en todos los planes: los clientes filtran por el texto exacto. ProxyMarket no comprueba el nombre; la lista de la guía y del panel de vendedor es la forma de escribirlo. pm-connector test rechaza un nombre que no esté en esa lista.
¿Qué cambió en la versión 1.13?
- Llamada nueva: Listar los pedidos asignados a tu clave (
GET /orders/active, conrouted_plansy ETag), para ponerte al día tras una caída. - Alternativa más segura: un acceso entregado ya no se copia en el plan, y nunca se entrega un acceso o enlace de rotación del plan que pertenezca a otro pedido.
- Momento del aprovisionamiento:
/provisionse envía solo cuando el pago está registrado, así que se acepta un envío inmediato de credenciales./update-settingslleva siempre los valores que el cliente acaba de guardar. - Conector de ProxyMarket: un servidor de webhooks ya hecho, incluido cómo llegar a él detrás de NAT. Consulta el conector.
- Respuesta de aprovisionamiento cifrada (opcional): en una webhook URL
http://sin cifrar, sella tu respuesta de/provisionconX-PM-Encrypted: v1. Consulta más arriba. - Vinculación de planes: un plan creado por una sincronización va a la clave que lo sincronizó.
- Rotación: ProxyMarket llama a tu
rotation_linkconGET. Consulta Rotación de IP. - Pestaña Integration Status en el panel de vendedor, y la cabecera opcional
X-PM-Connector. - Documentado para que coincida con el código: 422 sin cabecera
X-API-Key, 403 mientras tu solicitud está pendiente, tiempo de espera de aprovisionamiento de 30 segundos, país y puerto de sincronización sin validar,protocoles HTTP por defecto, un informe de/healthsincurrent_iplo borra, la regla<ca>de OpenVPN y la ausencia deexternal_plan_iden/update-settings.
Preguntas frecuentes
Uso XProxy. ¿Tengo que crear esto?
No. Activa ProxyMarket en el panel (Selling Platform → ProxyMarket) y hará todo esto por ti, webhooks incluidos. Consulta Vender en ProxyMarket. Además, tus planes recibirán la insignia xProxy.
¿Por qué han desaparecido todos mis planes de la tienda?
Casi siempre por la comprobación de estado: HEAD {webhook_url}/health falló dos veces seguidas (caído, más lento de 5 segundos, un 5xx o HEAD bloqueado). Corrígelo y los planes volverán tras la siguiente comprobación correcta, en menos de 10 minutos.
He perdido mi clave API. ¿ProxyMarket puede enviármela de nuevo?
No. Solo se guarda un hash. Crea una clave nueva y recuerda que la clave de firma cambia con ella.
La comprobación de la firma siempre falla. ¿Por qué?
Normalmente por una de dos cosas: usaste la clave API sin procesar como secreto del HMAC en lugar de SHA256(api_key) en hexadecimal, o firmaste el JSON analizado y vuelto a codificar en lugar del cuerpo sin procesar de la petición.
¿Cobro si mi servidor no consigue entregar?
No. Si no llega nada utilizable en 120 segundos, al cliente se le reembolsa y la ganancia se resta de tu saldo.
¿Por qué un cliente recibió un acceso antiguo?
Tu /provision respondió con un estado distinto de 200, agotó el tiempo de espera o envió JSON no válido, así que ProxyMarket entregó el acceso que sincronizaste en el plan. Un acceso entregado nunca se guarda en el plan, y el acceso del plan no se reutiliza si ya pertenece a otro pedido (en ese caso, el pedido se reembolsa). Responde siempre 200, con error si no puedes entregar.
¿Puedo conectar varios servidores?
Sí. Crea una clave por servidor, cada una con su propia webhook URL. Un plan creado por una sincronización va a la clave que lo sincronizó; para los planes más antiguos, configura API Key / Server en el panel, o sus pedidos irán a tu clave más antigua.
¿Qué ocurre cuando un cliente renueva?
Renovar un pedido caducado es un pedido nuevo normal. Renovar uno en curso envía primero /deprovision con reason: renewed para el pedido antiguo y después /provision para el nuevo, con un order_id nuevo.
¿Y ahora qué?
Abre la referencia completa o pregunta a ProxyMarket por Telegram.

