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.
Pfadparameter
Name | Wert | Beschreibung |
|---|---|---|
Autorisierung |
| Dein persönlicher API-Schlüssel (So erhalten Sie) |
Beispiel
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/getAntwort
{
"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.
Pfadparameter
Name | Wert | Beschreibung |
|---|---|---|
Autorisierung |
| 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 |
Menge | Nummer | Betrag einer einzelnen Aufladung. Mindestbetrag |
subscriptionId | Zeichenkette | Zu belastende Zahlungsmethode, entnommen aus |
dailyCountCap | Nummer | Deine eigene strengere Begrenzung der Aufladungen pro 24 Stunden. Minimum |
monthlyAmountCap | Nummer | Ihr eigenes Limit für den Gesamtbetrag pro 30 Tage. Muss größer oder gleich sein als |
Beispiel
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/setAntwort
{
"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
thresholdwird für sich genommen immer noch abgelehnt, wenn die gespeicherteamountliegt unter dem neuen Schwellenwert.Die Pause nach einer Reihe fehlgeschlagener Angriffe wird erst aufgehoben, wenn
enabled: truewird 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:
5Aufladungen pro 24 Stunden und500pro 30 Tage.