Recarga automática

Recarga automática del saldo: cuando el saldo desciende por debajo de un umbral, se cobra el importe configurado a través del método de pago guardado. Disponible en Solo API v2 — no existe una versión equivalente en la v1.

Es necesario que la función esté activada en el servidor. Cuando está desactivada, ambos puntos finales devuelven Auto top-up is not available.

Punto final:

Esta solicitud devuelve la configuración actual de la recarga automática y el resultado del último evento desencadenante.

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

Parámetros de ruta

Nombre	Valor	Descripción
Autorización	`<Your_API_Key>`	Tu clave API personal (Cómo llegar)

Ejemplo

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

Respuesta

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

Punto final:

Esta solicitud actualiza la configuración de la recarga automática. Actualización parcial: cualquier campo que omitas conservará su valor almacenado, por lo que, para cambiar únicamente el umbral, basta con enviar threshold.

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

Parámetros de ruta

Nombre	Valor	Descripción
Autorización	`<Your_API_Key>`	Tu clave API personal (Cómo llegar)

Cuerpo de la solicitud

Nombre	Tipo	Descripción
activado	Booleano	Activar o desactivar la recarga automática
umbral	Número	Recargar cuando el saldo sea inferior a este valor. Mínimo `1`
cantidad	Número	Importe de una sola recarga. Mínimo `5`, y debe ser mayor o igual que `threshold`
subscriptionId	Cadena	Forma de pago que se va a utilizar, extraída de `paymentMethod.id`. Opcional mientras solo haya una tarjeta disponible
dailyCountCap	Número	Tu propio límite más estricto de recargas por cada 24 horas. Mínimo `1`
Importe máximo mensual	Número	Tu propio límite del importe total por cada 30 días. Debe ser mayor o igual a `amount`

Ejemplo

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

Respuesta

{
    "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 pruebas de validación se realizan con respecto a la fusionado resultado, no solo en función de la solicitud. Envío threshold por sí solo sigue siendo rechazado si el valor almacenado amount acaba siendo inferior al nuevo umbral.
La pausa tras una serie de intentos fallidos solo se elimina cuando enabled: true se envía de forma explícita. Si se modifican otros campos de una configuración en pausa, la pausa se mantiene.
Los límites efectivos también se aplican cuando el usuario establece el valor «none»: 5 recargas cada 24 horas y 500 por cada período de 30 días consecutivos.

Punto final:

Parámetros de ruta

Ejemplo

Respuesta

Cambiar la configuración

Punto final:

Parámetros de ruta

Cuerpo de la solicitud

Ejemplo

Respuesta

On this page