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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

6. Проверка

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

---

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