Proxy-seller

Rinnovo automatico

Updated:

Funziona con ogni tipo di proxy, compreso il pacchetto residenziale.

Autorizzazioni: account:read, account:write, fatturazione:scrivi

calc_autoprolong_cost

🢢 read-only · account:read

Il prossimo addebito automatico e la relativa data, senza apportare alcuna modifica.

Accetta gli stessi parametri di enable_autoprolong.

Risultati: {total, discount, quantity, orders, balance, items[], days | tarifId, chargeDate, dateEnd, paymentId, autoProlong, warning, currency: "USD"}. items sono i proxy che verrebbero rinnovati (stessa forma di list_proxies, password (mascherato), chargeDate è il momento in cui i fondi devono essere presenti sul conto (null (per uso residenziale), autoProlong indica se è già attivo per ogni proxy selezionato. Quando il periodo è stato dedotto, periodId e un _note Specificare quale. Verificato rispetto all’API di stage del 06/10/2026.

enable_autoprolong

💳 spends money · billing:write

Attiva il rinnovo automatico. Al momento non ti verrà addebitato alcun costo, ma i futuri rinnovi verranno addebitati automaticamente.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy

Tipo di prodotto

paymentId obbligatorio

string

balance oppure paddle_subscription

ips / ids / orderIds

array

Quali proxy, per tipo come in make_prolong (orderIds per ipv6 / mix / mix_isp); non inviare nulla per resident

periodId

string

Periodo di rinnovo in base al prezzo. Opzionale: se il rinnovo automatico è già attivo, il prezzo si riferisce al periodo vincolato; altrimenti il server calcola il prezzo in base al periodo in cui i proxy sono attualmente in esecuzione (a partire dalla durata del loro noleggio) e il risultato lo indica in periodId e _note. Inoltralo esplicitamente per fissare un altro termine

subscriptionId

string

Con paddle_subscription; tratto da get_autotopup

tarifId

string

Solo uso residenziale — deve corrispondere alla tariffa attuale

coupon

string

Codice promozionale

calc_autoprolong_cost accetta gli stessi parametri.

Risultati: {autoProlong: true, quantity, ids[], orderIds[], days, paymentId, chargeDate, dateEnd, warning} — ciò che era effettivamente attivato (per ipv6 / mix / mix_isp un intero ordine in una volta sola); non c'è total, utilizzare calc_autoprolong_cost per l'importo. Verificato rispetto all'API di fase del 06/10/2026. Con paddle_subscription e no subscriptionId: {status: "not_enabled", paddleSubscription: {cardConnected, subscriptionId?, card?, nextSteps}} e non cambia nulla.

Errore tipico: un campo non vuoto warning significa rinnovo automatico è su ma il credito residuo non sarà sufficiente per la prossima ricarica — ricarica prima di chargeDate. Con paddle_subscription e senza carte collegate il risultato è status: "not_enabled", non cambia nulla.

disable_autoprolong

🟡 changes account state · account:write

Disattiva il rinnovo automatico. I proxy rimangono attivi fino alla loro data di scadenza corrente.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy

Tipo di prodotto

ips / ids / orderIds

array

Quali proxy, per tipo come in make_prolong (orderIds per ipv6 / mix / mix_isp); non inviare nulla per resident

Prossimi passi

On this page