Robokassa Invoice: как выставить счет и ссылку на оплату

Table of contents

• Когда выгодно использовать инвойсы
• Создание счета в личном кабинете: пошагово
• Ссылка на оплату: формат и отправка клиенту
• Параметры инвойса: описание, суммы, налоги
• Статусы инвойсов и уведомления
• Инвойсы через API: общий подход
• Фискализация и печать чеков
• Работа с возвратами и аннулированием
• Рекомендации по конверсии и безопасности
• Чек‑лист перед отправкой счета

Когда выгодно использовать инвойсы

Инвойсы полезны, когда нет сайта или корзины, нужно быстро принять оплату за услугу, предоплату, счет с переменной суммой или оплату B2B. Счет формирует удобную ссылку, которую легко отправить в мессенджер или по email.

Создание счета в личном кабинете: пошагово

1. Зайдите в Личный кабинет продавца и откройте раздел Счета или Платежи по ссылке.
2. Заполните поля: сумма, описание товара или услуги, идентификатор заказа, валюта.
3. Настройте срок действия ссылки: например, 24–72 часа для контроля дебиторки.
4. Выберите методы оплаты, доступные покупателю: карты, СБП, кошельки.
5. Включите уведомления клиенту: email, SMS или мессенджер.
6. Сохраните инвойс и получите короткую ссылку.

![Пример формы создания инвойса]

Советы:

• В описании укажите назначение платежа и контакт поддержки.
• Если предполагается частичная оплата, проверьте соответствующую настройку.
• Используйте переменные в шаблоне, чтобы ускорить массовую рассылку счетов.

Ссылка на оплату: формат и отправка клиенту

Ссылка обычно выглядит как короткий URL провайдера с параметрами заказа. Не вставляйте секретные ключи и подписи в открытый вид. Отправляйте ссылку безопасными каналами, избегайте публикации в открытых чатах.

Каналы доставки:

• Письмо на почту с понятной темой и суммой.
• SMS с короткой ссылкой и сроком действия.
• Сообщение в мессенджере с кнопкой Оплатить.

Параметры инвойса: описание, суммы, налоги

Минимальный набор полей:

• amount — сумма в валюте счета.
• description — назначение платежа.
• invoice_id — уникальный номер инвойса. Дополнительно: email/телефон плательщика, статья НДС, список позиций для фискализации.

Рекомендации по НДС и фискализации:

• При изъятии товара и оплате услуг соблюдайте кассовую дисциплину.
• Заполняйте позиции, ставки НДС и признак способа расчета, если вы обязаны печатать чек.

Статусы инвойсов и уведомления

Типичный жизненный цикл: создан, отправлен, оплачен, отменен, истек срок действия. При смене статуса включайте уведомления себе и клиенту. В кабинете доступен поиск по номеру счета и фильтр по статусам.

Инвойсы через API: общий подход

1. Сгенерируйте ключи и подписи в кабинете.
2. Создайте серверный метод для формирования инвойса, сохраняйте его ID и срок.
3. Отправьте ссылку клиенту, запишите канал отправки.
4. Обработайте уведомление об оплате через вебхук и обновите статус заказа.

Минимально безопасные практики:

• Подписывайте параметры SHA‑256 и сверяйте подписи во входящих уведомлениях.
• Не передавайте секреты в фронтенд или лог-файлы.
• Ограничьте IP‑адреса, откуда принимаете вебхуки.

Фискализация и печать чеков

Если у вас подключена онлайн‑касса, формируйте чеки при оплате инвойса. Следите за корректностью тегов, КМ, ставкой НДС, признаком предмета расчета. Ошибки фискализации могут снизить конверсию и задержать зачисление.

Работа с возвратами и аннулированием

Если счет оплачен, используйте возврат: полный или частичный. При ошибке в сумме до оплаты — аннулируйте счет и выставьте новый. Подробно про возвраты читайте в разделе Возвраты.

Рекомендации по конверсии и безопасности

• В шаблон письма добавьте логотип, сумму и срок оплаты крупным шрифтом.
• Для СБП давайте короткую инструкцию, как открыть приложение банка.
• Поддерживайте несколько методов оплаты — это повышает конверсию на 5–10%.
• Используйте антифрод‑правила и лимиты по суммам.

Чек‑лист перед отправкой счета

• Проверили сумму, валюту и описание заказа.
• Задали срок действия и способы оплаты.
• Добавили контакты поддержки.
• Включили уведомления и подтвердили фискализацию.
• Протестировали ссылку в режиме Sandbox.

Готово: вы можете массово отправлять счета и контролировать оплату прямо из кабинета или через интеграцию API.