Ir al contenido

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 web

Asistentes de chat

Abrir en ChatGPTNueva pestañaAbrir en ClaudeNueva pestaña

Copiar

Ver como MarkdownTexto plano para herramientas de IA
Ver 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.

¿No tienes tiempo de escribir el servidor? El conector de ProxyMarket es uno ya hecho. Instálalo en tu servidor, dale un pequeño script que añade y elimina el acceso de un cliente en tu sistema (hay scripts listos en Python, Node.js y shell) y entregará cada pedido. Sin código, sin puertos abiertos, sin dominio.

En resumen

Tú llamas a ProxyMarket

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.

ProxyMarket te llama

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.

Te quedas con el 70 %

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?

Tu servidormódems, proxies, VPN
ProxyMarkettienda, pagos, soporte
Clientese conecta a tu proxy
ProxyMarket vende. Tú entregas el acceso al proxy o el archivo de configuración de la VPN, y el cliente se conecta directamente a tu servidor.

¿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.

  1. Crea una cuenta normal en market.xproxy.ioTú
  2. Solicita ser vendedor (Become Vendor en el menú superior)Tú
  3. 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
  4. Mientras tanto, crea tu comprobación de estado y pon en línea tu servidor de webhooksTú
  5. Crea tu clave API en el panel de vendedorTú
  6. Publica tus planes, gestiona los pedidos y comprueba las firmas de los webhooksTú
  7. 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 activoCuenta 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.
python
@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200   # no login, no database, no outside call

Colócalo bajo tu webhook URL: con https://your-vendor-host.com/marketplace responde en /marketplace/health.

Esta es la forma más habitual en que una tienda que funciona deja de vender sin avisar. Un despliegue, un reinicio o un cortafuegos que bloquee 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):

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
La clave solo se muestra una vez. ProxyMarket solo guarda un hash y no puede devolvértela. Guárdala en ese momento. Si la pierdes, crea una nueva.

De esa clave obtienes dos valores. No los mezcles:

ValorQué esPara qué sirve
api_keyLa clave en sí, que empieza por pm_La cabecera X-API-Key de cada llamada que haces
signing_keySHA256(api_key) en hexadecimal de 64 caracteresComprobar 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.

¿Vas a añadir una segunda clave? Los planes creados antes siguen yendo a la clave antigua. Pon la clave nueva en su API Key / Server o desactiva la 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.

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"}]}
Conviene saberPor qué
Enviar de nuevo el mismo external_id actualiza el planPuedes repetir la sincronización sin problema; nunca crea duplicados.
Un plan que no incluyes sigue a la ventaPara dejar de venderlo, llama a Retirar un plan de la venta.
Usa solo mobile, residential, datacenter, isp, ipv6 o vpn como proxy_typeLa 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 StatesLos 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 estadoNormalmente stock es 1 por puerto de módem: un cliente por puerto.
Si omites protocol, se usa HTTPEnví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?

  1. El cliente paga. Tu 70 % se abona en tu saldo al instante, incluso antes de llamar a tu servidor.
  2. ProxyMarket llama a POST {webhook_url}/provision con el order_id y tu external_plan_id (payload). Comprueba la firma y después crea el acceso del cliente.
  3. Respondes con el acceso o la configuración (lo mejor), con pending o con error. Consulta la tabla de abajo.
  4. El cliente ve el acceso en ProxyMarket y se conecta a tu servidor. ProxyMarket baja en uno el stock del plan automáticamente.
  5. 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 respondesCuándo usarloQué ocurre
provisioned (lo mejor)Puedes crear el acceso al momentoEl cliente lo recibe al instante. Incluye los cuatro valores proxy_ip, proxy_port, proxy_username, proxy_password, o vpn_config_file para VPN.
pendingPrepararlo lleva un tiempoEnví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.
errorNo 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.
Responde siempre HTTP 200, incluso con un error. Si /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.

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

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?

  1. Desde fuera de tu red, ejecuta curl -I https://your-vendor-host.com/marketplace/health y comprueba que obtienes un estado por debajo de 500 en menos de 5 segundos.
  2. Sincroniza un plan y búscalo en Browse, en market.xproxy.io.
  3. Haz un pedido real de ese plan. Tu servidor debería recibir /provision con una firma válida, y el acceso debería aparecer en el pedido del cliente.
  4. Conéctate con ese acceso, espera a que termine el pedido (o pide por Telegram que lo terminen) y comprueba que /deprovision elimina 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 ladoLlamada
Un módem o un servidor se queda fuera de líneaPATCH /plans/stock con stock: 0, is_active: false
Vuelve a estar en línea, o un puerto vendido vuelve a quedar librePATCH /plans/stock con stock: 1, is_active: true
Cambia un precio, un nombre o una configuraciónPOST /plans/sync solo con ese plan
Dejas de vender un productoDELETE /plans/{external_id}
Opcional, cada pocos minutosPOST /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:

MotivoSignificado
expiredEl tiempo de alquiler ha terminado. Se envía automáticamente, con hasta 5 minutos de retraso.
renewedEl cliente pagó para renovar un pedido en curso. El pedido antiguo termina ahora y le sigue un nuevo /provision con un order_id nuevo.
cancelledUn administrador canceló el pedido.
admin_refundUn 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.

Esta llamada se envía una sola vez y nunca se reintenta. Si tu servidor está caído en ese momento, el cliente conserva el acceso. Termina también cada pedido con tu propio temporizador cuando se acabe su tiempo (conoces la duración por /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 (win1 Windows 11, mac1 macOS, ios1 iPhone 15, android1 Galaxy S24, y más). null lo 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.

ProductoCampos del planQué entregas
OpenVPNproxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn"El texto .ovpn completo, con los certificados y las claves dentro
WireGuardproxy_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
Nunca envíes 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_template al sincronizar.
  • Un archivo nuevo por pedido: créalo en /provision y responde con vpn_config_file.
  • Un archivo nuevo que lleva tiempo: responde pending y después envía vpn_config_file con 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 parteEl 70 % de cada venta (la tarifa estándar; se puede acordar por vendedor)
Parte de ProxyMarketEl 30 %, por la tienda, los pagos, el soporte y los reembolsos
Cuándo se abonaEn cuanto se confirma el pago del cliente y el pedido se activa, antes de llamar a tu /provision
Dónde verloEn Earnings de tu panel de vendedor: cada venta con su importe, tu importe y la tarifa aplicada
PagosLos hace el administrador de ProxyMarket a partir de tu saldo. Pídelo por Telegram cuando quieras retirar.
ReembolsosUn 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.
RetiradasUn 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óndeQué decide el orden
Browse, por defectoPrimero el grupo XProxy y después el tuyo, cada uno del más barato al más caro
Browse, cuando el cliente ordenaEl 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 inicioEl 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 tiendaExactamente 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ódigoSignificadoQué hacer
401Invalid API key (clave incorrecta o desactivada), Missing API key (cabecera vacía) o Vendor inactiveRevisa la cabecera X-API-Key y que la clave esté activada en el panel
403Tu 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
404external_id u order_id desconocidoRevisa el ID; sincroniza antes el plan
409Entrega de credenciales a un pedido que ya no está pagado ni activoNormalmente pasaron los 120 segundos y el pedido se reembolsó. No lo reintentes
422Un valor no es válido, o falta por completo la cabecera X-API-KeyEl detail de la respuesta indica el campo
500Error de ProxyMarketReintenta 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.

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)

¿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ónEndpointQué hace
Tú llamasPOST /api/vendor/integrationsCrea tu clave API
Tú llamasPOST /plans/syncPublica o actualiza planes
Tú llamasPATCH /plans/stockCambia el stock y la visibilidad
Tú llamasDELETE /plans/{external_id}Retira un plan de la venta
Tú llamasPOST /healthInforma del estado de tus proxies
Tú llamasPOST /orders/{order_id}/credentialsEntrega un acceso o una configuración más tarde
Tú llamasPOST /orders/{order_id}/expireMarca un pedido como caducado (sin reembolso)
Te llamamosHEAD /healthComprobación de estado que mantiene tus planes publicados
Te llamamosPOST /provisionUn cliente ha pagado: entrega
Te llamamosPOST /deprovisionUn pedido ha terminado: elimina el acceso
Te llamamosPOST /update-settingsAplica una nueva lista blanca de IP o huella TCP
Tú llamasGET /orders/activeLos 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, con routed_plans y 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: /provision se envía solo cuando el pago está registrado, así que se acepta un envío inmediato de credenciales. /update-settings lleva 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 /provision con X-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_link con GET. 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, protocol es HTTP por defecto, un informe de /health sin current_ip lo borra, la regla <ca> de OpenVPN y la ausencia de external_plan_id en /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.

¿Sigues atascado?Un técnico puede revisar tu dispositivo con un PIN de un solo uso, o escríbenos por Telegram.