# Invoicebox API — documentation

> Technical documentation of the Invoicebox payment service: accepting payments from companies and sole traders, API v3, webhook notifications, refunds, references. Closing documents (act, UPD, invoice) are produced automatically.
> 8 of 148 pages are translated into English; the rest are served in Russian at the same addresses.

## How to integrate (instructions for an agent)

1. Base URL: https://api.invoicebox.ru. New integrations use /v3/ only. The /l3/ prefix exists for merchants integrated earlier via the Invoicebox.Business cabinet: it supports every method but should not be used in a new integration.
2. Authorisation: header `Authorization: Bearer <integration token>`. Demo access for experiments: token `b37c4c689295904ed21eee5d9a48d42e`, merchant `ffffffff-ffff-ffff-ffff-ffffffffffff`.
3. Required headers: `Content-Type: application/json`, `User-Agent: <application>/<version>`.
4. SAFETY-CRITICAL — there is NO idempotency on order creation by default: `merchantOrderId` uniqueness is NOT checked, and a repeated POST creates a SECOND order for the same purchase. If the response was lost, do not change the number and do not retry immediately: query `GET /v3/filter/api/order/order?merchantOrderId=<number>` and retry only if the order is absent (a created order is visible in the listing immediately, so an empty answer is final). For a refund search by its own `merchantOrderId` in `/v3/filter/api/order/refund-order`; for a cancellation check the order status (`canceled` means it went through). Server-side uniqueness is enabled by the merchant in the cabinet (https://app.invoicebox.ru → My sales → Shops → General information, the «Проверять уникальность номера заказа» toggle) — only then a repeated number returns `merchant_order_id_duplicate`. It is mandatory before go-live. Full procedure: https://docs.invoicebox.ru/docs/merchant/order/create/#повтор-после-сбоя-и-таймаута
5. Machine-readable contract: https://docs.invoicebox.ru/schemas/openapi/invoicebox.yaml — every method in one file (OpenAPI 3.1); Postman collection — https://docs.invoicebox.ru/schemas/invoicebox.postman_collection.json.
6. Any page is available as markdown: append `.md` to the URL or use https://docs.invoicebox.ru/raw/en/<path>.md.
7. Limits: 100 requests / 30 s per account, 500 / 30 s per IP (answer 429).
8. The usual payment flow: create an order (POST /v3/billing/api/order/order) → take paymentUrl → wait for the payment notification on your URL (see https://docs.invoicebox.ru/en/docs/merchant/notification/status/) → refund if needed (POST /v3/billing/api/order/refund-order).
9. Term map — "invoice" is a false friend here. Order is what the supplier (merchant) creates via POST /v3/billing/api/order/order and works with; payment information arrives per order. When the docs say "issue an invoice to the buyer", technically an Order is created. OrderContainer is a group of orders united by one buyer payment process, possibly from several suppliers. Invoice is what the buyer receives and pays; it is formed for a container (group) of orders, so one invoice may carry several orders from one or several suppliers. Payment is a transaction towards paying an invoice; an invoice may be paid by one or several transactions. Merchant is the sales point that owns the token and settings; Counterparty is the legal entity that owns merchants. Invoicebox.Business is the Invoicebox cabinet where organisations work with the guarantee fund; the entities there are the same.


## Подключение к API

- [Авторизация](https://docs.invoicebox.ru/raw/en/api/auth.md)
- [Выборки и фильтры](https://docs.invoicebox.ru/raw/en/api/filters.md)
- [Использование веб-сокетов](https://docs.invoicebox.ru/raw/en/api/websockets.md)
- [Подключение к API](https://docs.invoicebox.ru/raw/en/api/api.md)
- [Логирование и отладка](https://docs.invoicebox.ru/raw/en/api/debug.md)
- [Мониторинг](https://docs.invoicebox.ru/raw/en/api/monitoring.md)
- [Ограничения](https://docs.invoicebox.ru/raw/en/api/limits.md)
- [Работа в Postman](https://docs.invoicebox.ru/raw/en/api/postman.md)

## Инвойсбокс ID

- [Инвойсбокс ID](https://docs.invoicebox.ru/raw/en/id/id.md)
- [Подключение](https://docs.invoicebox.ru/raw/en/id/connect.md)
- [Стандартный OAuth 2.1](https://docs.invoicebox.ru/raw/en/id/oauth.md)
- [Справочник запросов](https://docs.invoicebox.ru/raw/en/id/reference.md)
- [Сессия и безопасность](https://docs.invoicebox.ru/raw/en/id/session.md)
- [Экран согласия](https://docs.invoicebox.ru/raw/en/id/oauth/consent.md)
- [Обмен кода на токен](https://docs.invoicebox.ru/raw/en/id/oauth/token.md)
- [Обновление токена](https://docs.invoicebox.ru/raw/en/id/oauth/refresh.md)
- [Отзыв доступа](https://docs.invoicebox.ru/raw/en/id/oauth/revoke.md)

## Приём платежей (мерчанту)

- [Платёжные инструменты для B2B](https://docs.invoicebox.ru/raw/en/merchant/payment-instruments.md)
- [Онлайн касса (ФЗ-54)](https://docs.invoicebox.ru/raw/en/merchant/fz54.md)
- [Честный знак](https://docs.invoicebox.ru/raw/en/merchant/honest-sign.md)
- [Данные для интеграции](https://docs.invoicebox.ru/raw/en/merchant/integrationdata.md)
- [Приём платежей](https://docs.invoicebox.ru/raw/en/merchant/merchant.md)
- [Платёжная страница](https://docs.invoicebox.ru/raw/en/merchant/payment-page.md)
- [Уведомление о смене статуса](https://docs.invoicebox.ru/raw/en/merchant/notification/status.md)
- [1С Битрикс](https://docs.invoicebox.ru/raw/en/merchant/cms/1c-bitrix.md)
- [amoCRM](https://docs.invoicebox.ru/raw/en/merchant/crm/amocrm.md)
- [iiko](https://docs.invoicebox.ru/raw/en/merchant/erp/iiko.md)
- [Схема взаимодействия](https://docs.invoicebox.ru/raw/en/merchant/guarantee/schema.md)
- [Создание заказа](https://docs.invoicebox.ru/raw/en/merchant/order/create.md)
- [Сирена Тревел/МПС (EgoPay)](https://docs.invoicebox.ru/raw/en/merchant/pss/mps.md)
- [Оформление возврата](https://docs.invoicebox.ru/raw/en/merchant/refund/create.md)
- [Физические лица](https://docs.invoicebox.ru/raw/en/merchant/schema/private.md)
- [Схемы взаимодействия](https://docs.invoicebox.ru/raw/en/merchant/schema/schema.md)
- [PHP SDK](https://docs.invoicebox.ru/raw/en/merchant/sdk/php.md)
- [retailCRM](https://docs.invoicebox.ru/raw/en/merchant/crm/retailcrm.md)
- [Создание группы заказов](https://docs.invoicebox.ru/raw/en/merchant/order/create-order-container.md)
- [Создание заказа с холдированием](https://docs.invoicebox.ru/raw/en/merchant/order/hold.md)
- [Создание заказа агентом](https://docs.invoicebox.ru/raw/en/merchant/order/agent-create.md)
- [WordPress](https://docs.invoicebox.ru/raw/en/merchant/cms/woocommerce.md)
- [SportCRM](https://docs.invoicebox.ru/raw/en/merchant/crm/sportcrm.md)
- [Bnovo](https://docs.invoicebox.ru/raw/en/merchant/erp/bnovo.md)
- [Проверка возможности оплаты](https://docs.invoicebox.ru/raw/en/merchant/guarantee/validate.md)
- [Услуга не может быть оказана](https://docs.invoicebox.ru/raw/en/merchant/notification/shipping-unavailable.md)
- [ТАИС (TravelShop)](https://docs.invoicebox.ru/raw/en/merchant/pss/tais.md)
- [Получение возвратов](https://docs.invoicebox.ru/raw/en/merchant/refund/get.md)
- [Организации и ИП](https://docs.invoicebox.ru/raw/en/merchant/schema/legal.md)
- [Отмена возврата](https://docs.invoicebox.ru/raw/en/merchant/refund/delete.md)
- [Документооборот](https://docs.invoicebox.ru/raw/en/merchant/documentflow/documentflow.md)
- [События документооборота](https://docs.invoicebox.ru/raw/en/merchant/documentflow/edo_events.md)
- [OpenCart 2.x](https://docs.invoicebox.ru/raw/en/merchant/cms/opencartv2.md)
- [Запрос кода подтверждения](https://docs.invoicebox.ru/raw/en/merchant/guarantee/code.md)
- [Не процессинговые заказы](https://docs.invoicebox.ru/raw/en/merchant/order/non-processable-order.md)
- [Работа с заказом](https://docs.invoicebox.ru/raw/en/merchant/order/order.md)
- [Возврат с комиссией/штрафом](https://docs.invoicebox.ru/raw/en/merchant/refund/correction.md)
- [Комиссионная торговля](https://docs.invoicebox.ru/raw/en/merchant/schema/commission.md)
- [OpenCart 3.x](https://docs.invoicebox.ru/raw/en/merchant/cms/opencartv3.md)
- [Получение заказа](https://docs.invoicebox.ru/raw/en/merchant/order/get.md)
- [Работа с возвратом](https://docs.invoicebox.ru/raw/en/merchant/refund/refund.md)
- [Запрос о платеже](https://docs.invoicebox.ru/raw/en/merchant/schema/rtp.md)
- [Tilda](https://docs.invoicebox.ru/raw/en/merchant/cms/tilda.md)
- [Обработка уведомлений](https://docs.invoicebox.ru/raw/en/merchant/notification/notification.md)
- [Изменение заказа](https://docs.invoicebox.ru/raw/en/merchant/order/update.md)
- [Гарантийный фонд: подтверждение оплаты](https://docs.invoicebox.ru/raw/en/merchant/guarantee/guarantee.md)
- [Аспро Корпоративный сайт](https://docs.invoicebox.ru/raw/en/merchant/cms/aspro.md)
- [Отмена заказа](https://docs.invoicebox.ru/raw/en/merchant/order/delete.md)
- [SDK](https://docs.invoicebox.ru/raw/en/merchant/sdk/sdk.md)
- [Подтверждение оплаты заказа](https://docs.invoicebox.ru/raw/en/merchant/guarantee/pay.md)
- [Создание отгрузки](https://docs.invoicebox.ru/raw/en/merchant/order/shipment_create.md)
- [Платёжные виджеты на сайт](https://docs.invoicebox.ru/raw/en/merchant/widget/widget.md)
- [Модули для CMS](https://docs.invoicebox.ru/raw/en/merchant/cms/cms.md)
- [Получение отгрузки](https://docs.invoicebox.ru/raw/en/merchant/order/shipment_get.md)
- [Модули для CRM](https://docs.invoicebox.ru/raw/en/merchant/crm/crm.md)
- [Изменение отгрузки](https://docs.invoicebox.ru/raw/en/merchant/order/shipment_update.md)
- [Virtuemart](https://docs.invoicebox.ru/raw/en/merchant/cms/virtuemart.md)
- [Модули для ERP](https://docs.invoicebox.ru/raw/en/merchant/erp/erp.md)
- [Смена магазина](https://docs.invoicebox.ru/raw/en/merchant/order/merchant-move.md)
- [Joomshopping](https://docs.invoicebox.ru/raw/en/merchant/cms/joomshopping.md)
- [Смена статуса заказа](https://docs.invoicebox.ru/raw/en/merchant/order/order-status-update.md)
- [Интеграции с PSS/GDS](https://docs.invoicebox.ru/raw/en/merchant/pss/pss.md)
- [InSales](https://docs.invoicebox.ru/raw/en/merchant/cms/insales.md)
- [Prestashop](https://docs.invoicebox.ru/raw/en/merchant/cms/prestashop.md)
- [Рекуррентные платежи](https://docs.invoicebox.ru/raw/en/merchant/order/recurring.md)
- [VirtualityCMS](https://docs.invoicebox.ru/raw/en/merchant/cms/vicms.md)
- [Метаданные](https://docs.invoicebox.ru/raw/en/merchant/order/metadata.md)
- [Требования](https://docs.invoicebox.ru/raw/en/merchant/cms/requirements.md)

## Проведение платежей

- [Схема взаимодействия](https://docs.invoicebox.ru/raw/en/payment/schema.md)
- [Получение счёта](https://docs.invoicebox.ru/raw/en/payment/get.md)
- [Подтверждение оплаты счёта](https://docs.invoicebox.ru/raw/en/payment/confirm_payment.md)
- [Вход через ID вашего банка](https://docs.invoicebox.ru/raw/en/payment/auth-id.md)
- [Платёжные инструменты и банки](https://docs.invoicebox.ru/raw/en/payment/payment.md)

## Инвойсбокс.Бизнес

- [Схема взаимодействия](https://docs.invoicebox.ru/raw/en/business/schema.md)
- [Получение счёта](https://docs.invoicebox.ru/raw/en/business/get.md)
- [Подтверждение оплаты счёта](https://docs.invoicebox.ru/raw/en/business/confirm_payment.md)
- [Инвойсбокс.Бизнес](https://docs.invoicebox.ru/raw/en/business/business.md)

## Маркетплейс и мини-приложения

- [Добавление точки продаж](https://docs.invoicebox.ru/raw/en/marketplace/create.md)
- [Обновление точки продаж](https://docs.invoicebox.ru/raw/en/marketplace/update.md)
- [Акции и спецпредложения](https://docs.invoicebox.ru/raw/en/marketplace/special-offer.md)
- [Маркетплейс](https://docs.invoicebox.ru/raw/en/marketplace/marketplace.md)
- [Общая информация](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/description.md)
- [Схема взаимодействия](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/schema.md)
- [Настройка заголовков](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/frame.md)
- [Мини-приложения](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/mini-apps.md)
- [Структура приложения](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/structure.md)
- [MiniApp SDK](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/miniapp-sdk.md)
- [Библиотека компонентов](https://docs.invoicebox.ru/raw/en/marketplace/mini-apps/components.md)

## Партнёрское API

- [Банки, PSP и агрегаторы](https://docs.invoicebox.ru/raw/en/partner/payment-service-provider.md)
- [Партнёрское API](https://docs.invoicebox.ru/raw/en/partner/partner.md)
- [Интеграция магазина](https://docs.invoicebox.ru/raw/en/partner/integration/integration.md)
- [Отправка приглашения](https://docs.invoicebox.ru/raw/en/partner/integration/invite.md)
- [Активация магазина по коду](https://docs.invoicebox.ru/raw/en/partner/integration/activation.md)

## Сценарии применения

- [Сценарии и бизнес-кейсы](https://docs.invoicebox.ru/raw/en/scenarios/scenarios.md)
- [🕓 B2B продажи 24/7](https://docs.invoicebox.ru/raw/en/scenarios/b2b-sales.md)
- [✈️ B2B продажи авиабилетов](https://docs.invoicebox.ru/raw/en/scenarios/air-carriers.md)
- [🛍️ B2B продажи товаров](https://docs.invoicebox.ru/raw/en/scenarios/retail.md)
- [🍽️ Системы автоматизации ресторанов](https://docs.invoicebox.ru/raw/en/scenarios/ras.md)
- [🚆 B2B продажи ж/д билетов](https://docs.invoicebox.ru/raw/en/scenarios/railway-carriers.md)
- [🏨 Управление средствами размещения (PMS)](https://docs.invoicebox.ru/raw/en/scenarios/pms.md)
- [⛽ B2B продажи на АЗС](https://docs.invoicebox.ru/raw/en/scenarios/gas.md)
- [🚕 B2B продажи такси и трансфера](https://docs.invoicebox.ru/raw/en/scenarios/taxi.md)
- [⭐ B2B продажи бизнес-залов](https://docs.invoicebox.ru/raw/en/scenarios/business-lounge.md)
- [☂️ B2B продажи услуг страхования пассажиров](https://docs.invoicebox.ru/raw/en/scenarios/insurance.md)
- [📦 Аренда складов, офисов и коворкингов](https://docs.invoicebox.ru/raw/en/scenarios/warehouses.md)
- [☁️ Подписки на сервисы для юрлиц (SaaS, хостинг, телеком)](https://docs.invoicebox.ru/raw/en/scenarios/saas.md)
- [🏦 Прямые расчёты с контрагентами](https://docs.invoicebox.ru/raw/en/scenarios/direct-settlements.md)
- [🧾 Автоматизация дебиторки: счёт, оплата, закрытие](https://docs.invoicebox.ru/raw/en/scenarios/receivables.md)
- [🛒 Маркетплейс и сплит-корзина](https://docs.invoicebox.ru/raw/en/scenarios/marketplace-split.md)
- [🧩 Приём платежей без разработчика](https://docs.invoicebox.ru/raw/en/scenarios/no-code.md)
- [🎓 Корпоративное обучение и ДПО](https://docs.invoicebox.ru/raw/en/scenarios/education.md)
- [📚 Онлайн-школы и курсы](https://docs.invoicebox.ru/raw/en/scenarios/online-education.md)
- [🎪 Событийная индустрия: конференции и выставки](https://docs.invoicebox.ru/raw/en/scenarios/events.md)
- [🏷️ Маркированные товары (Честный знак)](https://docs.invoicebox.ru/raw/en/scenarios/marked-goods.md)
- [🚛 Логистика и грузоперевозки](https://docs.invoicebox.ru/raw/en/scenarios/logistics.md)
- [⚡ Запрос о платеже (RtP)](https://docs.invoicebox.ru/raw/en/scenarios/rtp.md)
- [💳 Холдирование средств](https://docs.invoicebox.ru/raw/en/scenarios/guarantee.md)
- [📱 Оплата внутри приложения без платёжной страницы](https://docs.invoicebox.ru/raw/en/scenarios/in-app.md)
- [🤖 Счёт из чата с ассистентом](https://docs.invoicebox.ru/raw/en/scenarios/ai-agent.md)

## Справочники

- [Коды ОКЕИ](https://docs.invoicebox.ru/raw/en/dictionary/okei.md)
- [Поиск по ИНН](https://docs.invoicebox.ru/raw/en/dictionary/counterparty-detail.md)
- [Коды валют](https://docs.invoicebox.ru/raw/en/dictionary/iso4217.md)
- [Признак предмета расчёта (тег 1212)](https://docs.invoicebox.ru/raw/en/dictionary/tag1212.md)
- [Мера количества предмета расчёта (тег 2108)](https://docs.invoicebox.ru/raw/en/dictionary/tag2108.md)
- [Ставка НДС (тег 1199)](https://docs.invoicebox.ru/raw/en/dictionary/tag1199.md)
- [Справочники](https://docs.invoicebox.ru/raw/en/dictionary/dictionary.md)
- [Коды ошибок](https://docs.invoicebox.ru/raw/en/dictionary/error.md)

## Дизайн

- [Дизайн-система](https://docs.invoicebox.ru/raw/en/design/design.md)

## Общие страницы

- [Термины и определения](https://docs.invoicebox.ru/raw/en/definition.md)
- [Сроки и условия расчётов](https://docs.invoicebox.ru/raw/en/terms.md)
- [Безопасность работы с API](https://docs.invoicebox.ru/raw/en/security.md)