Как встроить выставление счетов на свой сайт или сервис

Apiin можно использовать как движок выставления счетов внутри вашего продукта: сайт или сервис создаёт счета через REST API, показывает клиенту публичную ссылку с QR, а статусы оплаты получает вебхуками.

Получить API-ключ Как это работает

Создание счетов через API

В момент оформления заказа ваш сервис отправляет в Apiin запрос на создание счёта: реквизиты продавца и покупателя, позиции, НДС-режим. В ответ приходит идентификатор документа и ссылки — на PDF и на публичную страницу счёта.

Реквизиты покупателя можно не запрашивать вручную: Apiin умеет автозаполнять их по ИНН и БИК. Автонумерация настраивается на уровне аккаунта, контрагента или заказа, поэтому номера остаются сквозными и корректными. Точные эндпоинты и поля — на /docs/api.

Публичная ссылка и оплата по QR

Каждому счёту Apiin выдаёт публичную ссылку с неугадываемым адресом. Клиент открывает её без регистрации: видит реквизиты (копируются по клику), скачивает PDF и платит сканом платёжного QR по ГОСТ Р 56042-2014 в банковском приложении по СБП — сумма и назначение подставляются автоматически.

Эту ссылку встраивайте в свой интерфейс: показывайте после оформления заказа, отправляйте письмом или в мессенджере. Отдельная встроенная оплата картой не требуется — счёт оплачивается по QR и банковским реквизитам.

Синхронизация статусов вебхуками

Чтобы ваш сайт знал об оплате, подпишитесь на вебхуки. Apiin присылает события создания документа, смены статуса оплаты (частичная и полная) и подписи акта; тело подписано по HMAC. Получив «оплачен», ваш сервис открывает доступ к товару или услуге автоматически.

Это заменяет ручную сверку: статусы в вашей системе и в Apiin остаются согласованными без опроса API в цикле.

Частые вопросы

Нужен ли эквайринг, чтобы принимать оплату?

Нет. Клиент платит сканом платёжного QR по СБП или по банковским реквизитам со страницы счёта. Встроенная оплата картой не требуется.

Как мой сайт узнает, что счёт оплачен?

Через вебхук о смене статуса оплаты. Apiin присылает событие с HMAC-подписью, и ваш сервис реагирует на него автоматически.

Можно ли не запрашивать реквизиты у клиента?

Да. Реквизиты подставляются по ИНН и БИК автозаполнением, достаточно ИНН покупателя. Это упрощает форму на вашем сайте.

Как показать счёт клиенту без регистрации?

Отдайте публичную ссылку на счёт — она открывается без входа, содержит QR, реквизиты и PDF. Ссылку возвращает API при создании документа.