Esta guía muestra cómo renovar (extender) tus proxies existentes a través de la API para conservar las mismas direcciones IP. Renueva a tiempo: una vez que un proxy caduca, la IP puede perderse.

Cada solicitud usa tu clave API personal del panel de tu cuenta (cómo obtener tu clave API). En los ejemplos siguientes, reemplaza YOUR_API_KEY por tu propia clave. Para pagar con el saldo de tu cuenta, usa paymentId = 1.

⚠️ El último paso cobra de tu saldo. Comprueba siempre primero el coste en el paso de cálculo.

El flujo de un vistazo

Encuentra los proxies a renovar y copia sus ID.
Elige un método de pago (o usa tu saldo).
Calcula el coste de la renovación.
Realiza la renovación.

Paso 1 — Encuentra los proxies a renovar

Lista tus proxies activos y copia el id de cada uno que quieras extender. Solo se pueden renovar los proxies con can_prolong: true. Anota el tipo de proxy (ipv4, ipv6, mobile, isp, mix, mix_isp): lo necesitarás en los siguientes pasos.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Parámetros de ruta

Nombre	Valor	Descripción
type (opcional)	`ipv4`	El tipo de proxy a obtener. Si se omite, se devuelven todos los tipos.

Parámetros de consulta opcionales

Nombre	Tipo	Descripción
latest	String	Y/N — devolver solo los proxies del último pedido.
orderId	String	Devolver proxies de un orderId o baseOrderNumber específico.
country	String	Código de país alfa-3 (p. ej. FRA, USA).
ends	String	Y — solo los proxies que están por caducar.

Ejemplo

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4

Respuesta

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "can_prolong": true,
        "date_start": "23.06.2024",
        "date_end": "23.07.2024",
        "auto_renew": "N"
      }
    ]
  },
  "errors": []
}

Copia el id de cada proxy a renovar. Asegúrate de que can_prolong sea true.

Paso 2 — Elige un método de pago

Lista los sistemas de pago disponibles y copia el id que quieras como paymentId. Para pagar con el saldo de tu cuenta, puedes omitir este paso y usar simplemente paymentId = 1.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Respuesta

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Paso 3 — Calcula el coste de la renovación

Antes de pagar, calcula el coste. Los descuentos por volumen y periodo de alquiler se aplican igual que en la web. Este paso no cobra nada.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}

Cuerpo de la solicitud

Nombre	Tipo	Descripción
ids	Number / Array	Un solo ID o un array de IDs en `[ ]`, separados por comas — del paso 1.
periodId	String	ID del periodo de renovación. Obtén los periodos disponibles desde el endpoint `/reference/list/{type}`.
paymentId	String	ID del sistema de pago. `1` = saldo, `43` = tarjeta añadida a tu cuenta.
coupon (opcional)	String	Un código de cupón, si tienes uno.

Ejemplo

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4

Respuesta — shows the total, your balance, the discount and the proxies being renewed:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [ ... proxies being renewed ... ],
    "orders": 2
  },
  "errors": []
}

Si tu saldo es demasiado bajo, recibirás una advertencia Insufficient funds:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

Paso 4 — Realiza la renovación (cobra de tu saldo)

Cuando el coste calculado sea correcto, crea el pedido de renovación. Este paso cobra de tu saldo. Usa los mismos parámetros que en el paso 3.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}

Cuerpo de la solicitud

Nombre	Tipo	Descripción
ids	Number / Array	Un solo ID o un array de IDs en `[ ]`, separados por comas.
periodId	String	ID del periodo de renovación (de `/reference/list/{type}`).
paymentId	String	ID del sistema de pago. `1` = saldo.
coupon (opcional)	String	Un código de cupón, si tienes uno.

Ejemplo

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4

Respuesta — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 3388536,
    "total": 35.1,
    "listBaseOrderNumbers": [ "1000000_57471911" ],
    "balance": 40.4
  },
  "errors": []
}

Los proxies mantienen las mismas IP con una nueva fecha de caducidad.

Referencia completa de la API

Extend proxies — calcular y realizar la renovación
Retrieve active proxy — lista tus proxies
Balance — saldo y sistemas de pago

Extender (renovar) proxies

El flujo de un vistazo

Paso 1 — Encuentra los proxies a renovar

Paso 2 — Elige un método de pago

Paso 3 — Calcula el coste de la renovación

Paso 4 — Realiza la renovación (cobra de tu saldo)

Referencia completa de la API