Skip to main content

Платежи

C помощью платёжных методов API вы можете:

  • выполнять массовые платежи по реквизитам своим контрагентам — юридическим и физическим лицам;
  • оплачивать налоги и иные платежи в бюджет;
  • совершать оплату на карту Тинькофф;
  • создать черновик платёжного поручения для выплат в бюджет и контрагентам.
Методы Tinkoff API для работы с платежами

Отправить платёж

Чтобы отправлять платежи:

  1. Убедитесь, что у пользователя есть доступы для совершения платежей.

  2. Выпустите токен с необходимыми разрешениями. Подробнее о выпуске токена.

    • Для метода Выполнить платёжСовершение платежей с рублевого расчётного счёта компании с ИНН {inn} и КПП {kpp}.


    • Для метода Выполнить платёж на карту ТинькоффСовершение платежей физическим лицам с рублёвого расчётного счёта компании с ИНН {inn} и КПП {kpp} на карту Тинькофф.


  3. Выпустите сертификат. Подробнее о выпуске сертификата.

Токен и сертификат привязываются после первого успешного запроса. Если вы хотите перевыпустить токен, вам также нужно перевыпустить сертификат.

  1. Чтобы обезопасить платежи, установите два вида лимитов:

    • Лимиты ЭЦП — распространяются на все платежи вне зависимости от интерфейса: веб, мобильное приложение, API. Можно настроить несколькими способами:

      • Пользователь с ролью «Генеральный директор» изменяет лимиты самостоятельно в личном кабинете Тинькофф Бизнеса в разделе Лимиты.
      • Через персонального менеджера.
    • Лимиты Tinkoff API — распространяются только на платежи через интерфейс Tinkoff API. Лимиты по умолчанию:

      • максимальная сумма одного платежа — 100 000 ₽;
      • максимальная сумма платежей в день — 100 000 ₽;
      • максимальная сумма платежей в месяц — 1 000 000 ₽;
      • максимальное количество платежей в день на одного контрагента — 3.

Чтобы повысить лимиты, отправьте письмо с вашей корпоративной почты на openapi@tinkoff.ru. В письме укажите новые значения и пользователей, для которых нужно повысить лимиты.

Платежи по реквизитам юридических и физических лиц и в бюджет

Используйте метод Выполнить платёж.

ID — уникальный идентификатор для всех платежей вашей компании, отправленных через Tinkoff API. Для каждого запроса используется свой ID. Если вы отправите несколько запросов с одним ID, создастся только один платёж.

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

"id": "123.pay",
"from": {
"accountNumber": "40703810987687654321"
},
"to": {
"name": "Иванов В.В.",
"inn": "0",
"bik": "044525974",
"bankName": "АО "ТИНЬКОФФ БАНК"",
"corrAccountNumber": "30101810145250000974",
"accountNumber": "40817810900987654321"
},
"purpose": "//ВЗС//500-00// Выплата заработной платы (30000 руб.) Иванову В.В. за июль 2022 года по ведомости от 30.06.20 №5. НДС не облагается",
"documentNumber": 100,
"executionOrder": 5,
"amount": 30000,
"dueDate": "2022-07-01T00:00+03:00",
"revenueTypeCode": "1",
"collectionAmount": 500,

Платёж на карту Тинькофф

Используйте метод Выполнить платёж на карту Тинькофф.

Уточните номер договора у получателя. Как посмотреть реквизиты и номер договора.

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

"id": "123.card",
"from": {
"accountNumber": "40703810987687654321"
},
"to": {
"agreementNumber": "7000368800"
},
"purpose": "Оплата по договору №123. НДС не облагается",
"amount": 10,
"dueDate": "2021-06-20T00:00:00Z"

Платёж считается отправленным, если в ответ на вызов метода вы получаете ответ 201 с указанием X-Request-Id в headers. Сохраните идентификатор — по нему банк сможет провести анализ, если у вас возникнут вопросы по отправке платежа.

Количество запросов в секунду (RPS (requests per second)) для метода — 10. Если вам нужно увеличить количество, напишите нам на openapi@tinkoff.ru.

Проверить статус отправленного платежа

Используйте метод Получить статус платежа, передав уникальный ID операции. При успешном запросе возвращается ответ 200.

"status": "EXECUTED"

Количество запросов в секунду (RPS (requests per second)) для метода — 20. Если вам нужно увеличить количество, напишите нам на openapi@tinkoff.ru.

Вы можете получать информацию о событиях через вебхуки без вызова метода — банк будет присылать данные при смене статуса платежа автоматически. Для этого сделайте публичную ручку.

"paymentId": "payment_id_123",
"status": "EXECUTED"

Публичная ручка должна быть без авторизации. Фильтровать события можно по IP-адресу, который мы вам сообщим. По всем вопросам обращайтесь на openapi@tinkoff.ru

Черновики платёжных поручений

Чтобы создавать черновики платёжных поручений, выпустите токен с разрешением Создание черновиков платежей в компании с ИНН {inn} и КПП {kpp} для метода Создать черновик платёжного поручения.


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

Создать черновик на оплату по реквизитам юридических и физических лиц и в бюджет

Используйте метод Создать черновик платёжного поручения.

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

"documentNumber": "654321",
"date": "2022-10-03T12:30+03:00[Europe/Moscow]",
"amount": 500,
"recipientName": "Петров Петр Петрович",
"inn": "987654321987",
"kpp": "0",
"bankAcnt": "4081781090098765432",
"bankBik": "044525974",
"accountNumber": "40703810987687654321",
"paymentPurpose": "Оплата товара #123. Без НДС",
"executionOrder": 5,
"taxPayerStatus": "0",
"kbk": "0",
"oktmo": "0",
"taxEvidence": "0",
"taxPeriod": "0",
"uin": "0",
"taxDocNumber": "0",
"taxDocDate": "0",
"recipientCorrAccountNumber": "30101810145250000974"

Черновик считается созданным, если в ответ на вызов метода возвращается ответ 200 с указанием X-request-id в headers. Сохраните идентификатор — по нему банк сможет провести анализ, если у вас возникнут вопросы по отправке черновика.

Количество запросов в секунду (RPS (requests per second)) для метода — 10. Если вам нужно увеличить количество, напишите нам на openapi@tinkoff.ru.

Подписать отправленный черновик

Только для Партнёрского сценария.

Перенаправьте пользователя по ссылке,

https://business.tinkoff.ru/sme/ruble/payment?id=<documentId>&returnApp=rko&returnPath=%2Fdashboard%3Foperations%3Ddrafts

где id=<documentId> — ID черновика.

После авторизации в личном кабинете откроется экран платежа с возможностью подтверждения.


Примеры ошибок при вызове методов

Посмотреть примеры часто встречающихся ошибок можно также в документации Tinkoff API.

400

401

403

Ошибки доступов (права пользователя, сертификаты, токены)

errorCode: FORBIDDEN




422

Ошибки, связанные с некорректными реквизитами






429

500


FAQ

openapi@tinkoff.ru

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

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