С чего начать (облако)
Документ ориентирован на управляемый сервис BillBill: вы получаете доступ к админ-панели и API без установки API-сервера у себя.
1. Аккаунт и доступ
- Зарегистрируйте организацию/мерчанта в облаке BillBill.
- Войдите в админ-панель.
- При необходимости пригласите коллег через раздел администраторов (
/admin/*) с ролями и правами.
2. Ключ Merchant API
- Откройте профиль мерчанта / настройки (
/merchantили блок API-ключей в конфигурации). - Создайте OpenAPI-ключ (в JS-клиенте метод
newApikey). - Для серверных вызовов укажите в User-Agent подстроку
OpenAPI(требование API BillBill). - Передавайте ключ в заголовке
Authorization: Bearer <ключ>(по умолчанию в@wilix/billbill-client-js).
Базовый URL production по умолчанию в клиенте: https://api.billbill.ru (можно переопределить).
3. Минимальная цепочка перед продажами
- Продукт и план — каталог.
- Платёжные шлюзы — хотя бы один активный шлюз и webhook у провайдера.
- (Опционально) Метрики — если нужен usage или лимиты.
- (Опционально) Шаблоны счетов — брендированный PDF/HTML.
4. Песочница и прод
Уточните у поддержки BillBill, выделены ли отдельные ключи и шлюзы для теста (зависит от договора). В документации предполагается, что тестовые карты/методы настраиваются в том же интерфейсе шлюза, что и для боя, но в тестовом режиме провайдера.