Платежи: подключение провайдера

Провайдеры подключаются в проекте на странице «Платежи». Форма для всех одинаковая, различаются только реквизиты.

Что нужно заранее

  • Личный кабинет провайдера с выпущенными боевыми (или тестовыми) реквизитами.
  • Роль администратор в проекте: подключение и изменение платёжных реквизитов другим ролям запрещено на сервере.
  • Понимание, в какой валюте вы принимаете оплату — она выбирается при подключении.

Права и доступы

Реквизиты хранятся в зашифрованном виде и доступны только проекту, в котором заведены. Изменять их может администратор проекта, просматривать состав подключения — участники с правом просмотра платежей.

Подключение и вебхук

  1. Откройте проект → «Платежи» → карточка нужного провайдера → «Подключить».
  2. Заполните «Название в проекте», «Валюта по умолчанию» и реквизиты провайдера. Тумблер «Тестовый режим» включайте, если у провайдера отдельный sandbox-кабинет.
  3. Нажмите «Сохранить подключение».

Адрес для уведомлений мы формируем сами и показываем в карточке провайдера после сохранения, а вот прописывается он в кабинете провайдера вручную: скопируйте адрес кнопкой и вставьте в поле для уведомлений (webhook / notification URL). Без этого шага оплата у клиента пройдёт, а заказ у вас не закроется.

Что заполнять по провайдерам:

  • ЮKassa — Shop ID и Secret Key.
  • Stripe — Publishable Key, Secret Key и Webhook Signing Secret.
  • Robokassa — Merchant Login, пароль №1 и пароль №2.
  • ЮMoney — номер кошелька и секрет уведомлений.
  • Т-Банк — Terminal Key и пароль.
  • CloudPayments — Public ID и API Secret.

Проверка

В карточке подключённого провайдера нажмите «Диагностика». Она делает безопасные запросы только на чтение и отвечает одним из трёх состояний: готов, заблокирован, не проверен. Там же видно, скопирован ли адрес уведомлений и заполнены ли обязательные поля.

После этого проведите тестовый платёж на минимальную сумму и убедитесь, что он появился в разделе платежей.

Частые ошибки

  • Заполнены не все обязательные поля. Карточка прямо перечислит, каких именно не хватает.
  • Забыли вставить адрес уведомлений в кабинет провайдера. Самая частая причина «оплата прошла, а бот молчит».
  • Оставили включённым тестовый режим с боевыми ключами. Карточка предупреждает об этом отдельной строкой: боевые платежи в этом режиме не принимаются.
  • Провайдер выключен. Подключение сохранено, но приём платежей не включён — включите провайдера в карточке.
  • Возврат недоступен. Возвраты через интерфейс поддерживают не все провайдеры; для остальных возврат делается в кабинете провайдера.