Подключение оплаты через Точку

Точка подключается как платёжный провайдер вашего проекта: подписчики платят
картой, а рекуррентные (автоматические) продления идут по сохранённой карте.
Ниже — что сделать на стороне Точки и как настроить приём оплат в MHUB.

ℹ️ Точка подключается по запросу. Настройку можно завести заранее —
кнопка подключения появится в приёме оплат после того, как платформа
откроет провайдер для вашего проекта.

1. Что нужно иметь

• Расчётный счёт для бизнеса в Точке (ИП / ООО / НКО).
• Доступ в интернет-банк Точки с правами администратора.

2. Получить JWT-токен и customerCode

1. В интернет-банке Точки откройте «Интеграции и API» и создайте
   JWT-токен для приложения. Отметьте права:
   • MakeAcquiringOperation — принимать оплаты и рекуррентные списания;
   • ReadAcquiringData — читать статус операций;
   • ReadCustomerData — получить customerCode;
   • ManageWebhookData — MHUB подпишет ваше приложение на уведомления об
     оплате (вебхук) автоматически, это право обязательно.
2. customerCode — идентификатор вашей организации как плательщика
   (список клиентов, метод Get Customers List в документации Точки).
3. merchantId — обычно НЕ нужен. Он требуется, только если у вас в
   интернет-эквайринге несколько торговых точек; тогда его берут методом
   Get Retailers. При одной торговой точке поле оставьте пустым.

⚠️ Токен — секрет. Он даёт доступ к приёму платежей от имени вашей
организации. Никому не пересылайте его; в MHUB он хранится в зашифрованном
виде и нигде не показывается полностью — только последние 4 символа как
подтверждение, что токен сохранён.

3. Настроить приём оплат в MHUB (через админ-бота)

1. Откройте админ-бот MHUB и выберите проект.
2. Настройки → Платёжные системы → 💛 Точка.
3. Нажмите «Подключить токен» и пришлите JWT-токен (без пробелов) — бот
   попросит customerCode. merchantId можно пропустить, если торговая точка
   одна.
4. Вебхук подключается автоматически. При сохранении токена MHUB сам
   подписывает ваше приложение на событие acquiringInternetPayment через
   API Точки — прописывать что-либо в кабинете Точки не нужно (поля для
   webhook-URL там нет). Если оплаты вдруг не подтверждаются автоматически,
   нажмите в меню Точки кнопку «Webhook URL» — она переподключит вебхук и
   покажет результат.
5. Пока идёт проверка — оставьте включённым «Тестрежим».
6. Кнопки «Сменить токен», «customerCode», «merchantId» позволяют
   обновить каждое значение по отдельности, не трогая остальные.
7. Кнопка «Приостановить» временно отключает приём через Точку, не удаляя
   настройки; «Отвязать» — удаляет их полностью.

Доступ в канал выдаётся автоматически после подтверждения оплаты.

4. Рекуррентные платежи (автопродление)

Рекуррент — списание по сохранённой карте без повторного ввода данных —
должен быть согласован с платформой MHUB перед включением. Если планируете
автопродления, напишите в поддержку MHUB. В боте этот флаг клиентом не
переключается (показан со значком 🔒).

5. Возвраты и чеки

• Возвраты делаются вручную через интернет-банк Точки — MHUB не
  инициирует возврат автоматически.
• Чеки (54-ФЗ) формируются на стороне Точки согласно настройкам вашей
  торговой точки — в MHUB для Точки нет отдельного тумблера фискализации.

6. Проверка

1. Заполните токен и customerCode, оставьте включённым тестовый режим
   (если Точка предоставила тестовый контур).
2. Проведите пробную оплату.
3. Убедитесь, что подписка активировалась (это подтверждает, что вебхук
   работает).
4. Выключите тестовый режим для боевого приёма.

---

Вопросы по стороне Точки — в поддержку интернет-банка; по настройке в MHUB —
напишите в поддержку MHUB.