---
title: Recarga automática
description: Mantenga fondos automáticos en los monederos mediante tarjeta o PayPal guardados: modos por uso y fijos, límites globales y gestión de fallos.
url: https://nexcmp.com/es/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Recarga automática {#auto-top-up}

> **En la administración:** Finance › Payment channels › Fees & limits (`/payments/fees`), tarjeta **Wallet & top-up (Billing › Policy)**, sección **Auto top-up (Stripe / PayPal)**. **En el portal:** Billing › Settings (`/billing?settings=1`).

## Qué hace {#what-it-does}

Cuando el saldo del monedero de un cliente es demasiado bajo, NexCMP realiza un cargo en su [método de pago guardado](https://nexcmp.com/es/docs/billing/saved-payment-methods/) y abona el saldo en el monedero, evitando que los servicios activos se suspendan por falta de fondos. Una tarea en segundo plano revisa a todos los clientes habilitados **cada 5 minutos**.

## Requisitos {#requirements}

| Elemento | Requisito |
|---|---|
| Canal | [Stripe](https://nexcmp.com/es/docs/billing/stripe/) y/o [PayPal](https://nexcmp.com/es/docs/billing/paypal/) configurados. |
| Método guardado | El cliente tiene una tarjeta o cuenta de PayPal guardada. |
| Sitio | Sitio principal, o sitio de revendedor cuyo canal de Stripe/PayPal es recaudado por la plataforma. |
| Interruptor global | **Auto top-up enabled** está activado (activado por defecto). |

## Cómo funciona {#how-it-works}

Tras la **primera recarga con Stripe o PayPal** de un cliente, el servidor guarda el método de pago y activa la recarga automática en modo **By usage**, únicamente si dicho cliente nunca la configuró por sí mismo. No hay ninguna casilla adicional en la pantalla de depósito; el servidor registra la fecha y hora, la dirección IP y el método como prueba. Si el cliente desactiva la recarga automática más adelante, nunca se volverá a activar por sí sola.

| Modo | Activador (cuando el saldo es inferior a...) | Importe cobrado |
|---|---|---|
| **By usage** (predeterminado tras la primera recarga) | el coste de las próximas 24 horas de servicios en ejecución (VM por horas más renovaciones prepagadas que vencen en 24 horas), pero nunca inferior a **$5** | el coste de 24 horas redondeado al alza al dólar entero, como mínimo la [recarga mínima](https://nexcmp.com/es/docs/billing/minimum-top-up/), como máximo la recarga máxima y el límite diario |
| **Fixed amount** | el umbral configurado por el cliente ($1 a $500) | el importe configurado por el cliente (desde la recarga mínima hasta $1,000, y mayor que el umbral) |

Si no hay ningún servicio en ejecución en el modo **By usage**, no se cobra nada.

El saldo comparado con el umbral es el **dinero real en el monedero**. Los créditos de servicio procedentes de códigos promocionales se guardan por separado y no cuentan (consulte [Promotions](https://nexcmp.com/es/docs/billing/promotions/)).

La comisión se gestiona como en una recarga normal: con **Customer pays top-up fee** activado, se cobra en la tarjeta el importe más la comisión y el monedero recibe el importe íntegro; con esta opción desactivada, el monedero recibe el importe menos la comisión.

## Configurar los límites globales {#configure-the-global-limits}

1. Abra **Finance › Payment channels › Fees & limits** (`/payments/fees`).
2. En **Auto top-up (Stripe / PayPal)** configure:

   | Ajuste | Predeterminado | Rango | Significado |
   |---|---|---|---|
   | Auto top-up enabled | On | activado o desactivado | Off detiene inmediatamente todos los cobros en segundo plano. |
   | Umbral predeterminado de recarga automática (USD, respaldo en modo fijo) | $5.00 | De $0 a $10,000 | Se utiliza únicamente como umbral inicial en el modo fijo. |
   | Máximo de recargas automáticas cada 24 h por cliente | 3 | 1 a 50 | Contabiliza los intentos correctos y pendientes. |
   | Límite de importe de recarga automática cada 24 h por cliente (USD) | $500.00 | $0 a $1,000,000 | Total de cobros automáticos en un período móvil de 24 horas. |

3. Haga clic en **Save Wallet & top-up**.

![Sección Auto top-up de la página Fees and limits con el interruptor global y los límites diarios](https://nexcmp.com/es/docs/images/billing/auto-top-up-01-limits.webp)

## Lo que ve el cliente {#what-the-customer-sees}

1. En el portal, el cliente abre **Billing** y hace clic en **Settings**.
2. El panel muestra los métodos guardados, el interruptor de activación, el modo (**By usage** o **Fixed amount**), el consumo actual estimado y el próximo cobro, y **Recent automatic top-ups**.
3. Cambiar a **Fixed amount** les permite introducir el umbral y el importe. Desactivar el interruptor detiene los cobros.

![Ajustes de facturación del cliente con recarga automática en modo By usage y las recargas automáticas recientes](https://nexcmp.com/es/docs/images/billing/auto-top-up-02-portal.webp)

## Verificación {#verify}

1. Como cliente de prueba, realice una primera recarga con una tarjeta de prueba ([Stripe](https://nexcmp.com/es/docs/billing/stripe/#verify)). Abra **Billing › Settings**: la recarga automática estará activada.
2. Ejecute una pequeña VM para que haya consumo y reduzca el saldo por debajo del umbral (por ejemplo, con **Customers › customer › Credit / debit**).
3. En un plazo aproximado de 5 minutos se realiza un cobro. En la tarjeta **Overview › Payment** del cliente, **Auto top-up history** muestra el intento con el estado *Done* y se envía una notificación *Top-up received*.

## Límites y notas {#limits-notes}

- **Un cargo por cada caída.** Tras un cargo, la tarea espera hasta que el saldo vuelva a superar el umbral o finalice el tiempo de espera: 1 hora tras un éxito, 24 horas tras un cargo pendiente y 30 minutos tras un error del sistema.
- **Límites diarios.** Al alcanzar cualquiera de los límites diarios, no se realiza ningún cargo y se registra una línea *Daily limit reached* (como máximo una vez cada 6 horas).
- **Fallos.** Una tarjeta rechazada, caducada o con fondos insuficientes cuenta como un fallo de tarjeta. La tarea reintenta tras 1 hora, luego 6 horas y luego 24 horas. **Tras 3 fallos consecutivos de tarjeta, la recarga automática se desactiva** y se notifica al cliente (*Auto top-up failed*). Un pago que requiere la confirmación del cliente (por ejemplo, 3-D Secure) no se considera un fallo; se le indica al cliente que lo confirme.
- **Sin cargos dobles.** Cada cargo se procesa de forma atómica por cada caída por debajo del umbral y utiliza una clave de idempotencia en la pasarela.
- **Eliminar la tarjeta** desactiva la recarga automática.
- **Revendedores.** Si un revendedor utiliza su propio canal de pago, el cliente no puede activar la recarga automática (HTTP 403 `feature_disabled`).

## Resolución de problemas {#troubleshooting}

| Síntoma | Causa | Solución |
|---|---|---|
| El cliente no puede activarlo: "Top up once with a card or PayPal" | No hay ningún método guardado | Realice primero una recarga con tarjeta o PayPal. |
| Error `no_card` (422) | La pasarela elegida no tiene ningún método guardado | Elija la pasarela que lo tenga o guarde un método. |
| Error `invalid_argument` en el importe | Modo fijo fuera de los rangos permitidos | Umbral de $1–$500, importe entre la recarga mínima y $1,000, importe superior al umbral. |
| No se cobra nada aunque el saldo sea bajo | Interruptor global desactivado, no hay servicios en ejecución en el modo By usage, se alcanzó el límite diario o el cargo anterior sigue en espera | Compruebe el interruptor, el historial y los límites. |
| "N intentos fallidos consecutivos — la recarga automática se desactiva tras 3" | La tarjeta sigue fallando | El cliente sustituye la tarjeta mediante un nuevo depósito. |
| Estado *Needs your confirmation* | El banco requiere 3-D Secure | El cliente completa una recarga normal una vez. |