Skip to main content

Выставление счетов

Сценарий подойдёт для компаний, которые хотят получать оплату от ИП и юридических лиц.

C помощью методов API для выставления счетов вы можете:

  • Создавать счета на оплату в формате PDF и отправлять их контрагенту для оплаты. При оплате контрагенту не нужно вводить реквизиты вручную — можно просто отсканировать QR-код на счёте через камеру в приложении банка.
  • Отслеживать статус оплаты счетов.
  • Создавать счета-договора — нужные условия прописываются в поле Комментарий.
Методы в документации

Принцип работы

  1. Контрагент хочет купить товар.
  2. Компания отправляет запрос на выставление счёта в Tinkoff API и получает ссылку, которую отправляет клиенту. Если в запросе вы указали номер телефона или почту, ссылка отправляется клиенту по СМС или почте автоматически.

Следующие шаги зависят от типа контрагента:

  1. Тинькофф подгружает контрагенту счёт на оплату в личном кабинете Тинькофф Бизнеса в разделе Выставление счёта, если компания указала ИНН в счёте.
  2. Контрагент заходит на вкладку Входящие, выбирает нужный счёт и нажимает Оплатить.
  3. Тинькофф сверяет счёт с платёжкой и отмечает его как оплаченный. Сверка происходит по ID платежа.
  4. Компания получает статус счёта через метод Получить информацию о выставленном счёте и помечает в своей системе, что услуга или товар оплачены.

Также контрагент может отсканировать QR-код в приложении и оплатить cчёт по нему.

После этого компания идёт дальше по своему бизнес-процессу.

Интеграция

Чтобы выставлять счета и получать их статусы, выпустите токен с разрешениями:

  • Партнёрская интеграция — opensme/inn/[{inn}]/kpp/[{kpp}]/invoice/submit.
  • Прямая интеграция — Создание, отправка счёта на оплату и получение его информации в компании с ИНН {inn} и КПП {kpp}.

Подробнее о выпуске токена

Для выставления счетов используйте метод Выставить счёт. Ограничение на использование метода — 4 запроса в секунду.

Для проверки статуса выставленного счёта используйте метод Получить информацию о выставленном счёте. Ограничение на использование метода — 20 запросов в секунду.

Примеры запросов


openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.