Платежные каналы
В панели администратора: Finance › Payment channels (
/payments). Переключатели и комиссии: Finance › Payment channels › Fees & limits (/payments/fees).
В NexCMP используется предоплатный USD-кошелек. Клиенты пополняют кошелек через платежный канал; затем все услуги оплачиваются с этого кошелька. Канал отображается клиентам только тогда, когда он одновременно включен и настроен.
Назначение
Платежные каналы связывают ваши платежные аккаунты (Stripe, PayPal, Binance, вьетнамский банк) с кошельком клиента. Подтвержденный платеж формирует ровно одно зачисление на кошелек — каждое зачисление привязано к ID платежа в шлюзе, поэтому повторный вебхук никогда не зачислит средства дважды. Используйте эту страницу, чтобы увидеть, какие каналы готовы к работе, каковы их показатели за последние 30 дней и какие из них требуют внимания.
Требования
| Параметр | Требование |
|---|---|
| Публичный HTTPS-адрес | Шлюзы отправляют вебхуки на https://<domain>/v1/billing/..., поэтому ваша панель должна быть доступна из Интернета с действительным TLS-сертификатом (см. DNS и Cloudflare). |
| Учетные записи | Собственный аккаунт у каждого используемого провайдера. Учетные данные вводятся в панели администратора и больше никогда не отображаются (показываются только последние 4 символа). |
| Роль администратора | Учетная запись администратора. |
| Зависимости | Нет. Для банковского канала VN дополнительно требуется exchange rate. |
Каналы
| Канал | Что видит клиент | Где настраивается | Статья |
|---|---|---|---|
| Card (Stripe) | Форма карты, сохраненная карта | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | Кнопки кошельков (Stripe Express Checkout) | Stripe, плюс регистрация домена | Stripe |
| Alipay | Перенаправление в Alipay (списание через Stripe в JPY) | Stripe, плюс Fees & limits | Stripe |
| PayPal | Кнопки PayPal, сохраненный аккаунт PayPal | Payment channels › PayPal | PayPal |
| USDT | Адрес для пополнения и точная сумма | Payment channels › USDT | USDT |
| VN bank transfer | QR-код и реквизиты перевода (только в интерфейсе на вьетнамском языке) | Payment channels › VN bank transfer | Bank transfer (Vietnam) |
Подготовка инфраструктуры
Не требуется. Все настраивается в панели администратора; на сервер устанавливать ничего не нужно.
Подключение в NexCMP
- Перейдите в Finance › Payment channels (
/payments). В сводной таблице перечислены все каналы и их состояние. - Откройте вкладку нужного канала (Stripe, PayPal, USDT, VN bank transfer) и следуйте указаниям в соответствующей статье. Каждая вкладка содержит кнопку Save и, если применимо, кнопку Test.
- Перейдите в Fees & limits (
/payments/fees), найдите блок Payment gateways & fees (wallet top-up), включите канал с помощью переключателя и нажмите Save channels & fees.
Переключатели и комиссии (Fees & limits)
| Настройка | По умолчанию | Значение |
|---|---|---|
| Card (Stripe) | On | Форма ввода карты на экране пополнения. Скрыта, пока для Stripe не указан секретный ключ. |
| Apple Pay, Google Pay, Link | On | Кнопки кошельков. Отображаются только после подтверждения домена в Stripe. |
| Alipay | Выкл | Требуется активация Alipay в Stripe Dashboard. |
| PayPal | Выкл | Отображается только после настройки PayPal. |
| USDT (Binance) | Выкл | Переключатель заблокирован, пока адрес для пополнения не будет проверен через Binance. |
| Комиссия Stripe: % / фиксированная (в центах) | 3.6 % и 0 | Используется для отображения комиссии клиенту и расчета зачисляемой суммы. Укажите ваш фактический тариф Stripe. |
| Комиссия PayPal: % / фиксированная | 4.4 % и 30 cents | То же самое для PayPal. |
| USDT fee % | 1 % | То же самое для USDT. |
| Клиент оплачивает комиссию за пополнение | Выкл | On: клиент оплачивает сумму + комиссию, и на баланс зачисляется полная сумма. Off: комиссия вычитается, и на баланс зачисляется сумма за вычетом комиссии. |
Клиент всегда видит комиссию и итоговую сумму зачисления перед оплатой. Отключение канала скрывает кнопку, и сервер отклоняет новые платежи с method_disabled (HTTP 403).
Лимиты на пополнение
Минимальная и максимальная сумма одного пополнения настраиваются на той же странице — см. Minimum top-up.
Проверка
- В обзорной таблице для канала отображается Enabled и Configured; колонка Last test заполняется после нажатия Test на вкладке канала.
- Войдите в портал под тестовым клиентом и откройте Billing › Deposit. Кнопка канала отображается.
- Совершите небольшой платеж (тестовые карты и тестовые аккаунты описаны в статье канала). Баланс пополнится, появится уведомление Top-up received, а платеж отобразится в Finance › Billing › Top-ups (
/billing/deposits).
Ограничения и примечания
- Колонки обзора: 30 days (количество платежей, успешных, неудачных и общий объем), Stuck 24h (платежи в обработке более суток) и Unmatched (поступившие переводы USDT или банковские платежи без привязки к заказу). В строке KPI суммируются объем за 30 дней, количество проблемных каналов (включены без настройки или содержат зависшие платежи) и общее число нераспознанных платежей.
- События вебхуков перечислены в Payment channels › Gateway events (
/payments/events). У Stripe есть отдельная вкладка, а PayPal и USDT используют общую. Неудачное событие можно повторить — реестр кошелька идемпотентен, поэтому повторный запуск никогда не приведет к двойному зачислению. - Resellers могут использовать собственные каналы Stripe, PayPal, USDT и банковские переводы. Их строки также отображаются здесь, а селектор сайтов в шапке фильтрует их. См. Resellers.
- Возвраты: платежи Stripe и PayPal можно вернуть из списка платежей; платежи в USDT нельзя вернуть обратно источнику (сервер отвечает
usdt_no_refund). - Maintenance mode по-прежнему принимает вебхуки шлюзов, поэтому платеж, совершенный непосредственно перед обслуживанием, не будет потерян.
Устранение неполадок
| Симптом | Причина | Решение |
|---|---|---|
| Канал отсутствует на экране пополнения у клиента | Отключен, не настроен или (для вьетнамского банка) выбран не вьетнамский язык интерфейса | Проверьте Fees & limits и вкладку канала; см. Bank transfer (Vietnam). |
| Показатель KPI Faulty channels больше 0 | Канал включен без учетных данных либо платежи ожидают обработки более 24 часов | Откройте строку и нажмите Configure; для зависших платежей откройте Gateway events и выполните повтор. |
| Клиент оплатил счет, но баланс не изменился | Вебхук не поступил | Проверьте URL вебхука на вкладке канала, затем повторите событие в Gateway events. |
Сервер отвечает method_disabled | Переключатель выключен | Включите его в Fees & limits и сохраните изменения. |
| Переключатель USDT неактивен | Адрес для пополнения не верифицирован | Нажмите Test & verify address на вкладке USDT. |