Proxy-seller

Recharge automatique

Updated:

Recharge automatique du solde : lorsque le solde passe en dessous d'un seuil, le montant configuré est prélevé sur le moyen de paiement enregistré. Disponible dans API v2 uniquement — il n'existe pas d'équivalent v1.

Cette fonctionnalité doit être activée sur le serveur. Lorsqu’elle est désactivée, les deux points de terminaison renvoient Auto top-up is not available.

Résultat final :

Cette requête renvoie la configuration actuelle de la recharge automatique et le résultat du dernier déclenchement.

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

Paramètres de chemin

Nom

Valeur

Description

Autorisation

<Your_API_Key>

Votre clé API personnelle (Comment obtenir)

Exemple

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

Réponse

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

Modifier les paramètres

Résultat final :

Cette demande met à jour la configuration de la recharge automatique. Mise à jour partielle: tout champ que vous omettez conserve sa valeur enregistrée ; ainsi, pour modifier uniquement le seuil, il suffit d'envoyer threshold.

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

Paramètres de chemin

Nom

Valeur

Description

Autorisation

<Your_API_Key>

Votre clé API personnelle (Comment obtenir)

Corps de la requête

Nom

Type

Description

activé

Booléen

Activer ou désactiver la recharge automatique

seuil

Nombre

Recharger lorsque le solde passe en dessous de cette valeur. Minimum 1

quantité

Nombre

Montant d'une recharge unique. Minimum 5, et doit être supérieur ou égal à threshold

subscriptionId

Chaîne de caractères

Mode de paiement à facturer, tiré de paymentMethod.id. Facultatif tant qu'une seule carte est disponible

dailyCountCap

Nombre

Votre propre limite plus stricte de recharges par 24 heures. Minimum 1

monthlyAmountCap

Nombre

Votre propre limite du montant total par période de 30 jours. Elle doit être supérieure ou égale à amount

Exemple

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

Réponse

{
    "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
            }
        }
    ]
}
  • La validation s'effectue par rapport au fusionné résultat, et non pas uniquement par rapport à la requête. Envoi threshold est tout de même rejeté si le fichier stocké amount se retrouve en dessous du nouveau seuil.

  • La pause qui suit une série de charges infructueuses ne prend fin que lorsque enabled: true est envoyé explicitement. La modification d'autres champs sur une configuration mise en pause laisse la pause en place.

  • Les règles de mise en majuscules s'appliquent également lorsque l'utilisateur n'en a défini aucune : 5 recharges par 24 h et 500 par période de 30 jours.

On this page