---
title: Автопополнение
description: Автоматическое пополнение баланса клиентов с сохраненной карты или PayPal: по расходу и фиксированное, лимиты и обработка ошибок.
url: https://nexcmp.com/ru/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Автопополнение {#auto-top-up}

> **В панели администратора:** Finance › Payment channels › Fees & limits (`/payments/fees`), карточка **Wallet & top-up (Billing › Policy)**, раздел **Auto top-up (Stripe / PayPal)**. **В портале клиента:** Billing › Settings (`/billing?settings=1`).

## Назначение {#what-it-does}

Когда баланс клиента опускается ниже нормы, NexCMP списывает средства через [сохраненный способ оплаты](https://nexcmp.com/ru/docs/billing/saved-payment-methods/) и пополняет кошелек, предотвращая приостановку услуг. Фоновая задача проверяет клиентов **каждые 5 минут**.

## Требования {#requirements}

| Параметр | Требование |
|---|---|
| Канал | Настроен [Stripe](https://nexcmp.com/ru/docs/billing/stripe/) и/или [PayPal](https://nexcmp.com/ru/docs/billing/paypal/). |
| Сохраненный способ | У клиента сохранена карта или аккаунт PayPal. |
| Сайт | Основной сайт или сайт реселлера, платежи Stripe/PayPal которого принимает платформа. |
| Глобальный переключатель | Параметр **Auto top-up enabled** включен (по умолчанию включен). |

## Принцип работы {#how-it-works}

После **первого пополнения через Stripe или PayPal** сервер сохраняет способ оплаты и включает автопополнение в режиме **By usage** — только если клиент никогда не настраивал автопополнение сам. Дополнительного флажка на экране депозита нет; сервер фиксирует время, IP-адрес и метод в качестве подтверждения. Если позже клиент отключит автопополнение, автоматически оно больше не включится.

| Режим | Триггер (баланс ниже ...) | Сумма списания |
|---|---|---|
| **By usage** (по умолчанию после первого пополнения) | стоимость следующих 24 часов работы сервисов (почасовые VM плюс предоплатные продления, наступающие через 24 часа), но не менее **$5** | стоимость 24 часов, округленная вверх до целого доллара: не менее [minimum top-up](https://nexcmp.com/ru/docs/billing/minimum-top-up/), не более максимального пополнения и дневного лимита |
| **Fixed amount** | порог, заданный клиентом (от $1 до $500) | сумма, заданная клиентом (от минимального пополнения до $1,000 и строго больше порога) |

Если запущенных сервисов нет, в режиме **By usage** списания не производятся.

При сравнении с порогом учитываются только **реальные средства на балансе**. Бонусные средства по промокодам хранятся отдельно и не учитываются (см. [Promotions](https://nexcmp.com/ru/docs/billing/promotions/)).

Комиссия обрабатывается как при обычном пополнении: если опция **Customer pays top-up fee** включена, с карты списывается сумма плюс комиссия, а на баланс поступает полная сумма; если выключена — на баланс зачисляется сумма за вычетом комиссии.

## Настройка глобальных лимитов {#configure-the-global-limits}

1. Откройте **Finance › Payment channels › Fees & limits** (`/payments/fees`).
2. В **Auto top-up (Stripe / PayPal)** задайте:

   | Настройка | По умолчанию | Диапазон | Значение |
   |---|---|---|---|
   | Auto top-up enabled | On | on или off | Значение Off немедленно останавливает все фоновые списания. |
   | Порог автопополнения по умолчанию (USD, резервный для фиксированного режима) | $5.00 | от $0 до $10,000 | Используется только как начальный порог в фиксированном режиме. |
   | Макс. число автопополнений за 24 ч на клиента | 3 | от 1 до 50 | Учитываются успешные попытки и попытки в обработке. |
   | Лимит суммы автопополнений за 24 ч на клиента (USD) | $500.00 | от $0 до $1,000,000 | Общая сумма автосписаний за скользящие сутки. |

3. Нажмите **Save Wallet & top-up**.

![Раздел Auto top-up страницы Fees and limits с общим переключателем и суточными лимитами](https://nexcmp.com/ru/docs/images/billing/auto-top-up-01-limits.webp)

## Что видит клиент {#what-the-customer-sees}

1. В портале клиент открывает **Billing** и нажимает **Settings**.
2. На панели отображаются сохраненные методы, переключатель on/off, режим (**By usage** или **Fixed amount**), расчетный текущий расход, сумма следующего списания и блок **Recent automatic top-ups**.
3. Переключение на **Fixed amount** позволяет указать порог и сумму. Выключение переключателя прекращает списания.

![Настройки биллинга клиента с автопополнением в режиме By usage и списком недавних автоматических пополнений](https://nexcmp.com/ru/docs/images/billing/auto-top-up-02-portal.webp)

## Проверка {#verify}

1. Под тестовым клиентом выполните первое пополнение с тестовой карты ([Stripe](https://nexcmp.com/ru/docs/billing/stripe/#verify)). Откройте **Billing › Settings**: автопополнение включено.
2. Запустите небольшую VM, чтобы появился расход, и снизьте баланс ниже порогового значения (например, через **Customers › customer › Credit / debit**).
3. Примерно через 5 минут произойдет списание. В карточке клиента **Overview › Payment** в блоке **Auto top-up history** отобразится попытка со статусом *Done*, а клиенту отправится уведомление *Top-up received*.

## Ограничения и примечания {#limits-notes}

- **Одно списание за одно падение баланса.** После списания задача ожидает, пока баланс снова не поднимется выше порогового значения или не истечет время ожидания: 1 час после успешного списания, 24 часа после незавершенного платежа, 30 минут после системной ошибки.
- **Дневные лимиты.** При достижении любого из дневных лимитов списание не выполняется, а в журнал записывается строка *Daily limit reached* (не чаще одного раза в 6 часов).
- **Ошибки.** Отклонение карты, истекший срок действия или недостаточность средств считаются ошибкой карты. Задача повторяет попытку через 1 час, затем через 6 часов, затем через 24 часа. **После 3 последовательных ошибок карты автопополнение отключается**, а клиент получает уведомление (*Auto top-up failed*). Платеж, требующий подтверждения клиентом (например, 3-D Secure), не считается ошибкой; клиенту предлагается его подтвердить.
- **Без двойных списаний.** Каждое списание блокируется атомарно при падении ниже порога и использует ключ идемпотентности на стороне шлюза.
- **Удаление карты** отключает автопополнение.
- **Реселлеры.** Если реселлер использует собственный платежный канал, клиент не может включить автопополнение (HTTP 403 `feature_disabled`).

## Устранение неполадок {#troubleshooting}

| Симптом | Причина | Решение |
|---|---|---|
| Клиент не может включить: "Top up once with a card or PayPal" | Нет сохраненного способа оплаты | Сначала выполните одно пополнение картой или через PayPal. |
| Ошибка `no_card` (422) | Для выбранного шлюза нет сохраненного способа оплаты | Выберите шлюз, у которого он есть, или сохраните способ оплаты. |
| Ошибка `invalid_argument` в сумме | Режим Fixed вне допустимого диапазона | Порог $1–$500, сумма между минимальным пополнением и $1,000, сумма превышает порог. |
| Списание не происходит, хотя баланс низкий | Глобальный переключатель выключен, нет запущенных сервисов в режиме By usage, достигнут дневной лимит или предыдущее списание все еще ожидает | Проверьте переключатель, историю и лимиты. |
| "N неудачных попыток подряд — автопополнение отключается после 3" | Постоянные сбои при оплате картой | Клиент заменяет карту, выполнив новое пополнение. |
| Статус *Needs your confirmation* | Банк требует 3-D Secure | Клиент один раз завершает обычное пополнение. |