Встройте Invoicx в свой продукт
Предсказуемый REST API, официальные SDK на Python, JavaScript и Go, и песочница с тестовыми реквизитами. Запускайте первый счёт за минуты — без ожидания наboarding-команды.
OpenAPI 3.1 · Базовый URL api.invoicx.io/v1 · 1000 запросов/мин в песочнице
Первый счёт через REST API за 5 минут
Получите ключ, отправьте один запрос и получите счёт в PDF и JSON. Всё, что нужно для старта, — один endpoint и Bearer-токен.
Создайте ключ
В консоли Invoicx нажмите «API → New key». Выдайте ix_live_ или ix_test_ токен и скопируйте его — повторно он не показывается.
Отправьте запрос
POST на /v1/invoices с телом: контрагент, позиции, НДС 20%, условия оплаты. Ответ вернёт ID и ссылку на готовый PDF.
Подпишите и вышлите
Добавьте заголовок X-Signature и укажите e-mail получателя — счёт уйдёт автоматически, а статус придёт вебхуком.
curl -X POST https://api.invoicx.io/v1/invoices \ -H "Authorization: Bearer ix_live_8f3a2c91d4" \ -H "Content-Type: application/json" \ -d '{"client":"ООО «Сигма Логистик»","items":[{"sku":"SL-4471","qty":12,"unit_price":48500,"vat":20}],"due_days":30}'
Готовые библиотеки на трёх языках
SDK обёртывают REST API, добавляют типизацию, ретраи и идемпотентность. Ставятся в один пакет и покрыты тестами на каждый релиз.
invoicx-py
Полная типизация через dataclasses, асинхронный клиент на httpx и контекстный менеджер для транзакций. Установка — pip install invoicx.
@invoicx/sdk
TS-first клиент с исчерпывающими типами и автоматическим разбором ошибок. Работает в Node, Edge и браузере. Установка — npm i @invoicx/sdk.
github.com/invoicx/go
Лёгкий клиент без тяжёлых зависимостей, нативная поддержка контекстов и идемпотентных ключей. Установка — go get github.com/invoicx/go.
Тестируйте без реальных денег
Отдельный изолированный контур с фиксированными реквизитами и мгновенным ответом по платежам. Идеально для CI и автотестов.
Стабильный контракт, понятные правила
Версии явные и обратимые: вы всегда знаете, с каким поведением работаете. Изменения анонсируются минимум за 90 дней.
Актуальная
Текущая версия API (v1.4.2). Новые поля добавляются только непараметрически и не ломают существующие клиенты.
Legacy
Поддерживается до 31 марта 2026 года. После этого дата доступ к v0 отключится, клиенты перейдут на v1.
Идемпотентность
Для каждого POST передайте уникальный ключ — повторный запрос вернёт исходный результат вместо дублирования счёта.
События
Подписывайтесь на invoice.paid, invoice.overdue и payment.refunded — события подписаны HMAC-SHA256.
Коротко о главном
В песочнице — 1000 запросов в минуту без ограничений по объёму. В продакшене лимиты зависят от тарифа: от 600 до 6000 запросов/мин. Превышение возвращает код 429 с заголовком Retry-After.
Каждое событие несёт заголовок X-Invoicx-Signature — это HMAC-SHA256 от тела запроса с вашим webhook-secret. Сравните вычисленную подпись с полученной и отклоните запрос при несовпадении.
Да. Актуальная спецификация в формате OpenAPI 3.1 доступна по адресу /v1/openapi.json и обновляется вместе с каждым релизом. По ней можно генерировать клиентский код автоматически.
Коды 4xx — ошибка запроса: проверьте тело и заголовки, повторять без изменений бессмысленно. Для 5xx используйте экспоненциальный бэкофф и передайте идемпотентный ключ, чтобы не дублировать счёт.
Подключите Invoicx к своему продукту
Зарегистрируйте аккаунт разработчика и получите тестовый ключ вместе с доступом к песочнице и OpenAPI-спецификации.