Recarga automática
Actualizado:
Recarga automática del saldo: cuando el saldo desciende por debajo de un umbral, se carga el importe configurado a través del método de pago guardado. Disponible en Solo API v2 — No existe una versión v1 equivalente.
Requiere que la función esté habilitada en el servidor. Cuando está desactivada, ambos puntos finales devuelven Auto top-up is not available.
Resultado final:
Esta solicitud devuelve la configuración actual de recarga automática y el resultado del último activador.
Parámetros de ruta
Nombre | Valor | Descripción |
|---|---|---|
Autorización |
| Tu clave API personal (Cómo conseguirlo) |
Ejemplo
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/getRespuesta
{
"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
}
]
}Cambiar la configuración
Resultado final:
Esta solicitud actualiza la configuración de recarga automática. Actualización parcial: cualquier campo que se omita conserva su valor almacenado, por lo que para cambiar únicamente el umbral basta con enviar threshold.
Parámetros de ruta
Nombre | Valor | Descripción |
|---|---|---|
Autorización |
| Tu clave API personal (Cómo conseguirlo) |
Cuerpo de la solicitud
Nombre | Tipo | Descripción |
|---|---|---|
habilitado | Booleano | Activar o desactivar la recarga automática |
umbral | Número | Cargar cuando el saldo sea inferior a este valor. Mínimo |
cantidad | Número | Importe de una sola recarga. Mínimo |
subscriptionId | Cadena | Método de pago a cobrar, extraído de |
dailyCountCap | Número | Tu propio límite más estricto de recargas por cada 24 horas. Mínimo |
monthlyAmountCap | Número | Tu propio límite del importe total por cada 30 días. Debe ser mayor o igual que |
Ejemplo
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/setRespuesta
{
"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
}
}
]
}Las comprobaciones de validación se realizan con respecto a la fusionado resultado, no solo en función de la solicitud. Envío
thresholdpor sí solo sigue siendo rechazado si el almacenadoamountacaba siendo inferior al nuevo umbral.La pausa tras una serie de cargas fallidas solo se elimina cuando
enabled: truese envía explícitamente. Al editar otros campos en una configuración en pausa, la pausa se mantiene.Las mayúsculas también se aplican cuando el usuario no ha establecido ninguna:
5recargas cada 24 horas y500por cada periodo de 30 días.