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 en 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.

Point final :

Cette requĂȘte renvoie la configuration actuelle de la recharge automatique ainsi que 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 s'y rendre)

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

Point final :

Cette requĂȘte met Ă  jour la configuration de la recharge automatique. Mise Ă  jour partielle: tout champ que vous omettez conserve la valeur qui y est 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 s'y rendre)

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

montant

Nombre

Montant d'une recharge unique. Montant minimum 5, et doit ĂȘtre supĂ©rieur ou Ă©gal Ă  threshold

identifiant d'abonnement

ChaĂźne de caractĂšres

Mode de paiement à débiter, issu de paymentMethod.id. Facultatif tant qu'une seule carte est disponible

dailyCountCap

Nombre

Votre propre limite, plus stricte, de recharges par période de 24 heures. Minimum 1

montant mensuel maximal

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

  • Les tests de validation sont effectuĂ©s par rapport Ă  la fusionnĂ© rĂ©sultat, et non pas uniquement par rapport Ă  la requĂȘte. Envoi threshold en soi est tout de mĂȘme rejetĂ©e si la valeur enregistrĂ©e amount se rĂ©vĂšle infĂ©rieur au nouveau seuil.

  • La pause qui suit une sĂ©rie de tentatives infructueuses ne prend fin que lorsque enabled: true est envoyĂ©e explicitement. La modification d'autres champs dans une configuration mise en pause ne modifie pas l'Ă©tat de pause.

  • Les limites effectives s'appliquent Ă©galement lorsque l'utilisateur a sĂ©lectionnĂ© « Aucune » : 5 recharges par 24 h et 500 sur une pĂ©riode de 30 jours glissants.

On this page

Point final :
ParamĂštres de chemin
Exemple
RĂ©ponse
Modifier les paramĂštres
Point final :
ParamĂštres de chemin
Corps de la requĂȘte
Exemple
RĂ©ponse
Recharge automatique | Proxy-seller