Интегрируйте Bilify за один вечер

Один источник правды для ваших денег

Bilify API — это REST-интерфейс поверх всего, что происходит в кабинете: счета, клиенты, напоминания, платежи и отчёты. Вы управляете всем программно, а интерфейс остаётся для проверки.

Базовый адрес — https://api.bilify.ru/v2. Все запросы и ответы в JSON, кодировка UTF-8. Методы предсказуемы: GET для чтения, POST для создания, PATCH для обновления, DELETE для отмены. Каждый ресурс имеет стабильный идентификатор вида inv_9f3a21, который можно использовать в любых последующих запросах.

Ключевые ресурсы: invoices (счета), customers (клиенты), reminders (напоминания), payments (оплаты) и reports (отчёты). Для событий в реальном времени доступны вебхуки, которые отправляют подписанный JSON на ваш URL — так вы узнаёте об оплате в моменте, не опрашивая API.

Для быстрого старта есть SDK на Python, Node.js и Go. Они обёртывают аутентификацию, пагинацию и повторные попытки при сбоях, поэтому можно начать с пары строк кода.

От счёта до оплаты — за несколько строк

Несколько типовых сценариев, которые покрывают 90% интеграций. Копируйте и подставляйте свои данные.

Создать счёт. Отправляете POST /invoices с идентификатором клиента, строками и суммой. В ответе — готовый счёт с идентификатором и ссылкой для оплаты:

POST /v2/invoices
{
  "customer_id": "cus_4b8d2e",
  "lines": [{"description": "Разработка лендинга", "amount": 120000}],
  "due_date": "2024-03-15",
  "number": "INV-2024-0117"
}
→ 201 · "id": "inv_9f3a21"

Поставить напоминание. Указываете счёт и тон — Bilify подберёт дату и сформулирует письмо мягко:

POST /v2/reminders
{ "invoice_id": "inv_9f3a21", "tone": "soft", "schedule": "auto" }
→ 202 · "send_at": "2024-03-14T09:00:00Z"

Получить событие об оплате. Подписываете вебхук на payment.received и в обработчике просто обновляете свой заказ — без опроса и таймеров.

Сколько можно и что будет при превышении

Лимиты зависят от тарифа и помогают держать API стабильным. Всё прозрачно и предсказуемо.

В тарифе «Студия» — 120 запросов в минуту и до 50 000 операций в месяц. В «Бизнес» — 300 запросов в минуту и 250 000 операций, плюс приоритетная очередь вебхуков. При превышении лимита API возвращает код 429 с заголовком Retry-After, указывающим, через сколько секунд повторить. Ответы на ошибки всегда в едином формате: error.code, error.message и request_id для обращения в поддержку.

Вебхуки отправляются с автоматическими повторами: если ваш сервер не ответил за 10 секунд, событие придёт повторно до 8 раз в течение 24 часов. Дубликаты можно отфильтровать по уникальному event_id. Для больших объёмов есть отдельный тариф «Инфраструктура» с выделенным лимитом и SLA — напишите нам, подберём параметры под вашу нагрузку.