Automatische Aufladung

Automatische Guthabenaufladung: Sobald das Guthaben unter einen Schwellenwert fällt, wird der festgelegte Betrag über die hinterlegte Zahlungsmethode abgebucht. Verfügbar in Nur API v2 — es gibt kein Pendant in Version 1.

Die Funktion muss auf dem Server aktiviert sein. Ist sie deaktiviert, geben beide Endpunkte Folgendes zurück: Auto top-up is not available.

Endpunkt:

Diese Abfrage gibt die aktuelle Konfiguration für die automatische Aufladung und das Ergebnis des letzten Auslösers zurück.

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

Pfadparameter

Name	Wert	Beschreibung
Genehmigung	`<Your_API_Key>`	Ihr persönlicher API-Schlüssel (So gelangen Sie dorthin)

Beispiel

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

Antwort

{
    "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
        }
    ]
}

Einstellungen ändern

Endpunkt:

Mit dieser Anfrage wird die Konfiguration für die automatische Aufladung aktualisiert. Teilweise Aktualisierung: Jedes Feld, das Sie weglassen, behält seinen gespeicherten Wert bei. Um also nur den Schwellenwert zu ändern, reicht es aus, Folgendes zu senden: threshold.

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

Pfadparameter

Name	Wert	Beschreibung
Genehmigung	`<Your_API_Key>`	Ihr persönlicher API-Schlüssel (So gelangen Sie dorthin)

Anfrage-Body

Name	Typ	Beschreibung
aktiviert	Boolesch	Automatische Aufladung aktivieren oder deaktivieren
Schwellenwert	Zahl	Aufladen, wenn der Stand unter diesen Wert fällt. Mindestwert `1`
Betrag	Zahl	Betrag einer einzelnen Aufladung. Mindestbetrag `5`, und muss größer oder gleich `threshold`
Abonnement-ID	Zeichenkette	Zu belastende Zahlungsmethode, entnommen aus `paymentMethod.id`. Optional, solange nur eine Karte verfügbar ist
dailyCountCap	Zahl	Deine eigene, strengere Obergrenze für Aufladungen pro 24 Stunden. Mindestbetrag `1`
monthlyAmountCap	Zahl	Ihr eigenes Limit für den Gesamtbetrag pro 30 Tage. Muss größer oder gleich sein als `amount`

Beispiel

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

Antwort

{
    "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
            }
        }
    ]
}

Validierungsläufe gegen die zusammengeführt Ergebnis, nicht nur anhand der Anfrage. Senden threshold wird für sich genommen dennoch abgelehnt, wenn der gespeicherte amount liegt am Ende unter dem neuen Schwellenwert.
Die Pause nach einer Reihe erfolgloser Angriffe wird erst aufgehoben, wenn enabled: true wird explizit gesendet. Das Bearbeiten anderer Felder in einer angehaltenen Konfiguration lässt die Anhaltung bestehen.
Die Obergrenzen gelten auch dann, wenn der Benutzer „none“ eingestellt hat: 5 Aufladungen pro 24 Stunden und 500 pro rollierender 30-Tage-Periode.

Endpunkt:

Pfadparameter

Beispiel

Antwort

Einstellungen ändern

Endpunkt:

Pfadparameter

Anfrage-Body

Beispiel

Antwort

On this page