Как встроить выставление счетов на свой сайт или сервис
Apiin можно использовать как движок выставления счетов внутри вашего продукта: сайт или сервис создаёт счета через REST API, показывает клиенту публичную ссылку с QR, а статусы оплаты получает вебхуками.
Создание счетов через API
В момент оформления заказа ваш сервис отправляет в Apiin запрос на создание счёта: реквизиты продавца и покупателя, позиции, НДС-режим. В ответ приходит идентификатор документа и ссылки — на PDF и на публичную страницу счёта.
Реквизиты покупателя можно не запрашивать вручную: Apiin умеет автозаполнять их по ИНН и БИК. Автонумерация настраивается на уровне аккаунта, контрагента или заказа, поэтому номера остаются сквозными и корректными. Точные эндпоинты и поля — на /docs/api.
Публичная ссылка и оплата по QR
Каждому счёту Apiin выдаёт публичную ссылку с неугадываемым адресом. Клиент открывает её без регистрации: видит реквизиты (копируются по клику), скачивает PDF и платит сканом платёжного QR по ГОСТ Р 56042-2014 в банковском приложении — сумма и назначение подставляются автоматически.
Эту ссылку встраивайте в свой интерфейс: показывайте после оформления заказа, отправляйте письмом или в мессенджере. Счёт оплачивается по QR и банковским реквизитам, а при включённой онлайн-оплате через ЮKassa — ещё и картой или по СБП прямо со страницы.
Синхронизация статусов вебхуками
Чтобы ваш сайт знал об оплате, подпишитесь на вебхуки. Apiin присылает семь типов событий — от создания и отправки документа до смены статусов оплаты и подписи, генерации повторяющихся счетов и запросов доступа; тело подписано по HMAC. Получив «оплачен», ваш сервис открывает доступ к товару или услуге автоматически.
Это заменяет ручную сверку: статусы в вашей системе и в Apiin остаются согласованными без опроса API в цикле.
Частые вопросы
Нужен ли эквайринг, чтобы принимать оплату?
Нет. Клиент платит сканом платёжного платёжному QR или по банковским реквизитам со страницы счёта. При желании можно включить онлайн-оплату через ЮKassa — тогда на странице появится и оплата картой.
Как мой сайт узнает, что счёт оплачен?
Через вебхук о смене статуса оплаты. Apiin присылает событие с HMAC-подписью, и ваш сервис реагирует на него автоматически.
Можно ли не запрашивать реквизиты у клиента?
Да. Реквизиты подставляются по ИНН и БИК автозаполнением, достаточно ИНН покупателя. Это упрощает форму на вашем сайте.
Как показать счёт клиенту без регистрации?
Отдайте публичную ссылку на счёт — она открывается без входа, содержит QR, реквизиты и PDF. Ссылку возвращает API при создании документа.