Proxy-seller

Automatisches Aufladen

Aktualisiert:

Automatische Guthabenaufladung: Wenn das Guthaben unter einen Schwellenwert fällt, wird der konfigurierte Betrag über die hinterlegte Zahlungsmethode abgebucht. Verfügbar in Nur API v2 — Es gibt keine Entsprechung in Version 1.

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

Endpunkt:

Diese Anfrage gibt die aktuelle Konfiguration für das automatische Aufladen sowie das Ergebnis des letzten Auslösers zurück.

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

Pfadparameter

Name

Wert

Beschreibung

Autorisierung

<Your_API_Key>

Dein persönlicher API-Schlüssel (So erhalten Sie)

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:

Dieser Auftrag aktualisiert die Konfiguration für die automatische Aufladung. Teilweise Aktualisierung: Jedes Feld, das Sie weglassen, behält seinen gespeicherten Wert bei; um also nur den Schwellenwert zu ändern, reicht es aus, threshold.

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

Pfadparameter

Name

Wert

Beschreibung

Autorisierung

<Your_API_Key>

Dein persönlicher API-Schlüssel (So erhalten Sie)

Anfragetext

Name

Typ

Beschreibung

aktiviert

Boolesche Werte

Automatisches Aufladen ein- oder ausschalten

Schwellenwert

Nummer

Laden Sie auf, wenn der Stand unter diesen Wert fällt. Minimum 1

Menge

Nummer

Betrag einer einzelnen Aufladung. Mindestbetrag 5, und muss größer oder gleich sein als threshold

subscriptionId

Zeichenkette

Zu belastende Zahlungsmethode, entnommen aus paymentMethod.id. Optional, solange nur eine Karte verfügbar ist

dailyCountCap

Nummer

Deine eigene strengere Begrenzung der Aufladungen pro 24 Stunden. Minimum 1

monthlyAmountCap

Nummer

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
            }
        }
    ]
}
  • Die Validierung erfolgt anhand der zusammengeführt Ergebnis, nicht nur anhand der Anfrage. Senden threshold wird für sich genommen immer noch abgelehnt, wenn die gespeicherte amount liegt unter dem neuen Schwellenwert.

  • Die Pause nach einer Reihe fehlgeschlagener Angriffe wird erst aufgehoben, wenn enabled: true wird explizit gesendet. Das Bearbeiten anderer Felder in einer pausierten Konfiguration lässt die Pause bestehen.

  • Die Regeln für Groß- und Kleinschreibung gelten auch, wenn der Benutzer keine festgelegt hat: 5 Aufladungen pro 24 Stunden und 500 pro 30 Tage.

On this page