Как подключить BillBill из SaaS или магазина

Ниже — типовая последовательность для серверной интеграции без пользовательского портала BillBill.

Шаги

1. Ключ API — один раз: newApikey, хранение в секретах.
2. Синхронизация пользователя — при регистрации в вашем продукте создайте или найдите пользователя в BillBill (методы Merchant API для пользователей мерчанта).
3. Каталог — продукты и планы создаются заранее в админке или через productNew / planNew.
4. Оформление покупки — subscriptionCreatePreview → отображение суммы пользователю (если нужно) → subscriptionCreateSubmit.
5. Метрики — при usage вызывайте metricNewEvent.
6. Вебхуки — webhookNewEndpoint + обработчик payment.success, invoice.paid, subscription.cancelled и т.д.
7. Продление и сбои — обрабатывайте subscription.auto_renew.failure, invoice.failed для dunning в вашем продукте.

Диаграмма последовательности

Магазин разовых товаров

Для чисто разовых продаж без подписки используйте поток счёт + платёж (см. Разовая покупка); вебхуки invoice.paid / payment.success подтвердят оплату перед выдачей товара.

Ссылки

• Обзор интеграции
• Справочник событий