Ricarica automatica

Ricarica automatica del saldo: quando il saldo scende al di sotto di una soglia, l'importo configurato viene addebitato sul metodo di pagamento salvato. Disponibile in Solo API v2 — non esiste una versione v1 corrispondente.

Richiede che la funzionalità sia abilitata sul server. Quando è disattivata, entrambi gli endpoint restituiscono Auto top-up is not available.

Punto finale:

Questa richiesta restituisce la configurazione corrente della ricarica automatica e il risultato dell'ultimo evento di attivazione.

GEThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/balance/autotopup/get

Parametri del percorso

Nome	Valore	Descrizione
Autorizzazione	`<Your_API_Key>`	La tua chiave API personale (Come arrivare)

Esempio

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/get

Risposta

{
    "status": "success",
    "data": {
        "configured": true,
        "enabled": true,
        "state": "ACTIVE",
        "threshold": 10,
        "amount": 25,
        "subscriptionId": "sub_01hx9k2m4p",
        "paymentMethod": {
            "id": "sub_01hx9k2m4p",
            "status": "active",
            "paymentMethod": "card",
            "brand": "visa",
            "last4": "1234",
            "exp": "05/2027"
        },
        "dailyCountCap": 5,
        "monthlyAmountCap": 500,
        "failCount": 0,
        "lastAttemptAt": "2026-08-14T09:12:44.000+00:00",
        "lastEvent": {
            "status": "SUCCEEDED",
            "amount": 25,
            "at": "2026-08-14T09:12:46.000+00:00",
            "reason": null
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Auto top-up is not available",
            "code": 49,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}

Modifica impostazioni

Punto finale:

Questa richiesta aggiorna la configurazione della ricarica automatica. Aggiornamento parziale: ogni campo che si omette mantiene il valore memorizzato, quindi per modificare solo la soglia è sufficiente inviare threshold.

POSThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/balance/autotopup/set

Parametri del percorso

Nome	Valore	Descrizione
Autorizzazione	`<Your_API_Key>`	La tua chiave API personale (Come arrivare)

Corpo della richiesta

Nome	Tipo	Descrizione
abilitato	Booleano	Attiva o disattiva la ricarica automatica
soglia	Numero	Ricaricare quando il saldo scende al di sotto di questo valore. Minimo `1`
importo	Numero	Importo di una singola ricarica. Importo minimo `5`, e deve essere maggiore o uguale a `threshold`
ID abbonamento	Stringa	Metodo di pagamento da addebitare, tratto da `paymentMethod.id`. Opzionale se è disponibile una sola scheda
dailyCountCap	Numero	Il tuo limite personale più restrittivo di ricariche nelle 24 ore. Minimo `1`
limite_importo_mensile	Numero	Il limite personale relativo all'importo totale ogni 30 giorni. Deve essere maggiore o uguale a `amount`

Esempio

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/set

Risposta

{
    "status": "success",
    "data": {
        "configured": true,
        "enabled": true,
        "state": "ACTIVE",
        "threshold": 10,
        "amount": 25,
        "subscriptionId": "sub_01hx9k2m4p",
        "paymentMethod": {
            "id": "sub_01hx9k2m4p",
            "status": "active",
            "paymentMethod": "card",
            "brand": "visa",
            "last4": "4242",
            "exp": "05/2027"
        },
        "dailyCountCap": 5,
        "monthlyAmountCap": 500,
        "failCount": 0,
        "lastAttemptAt": null,
        "lastEvent": {
            "status": "SETTINGS_SAVED",
            "amount": null,
            "at": "2026-08-14T10:03:11.000+00:00",
            "reason": "enabled: false -> true"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Top-up amount must be #min_amount# or more",
            "code": 51,
            "customData": {
                "minAmount": 5
            }
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Top-up amount must cover the threshold, otherwise it will trigger again",
            "code": 52,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Auto top-up requires a saved payment method",
            "code": 53,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Your saved card has expired — update it to enable auto top-up",
            "code": 56,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Threshold must be #min_threshold# or more",
            "code": 50,
            "customData": {
                "minThreshold": 1
            }
        }
    ]
}

Le esecuzioni di convalida vengono effettuate rispetto al unito risultato, non solo in relazione alla richiesta. Invio threshold di per sé viene comunque rifiutato se il dato memorizzato amount risulta inferiore alla nuova soglia.
La pausa che segue una serie di tentativi falliti viene interrotta solo quando enabled: true viene inviato in modo esplicito. La modifica di altri campi in una configurazione in pausa non modifica lo stato di pausa.
I limiti effettivi si applicano anche quando l'utente imposta "none": 5 ricariche ogni 24 ore e 500 ogni 30 giorni consecutivi.

Punto finale:

Parametri del percorso

Esempio

Risposta

Modifica impostazioni

Punto finale:

Parametri del percorso

Corpo della richiesta

Esempio

Risposta

On this page