Recarga automática

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

Cuando el saldo del monedero de un cliente es demasiado bajo, NexCMP realiza un cargo en su método de pago guardado 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

Elemento	Requisito
Canal	Stripe y/o 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

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, 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).

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

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.

Lo que ve el cliente

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.

Verificación

1. Como cliente de prueba, realice una primera recarga con una tarjeta de prueba (Stripe). 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

• 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

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.