Платёжные шлюзы

Назначение

Каждый шлюз — конфигурация интеграции с провайдером (Stripe, YooKassa, PayPal и др. — фактический список зависит от развёрнутых модулей BillBill). Платёж создаётся в контексте выбранного шлюза и валюты счёта.

Настройка в админ-панели

1. Откройте Настройки (/configuration) или профиль мерчанта — раздел платёжных шлюзов.
2. Создайте шлюз (gatewaySetup / форма в UI), укажите ключи API провайдера (секреты хранятся на стороне BillBill).
3. Настройте доступные валюты и страны при необходимости.
4. Получите URL входящего webhook для шлюза: метод API gatewaySetupWebhook возвращает gatewayWebhookUrl, который нужно зарегистрировать в кабинете провайдера.

Webhook на стороне провайдера

Без корректных webhook-уведомлений статусы платежей в BillBill не обновятся автоматически. После смены окружения (тест/бой) проверьте URL и секрет webhook заново.

Несколько шлюзов

Мерчант может иметь несколько шлюзов; выбор шлюза при оплате зависит от настроек пользователя/подписки и доступности валюты. В админке можно задавать порядок отображения (gatewayEditSort).

Безопасность

• Не встраивайте секретные ключи шлюза в фронтенд; используйте только сервер BillBill и Merchant API.
• Ключ Merchant API храните в секрет-хранилище вашего приложения.

Дальше: Интеграция и клиент.