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.
Paramètres de chemin
Nom | Valeur | Description |
|---|---|---|
Autorisation |
| Votre clé API personnelle (Comment obtenir) |
Exemple
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/getRé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.
Paramètres de chemin
Nom | Valeur | Description |
|---|---|---|
Autorisation |
| 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 |
quantité | Nombre | Montant d'une recharge unique. Minimum |
subscriptionId | Chaîne de caractères | Mode de paiement à facturer, tiré de |
dailyCountCap | Nombre | Votre propre limite plus stricte de recharges par 24 heures. Minimum |
monthlyAmountCap | Nombre | Votre propre limite du montant total par période de 30 jours. Elle doit être supérieure ou égale à |
Exemple
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/setRé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
thresholdest tout de même rejeté si le fichier stockéamountse retrouve en dessous du nouveau seuil.La pause qui suit une série de charges infructueuses ne prend fin que lorsque
enabled: trueest 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 :
5recharges par 24 h et500par période de 30 jours.