Перейти к основному содержимому

Release Notes

Release Notes 2024

16 мая 2024

Самозанятые. Получить налоговый баланс самозанятого

GET /api/v1/self-employed/taxpayers/:inn/account-balance

  • Добавлен метод для получения налогового баланса самозанятого

Методы счетов

GET /api/v3/bank-accounts

  • Временно убрано поле transitAccount.balance

GET /api/v4/bank-accounts

  • Временно убрано поле transitAccount.balance

Checkout. Работа с заказом

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В поле order.orderItems[*] добавлено поле externalProductId.

POST /api/v2/checkout/order

  • В поле orderItems[*] добавлено поле externalProductId.
  • Для поля customerKey увеличена длина возможного значения до 128 символов.

CLFM. Партнёрские методы для работы с заявкой на выдачу кредита наличными

POST /api/clfm/create

  • Добавлен метод для создания новой заявки на получение кредита наличными

POST /api/clfm/demo

  • Добавлен метод для создания новой демо-заявки на получение кредита наличными

03 Апреля 2024

Самозанятые

POST /api/v1/self-employed/taxpayers/payment-documents-requests

  • Добавлен новый метод запроса платежных документов по самозанятым

GET /api/v1/self-employed/taxpayers/payment-documents-requests/{paymentDocumentsRequestId}

  • Добавлен новый метод получения результата запроса платежных документов по самозанятым

Checkout. Работа с заказом

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В поля paymentType и deliveryPayment[*].paymentType ответа добавлен элемент dolyame
  • В принимаемые значения поля deliveryKind добавлено значение merchant_delivery_point

POST /api/v2/checkout/order

  • В поле deliveryPayment[*].paymentType запроса добавлен элемент dolyame
  • Исправлена опечатка с лишней запятой в примере
  • Удалено поле failUrl в примере
  • Добавлено примечание Обязателен при работе со службами доставки. в описания полей: weight и declaredValue
  • Добавлено поле deliveryCondition.freeDelivery, которое содержит параметры бесплатной доставки
  • В принимаемые значения поля deliveryKind добавлено значение merchant_delivery_point
  • Добавлена информация о самовывозе из магазина в описании полей order.delivery.deliveryId, order.delivery.deliveryType и order.delivery.deliveryService.

01 Февраля 2024

Декларация 3-НДФЛ и Консультации

GET /api/private/ndfl3/requests/{taxRequestId}

  • Добавлен новый метод получения данных о заявке

GET /api/private/ndfl3/requests/{taxRequestId}/declaration/structure

  • Добавлен новый метод получения структуры анкеты

GET /api/private/ndfl3/requests/{taxRequestId}/declaration

  • Добавлен новый метод получения декларации клиента

PUT /api/private/ndfl3/requests/{taxRequestId}/declaration

  • Добавлен новый метод редактирования декларации клиента

GET /api/private/ndfl3/requests/{taxRequestId}/chat

  • Добавлен новый метод получения списка сообщений по декларации 3-ндфл

POST /api/private/ndfl3/requests/{taxRequestId}/chat/send

  • Добавлен новый метод отправки сообщения в чат с клиентом

Checkout. Работа с заказом

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В ответ для объекта Order добавлено опциональное поле paidAmount, содержащее сумму, которую уже оплатил плательщик.
  • В ответ для объекта Order добавлено опциональное поле paymentType, содержащее сумму, которую плательщик еще должен оплатить.

13 Января 2024

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/virtual-accounts/transfers

  • Добавлен новый метод для получения информации о переводах средств между виртуальными счетами бенефициаров

12 Января 2024

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/virtual-accounts/transfers/{transferId}

  • Добавлен новый метод для получения информации по переводу средств между виртуальными счетами бенефициаров
Release Notes 2023

26 Декабря 2023

Декларация 3-НДФЛ и Консультации

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/start-review

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "Preprocess"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/start-work

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "PartnerGeneratingReportData"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/resume-work

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "PartnerInProgress"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/ready

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "Ready"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/decline

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "Declined"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/cancel

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "Cancelled"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/acknowledge

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "Acknowledge"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/pending-payment

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "PendingPayment"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/payment-done

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "PaymentDone"

POST /api/private/ndfl3/requests/{taxRequestId}/declaration/workflow/clarification

  • Добавлен новый метод для перевода заявки типа "Декларация" в статус "Clarification"

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Добавлено опциональное поле isForceRedirect, содержащее флаг для принудительного редиректа на страницу успеха мерчанта после выполнения оплаты.
  • Вновь добавлено опциональное поле deliveryPayment, содержащее матрицу, для переопределения способов доставки и оплаты для заказа.

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В ответ для объекта Order добавлено опциональное поле isForceRedirect, содержащее значение флага для принудительного редиректа на страницу успеха мерчанта после выполнения оплаты.
  • В ответ для объекта Order вновь добавлено опциональное поле deliveryPayment, содержащее матрицу доступных способов доставки и способов оплаты для них.
  • В перечислении DeliveryKind элемент russian_post переименован в post_office.

12 Декабря 2023

Номинальные счета. Биллинг

POST /api/v1/nominal-accounts/virtual-accounts/transfers

  • Добавлен новый метод для перевода средств между виртуальными счетами бенефициаров

Безакцептные списания. Правила

Добавлена работа с новым типом правил - триггерные. Триггерные правила - это правила, срабатывающие при наступлении определённого события в системе (пополнение счёта наличными, оплата через торговый и интернет-эквайринг, входящий перевод от контрагента).

GET /api/v2/rules

  • Метод добавлен. Возвращает список подробной информации как о рекуррентных, так и триггерных правилах.

GET /api/v1/rules

  • Метод отмечен как устаревший. Вместо него теперь нужно использовать новый метод GET /api/v2/rules.

POST /api/v1/rules

  • Добавлена поддержка создания триггерных правил.

PUT /api/v1/rules/{ruleId}

  • Добавлена поддержка обновления данных триггерных правил.

GET /api/v1/rules/{ruleId}

  • Добавлена поддержка получения информации о триггерных правилах.

7 Декабря 2023

Счета и выписки

GET /api/v1/statement

  • Добавлена возможность получить балансы.
  • В ответе для операций добавлены поля bicSwift и bankName, содержащие информацию о SWIFT-коде и наименовании банка плательщика и получателя платежа.
  • В ответе для операций добавлено поле operationStatus, содержащее информацию о текущем статусе операции: авторизация или подтвержденная транзакция.

9 Ноября 2023

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Добавлено опциональное поле deliveryPayment, содержащее матрицу, для переопределения способов доставки и оплаты для заказа.

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В ответ для объекта Order добавлено опциональное поле deliveryPayment, содержащее матрицу доступных способов доставки и способов оплаты для них.
  • В ответ для объекта Order добавлено опциональное поле paymentType, содержащее использованный при оформлении заказа способ оплаты.

12 Октября 2023

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Поле amount сделано опциональным и помечено устаревшим;
  • Добавлено условно-обязательное поле itemsAmount.

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • Поле OrderV3.amount помечено устаревшим;
  • Добавлено обязательное поле OrderV3.itemsAmount.
  • В ответ для объекта Order.Delivery добавлено опциональное поле deliveryType, содержащее выбранный тип доставки.
  • В ответ для объекта Order.Delivery добавлено опциональное поле deliveryService, содержащее код выбранной службы доставки.

2 Октября 2023

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Поля ShippingParametersInV2.metashipShopId,ShippingParametersInV2.metashipWarehouseId и ShippingParametersInV2.types сделаны опциональными.

19 Сентября 2023

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Добавлено опциональное поле successPageUrl для передачи информации об адресе для редиректа на страницу успеха мерчанта.
  • Добавлено опциональное поле shoppingCartPageUrl для передачи информации об адресе для редиректа на страницу корзины мерчанта.

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В ответе для типа Order добавлено опциональное поле successPageUrl, содержащее информацию об адресе для редиректа на страницу успеха мерчанта.
  • В ответе для типа Order добавлено опциональное поле shoppingCartPageUrl, содержащее информацию об адресе для редиректа на страницу корзины мерчанта.

4 Сентября 2023

Самозанятые. Получить информацию о чеке

GET /api/v1/self-employed/taxpayers/:inn/receipts/:receiptId

  • В поле operations для операции со статусом FAILED поле errorMessage теперь опциональное.

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Добавлено опциональное поле discountInfo для передачи информации о суммарной скидке заказа.

GET /api/v2/checkout/order/{shopId}/by/{orderId}

  • В ответе для типа Order добавлено опциональное поле discountInfo, содержащее информацию о суммарной скидке заказа.

24 августа 2023

Номинальные счета. Бенефициары и реквизиты

POST /api/v1/nominal-accounts/beneficiaries

  • Для типа UL_NONRESIDENT убрали ограничение, что обязательны минимум 3 адреса
  • Для типов UL_RESIDENT и UL_NONRESIDENT теперь обязателен адрес LEGAL_ENTITY_ADDRESS
  • Обновили описание поля Addresses в запросе

PUT /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}

  • Для типа UL_NONRESIDENT убрали ограничение, что обязательны минимум 3 адреса
  • Для типов UL_RESIDENT и UL_NONRESIDENT теперь обязателен адрес LEGAL_ENTITY_ADDRESS
  • Обновили описание поля Addresses в запросе

8 августа 2023

Самозанятые

GET /api/v2/self-employed/taxpayers/{inn}/status

  • Добавлен новый метод для получения статуса самозанятого

Checkout. Работа с заказом

GET /api/v1/checkout/order/shopId/by/orderId

  • Запрос переведен в статус depricated.

GET /api/v2/checkout/order/shopId/by/orderId

  • Удалены поля: notificationUrl, successUrl, failUrl, iconUrl.
  • Исправлена опечатка: numenator=>numerator.
  • Добавлено поле со списком статусов заказа statuses.
  • Изменена обязательность полей в объекте 'user'.

Номинальные счета. Биллинг

POST /api/v1/nominal-accounts/payments

  • В ответе добавлено опциональное поле operationId с уникальным ID операции

GET /api/v1/nominal-accounts/payments

  • В ответе у платежей добавлено опциональное поле operationId с уникальным ID операции

GET /api/v1/nominal-accounts/payments/{paymentId}

  • В ответе добавлено опциональное поле operationId с уникальным ID операции

Checkout. Работа с заказом

POST /api/v2/checkout/order

  • Удалено поле: iconUrl, ошибочно перешло из версии v1.
  • Поле price стало необязательным, обязательность регулируется бизнес-правилами.

27 июля 2023

Checkout. Работа с заказом

POST /api/v1/checkout/order

  • Запрос переведен в статус depricated.

POST /api/v2/checkout/order

  • Удалены поля: notificationUrl, successUrl, failUrl, deliveryPointNumber, deliveryServiceCode.
  • Исправлена опечатка: numenator=>numerator.

24 июля 2023

Checkout. Работа с заказом

POST /api/v1/checkout/order

  • В запросе для типа OrderItem добавлены опциональное поле shippingParameters для описания параметров доставки.

21 июля 2023

Checkout. Работа с заказом

GET /api/v1/checkout/order/{shopId}/by/{orderId}

  • В ответе для типа Order добавлено опциональное поле recipient, содержащее информацию о получателе заказа.

17 июня 2023

Checkout. Работа с заказом

GET /api/v1/checkout/order/{shopId}/by/{orderId}

  • В ответе для типа OrderItem добавлены опциональные поля article, weight, declaredValue для описания параметров доставки.

POST /api/v1/checkout/order

  • В запросе для типа OrderItem добавлены опциональные поля article, weight, declaredValue для описания параметров доставки.

06 июля 2023

TCB Offline. Партнерские методы для работы с заявкой на покупку в кредит

POST /api/offline/partners/v1/create

  • Добавлен метод для создание новой заявки на покупку в кредит POST /api/offline/partners/v1/demo/create
  • Добавлен метод для создание новой демо-заявки на покупку в кредит GET /api/offline/partners/v1/orders/{orderNumber}/info
  • Добавлен метод для получение информации по заявке GET /api/offline/partners/v1/demo/orders/{orderNumber}/info
  • Добавлен метод для получение информации по демо-заявке POST /api/offline/partners/v1/orders/{orderNumber}/cancel
  • Добавлен метод для отмены заявки POST /api/offline/partners/v1/demo/orders/{orderNumber}/cancel
  • Добавлен метод для отмены демо-заявки POST /api/offline/partners/v1/orders/{orderNumber}/commit
  • Добавлен метод для сохранения номера чека под заявкой POST /api/offline/partners/v1/demo/orders/{orderNumber}/commit
  • Добавлен метод для сохранения номера чека под демо-заявкой

27 июня 2023

Tinkoff ID. Информация о пользователе

POST /api/v1/individual/detail-counters/{clientId}

  • Добавлен новый метод изменения текущего значения счетчика услуги партнера для клиента

Cards. Методы для получения данных по картам компании и установки по ним лимитов

PUT /api/v3/card/limits/set_batch

  • Добавлен метод для установки лимитов по списку карт

Счета и выписки

GET /api/v1/statement

  • В описание метода добавлена информация о формате для полей с датой и временем
  • Добавлены примеры заполнения параметров запроса

19 июня 2023

Счета и выписки

GET /api/v4/bank-accounts

  • В AccountInfo добавлены поля status, tariffName, tariffCode, createdOn, mainFlag balance.balance, balance.realOtb; Добавлена поддержка инвестиционных счетов

15 июня 2023

Tinkoff ID. Информация о пользователе

GET /api/v1/individual/detail-counters/{clientId}

  • Добавлен новый метод получения текущего значения счетчика услуги партнера для клиента

1 июня 2023

Cards. Методы для получения данных по картам компании и установки по ним лимитов

GET /api/v3/card/virtual/issue/application

  • Добавлен метод для пагинированного получения списка статусов заявок на выпуск виртуальных БК

Счета и выписки

GET /api/v1/statement

  • В запросе и ответе удалены устаревшие поля offsetOperationDate и lastOperationDate

Cпецпредложения и кэшбэк

GET /api/v1/loyalty/offers/active

  • Удалены из ответа метода неиспользуемые поля: merchantId, brandId, phone, clientRate, trancheDuration, quantityGraceStatement, trancheStatementCount

18 мая 2023

Tinkoff Business ID. Информация по компании

GET /api/v1/company

  • В ответе добавлено опциональное поле taxationScheme с системой налогообложения

15 мая 2023

Счета и выписки

GET /api/v1/statement

  • В ответе добавлено опциональное поле nextCursor с указателем на последнюю операцию в ответе
  • В запросе добавлено опциональное поле cursor с указателем на последнюю операцию из ответа на предыдущий запрос
  • В ответе добавлен атрибут required для обязательных полей

10 мая 2023

Проверка контрагентов

GET /api/v1/counterparty/excerpt

  • Добавлен метод - Получить общую выписку для проверки контрагента GET /api/v1/counterparty/express/excerpt
  • Добавлен метод - Получить краткую выписку для проверки контрагента GET /api/v1/counterparty/licenses
  • Добавлен метод - Получить список лицензий контрагента GET /api/v1/counterparty/history
  • Добавлен метод - Получить историю изменений GET /api/v1/counterparty/okved
  • Добавлен метод - Получить список ОКВЭДов контрагента GET /api/v1/counterparty/contracts
  • Добавлен метод - Получить список контрактов контрагента GET /api/v1/counterparty/related_companies
  • Добавлен метод - Получить общую информацию о связанных компаниях GET /api/v1/counterparty/related_companies_page
  • Добавлен метод - Получить список связанных компаний GET /api/v1/counterparty/traffic_light
  • Добавлен метод - Получить светофор факторов надёжности

4 мая 2023

Номинальные счета. Бенефициары и реквизиты

POST /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details

  • Добавлена возможность создавать реквизиты для переводов через СБП POST /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details/{bankDetailsId}
  • Добавлена возможность редактировать СБП реквизиты GET /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details/{bankDetailsId}
  • В ответе добавлен новый тип для СБП реквизитов GET /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details
  • В ответе добавлен новый тип для СБП реквизитов

Номинальные счета. Биллинг

POST /api/v1/nominal-accounts/payments

  • В ответе добавлен новый тип для СБП реквизитов GET /api/v1/nominal-accounts/payments
  • В ответе добавлен новый тип для СБП реквизитов GET /api/v1/nominal-accounts/payments/{paymentId}
  • В ответе добавлен новый тип для СБП реквизитов

Бизнес-карты. Получить данные по картам компании

GET /api/v3/card

  • Добавлена новая версия получания списка карт компании

2 мая 2023

Счета и выписки

GET /api/v1/statement

  • В ответе для операций добавлено опциональное поле vo с номером типа платежа
  • В ответе для операций добавлено опциональное поле docDate с датой документа

24 апреля 2023

Получить статус самозанятого

GET /api/v1/self-employed/taxpayers/{inn}/status

  • В поле info.permissions добавлено новое значение CANCEL_INCOME
  • В поле info.permissions обновлено значение: было - PERMISSION_MGMT, стало - PERMISSIONS_MGMT

13 апреля 2023

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

GET /api/v1/individual/blacklist/status

  • Добавлен метод получения статуса наличия в черных списках

Счета и выписки

GET /api/v1/statement

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/incoming-transactions

  • В ответе внутри каждой транзакции добавлено опциональное поле authorizationDate с датой авторизации
  • В ответе внутри каждой транзакции добавлено опциональное поле transactionDate с датой транзакции
  • В ответе внутри каждой транзакции добавлено опциональное поле drawDate с датой списания

03 апреля 2023

Checkout. Работа с заказом

GET /api/v1/checkout/order/{shopId}/by/{orderId}

  • Добавлены данные пользователя по квартире, подъезду, этажу и коду домофона в секцию доставки

30 марта 2023

Checkout. Работа с заказом

GET /api/v1/checkout/order/{shopId}/by/{orderId}

  • Поле taxation теперь может содержать значение self, если для заказа применяется схема налогооблажения на профессиональный доход POST /api/v1/checkout/order
  • Поле taxation теперь может содержать значение self, если для заказа применяется схема налогооблажения на профессиональный доход

23 марта 2023

Платежи

POST /api/v1/payment/status

  • Добавлен метод для получения статусов по списку платежных документов

Cпецпредложения и кэшбэк

POST /api/v1/loyalty/clients/cashback/history

  • Добавили в метод истории кэшбека поле с офферами, по которым ожидается начисление
  • Добавили новый код ошибки

Безакцептные списания. Соглашения

GET /api/v1/agreements/url

Безакцептные списания. Правила

GET /api/v1/rules

Платежные требования

GET /api/v1/requests

13 марта 2023

Информация о пользователе

GET /api/v1/individual/foreignagent/status

6 марта 2023

Checkout. Работа с заказом

POST /api/v1/checkout/order

  • Добавлена секция платежа за доставку в секцию доставки.
  • Исправлен код успешного ответа на Http 201(Created). GET /api/v1/checkout/order/{shopId}/by/{orderId}
  • Добавлена секция информации о платеже за доставку в секцию доставки.

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

POST /api/v1/invoice/send

  • Добавлено поле для указания номера телефона, на который будет отправлено SMS сообщение со счетом

27 февраля 2023

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

GET /api/v1/openapi/invoice/{invoiceId}/info

  • Добавлен метод для получения информации о выставленном счете

Cпецпредложения и кэшбэк

POST /api/v1/loyalty/receipt

  • Добавили в ответ метода информацию про офферы, ожидающиеся начисления кэшбека после дополнительных действий. GET /api/v1/loyalty/offers/active
  • Добавлены новые поля для офферов. Флаг отложенного начисления кэшбека и срок, в течение которого начисление ожидается.

9 февраля 2023

POST /api/v1/ndfl-3/requests/{taxRequestId}/info/document-data

2 февраля 2023

GET /api/v1/ndfl-3/requests/{taxRequestId}/info/form

  • Добавлен метод получения заполненной анкеты клиента, где указан желаемый состав декларации 3-ндфл GET /api/v1/ndfl-3/requests/{taxRequestId}/info/form/attachments/{attachmentId}
  • Добавлен метод получения вложений из заполненной анкеты клиента, в которой указан желаемый состав декларации 3-ндфл POST /api/v1/ndfl-3/requests/{taxRequestId}/info/document-data
  • Изменена структура ответа для типа "Ndfl2" метода Получить машиночитаемые данные документа
  • Удалена модель документа "LossState" метода Получить машиночитаемые данные документа Информация о пользователе GET /api/v1/individual/passport
  • Добавлен тип документа в ответе (idType).
  • Добавлен query-параметр idType для запроса документов только определенного типа.

30 января 2023

POST /api/v1/ndfl-3/requests/{taxRequestId}/info/document-data

19 января 2023

Самозанятые

POST /api/v1/self-employed/taxpayers/{inn}/receipts

  • status в ответе теперь возвращает IN_PROGRESS вместо NEW GET /api/v1/self-employed/taxpayers/{inn}/receipts/{receiptId}
  • В status добавили новые значения: IN_PROGRESS и DECLINED. Попутно удалили NEW - его заменяют новые значения
  • В operations чека добавили новый тип - REGISTRATION_OFFLINE. Используется для операций регистрации чека в оффлайн режиме (OFFLINE_MODE)

17 января 2023

Информация о пользователе

GET /api/v1/individual/addresses

  • Добавлен новый тип адреса в ответе: DELIVERY_ADDRESS.
  • Добавлен query-параметр addressType для запроса адресов определенного типа.

12 января 2023

Выплаты самозанятым

POST /api/v1/self-employed/recipients/list

  • Добавлены опциональные фильтры на инн, статус, дату создания и пейджинг

9 января 2023

Информация о пользователе

GET /api/v1/individual/pdl/status

  • Добавлен метод получения статуса публичного должностного лица
Release Notes 2022

15 декабря 2022

Методы оплаты и получения результатат оплаты реестров самозанятых

POST /api/v1/self-employed/payment-registry/pay

Декларации 3-НДФЛ

POST /api/v1/ndfl-3/requests/{taxRequestId}/tax-form/upload

28 ноября 2022

Информация о пользователе

POST /api/v1/individual/cobrand/{programId}

22 ноября 2022

Идентификация клиента

GET /api/v1/individual/identification/status

  • Скорректированы источники получения информации о идентификации клиента

10 ноября 2022

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

POST /api/v1/invoice/send

  • Добавлено опциональное поле comment в тело запроса
  • Добавлено поле invoiceId в тело ответа

24 октября 2022

Платежи. Выполнить платёж

POST /api/v1/payment/ruble-transfer/pay

  • Улучшены проверки для бюджетных платежей
  • Изменено описание поля tax в платежах

Номинальные счета. Бенефициары и реквизиты

POST /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/add-card-requests GET /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/add-card-requests/{addCardRequestId}

  • В ответе добавилось обязательное поле terminalKey

17 октября 2022

Номинальные счета. Бенефициары и реквизиты

POST /api/v1/nominal-accounts/beneficiaries

  • Изменилась валидация документов для Физ. лиц нерезидентов и ИП нерезидентов с гражданством BY: теперь требуется хотя бы 1 документ

6 октября 2022

Платежи

POST /api/v1/payment/ruble-transfer/pay POST /api/v1/payment/card-transfer/pay

  • Убрано требование обязательного указания информации по НДС в назначении платежей

Номинальные счета. Депоненты и реципиенты

POST /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients

  • В запрос добавилось поле tax GET /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients GET /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients/{recipientId}
  • В ответ запроса добавилось поле tax

1 сентября 2022

Самозанятые

POST /api/v1/self-employed/taxpayers/{inn}/bind

Номинальные счета. Бенефициары и реквизиты

POST /api/v1/nominal-accounts/beneficiaries PUT /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}

  • Поле birthPlace стало опциональным
  • Поле citizenship стало обязательным для Физ. лица резидента и ИП резидента
  • phoneNumber или email теперь обязателен к заполнению
  • kio обязателен к заполнению, если inn не задан (Юр. лицо нерезидент)
  • number, date стали обязательными для всех документов
  • Для типа PASSPORT теперь обязательно заполнение division
  • Добавились новые типы документов: CONTRACT, CONTRACT_GPD, PATENT. Если MIGRATION_CARD просрочена, обязательно заполнение одного из этих документов
  • organization стала обязательной для FOREIGN_PASSPORT, FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS, OFFICIAL_PASSPORT и DIPLOMATIC_PASSPORT
  • expireDate стала обязательной для MIGRATION_CARD, TEMPORARY_RESIDENCE_PERMIT, VISA и PATENT

25 августа 2022

Платежи. Выполнить платёж

POST /api/v1/payment/ruble-transfer/pay

  • Валидация параметра uin изменена на ^(0|[А-Яа-яA-Za-z0-9]{4}|[А-ЯA-Z0-9]{20}|[А-ЯA-Z0-9]{25})$

18 августа 2022

Бизнес-карты. Получить данные по картам компании

GET /api/v1/card

  • Добавлена валидация входного параметра accountNumber: ^(\d{20}|\d{22})$

10 августа 2022

Облачный колл-центр

POST /api/v1/cloudcc/applications/{applicationId}/contact

  • Удалён метод добавления контакта для звонка оператора

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/payments/{paymentId}

  • В ответе внутри bankDetails поле kpp сделано опциональным GET /api/v1/nominal-accounts/payments
  • В ответе внутри bankDetails поле kpp сделано опциональным

8 августа 2022

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/virtual-accounts/holds

  • В ответе внутри холда поле dealId сделано опциональным
  • В ответе внутри холда поле stepId сделано опциональным
  • В ответе внутри холда поле recipientId сделано опциональным
  • В ответе внутри холда поле paymentId сделано опциональным

4 августа 2022

Выплаты самозанятым

POST /api/v1/self-employed/recipients/list

  • Добавлено новое опциональное поле inn в тело ответа

25 июля 2022

Выплаты самозанятым

POST /api/v1/self-employed/payment-registry/create

  • Добавлено новое опциональное поле incomeType в тело запроса

Счета и выписки

GET /api/v1/account-operations

  • Добавлено новое опциональное поле acquirerId в тело ответа

21 июля 2022

Номинальные счета. Реквизиты бенефициаров

POST /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details

  • В запрос добавлено опциональное поле cardData. Теперь можно создавать реквизиты типа CARD

28 июня 2022

Удалены методы для реестровых выплат самозанятым:

  • POST /api/v1/self-employed/payment-registry/fiscalize
  • GET /api/v1/self-employed/payment-registry/fiscalize/result

23 июня 2022

Номинальные счета. Бенефициары и реквизиты

POST /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/add-card-requests

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/payments/{paymentId}

  • В ответе теперь могут возвращаться платежи с реквизитами типа CARD GET /api/v1/nominal-accounts/payments
  • В ответе теперь могут возвращаться платежи с реквизитами типа CARD

16 июня 2022

Счета и выписки

GET /api/v1/account-operations В ответе поля description, merch и его внутренние поля стали опциональными

21 апреля 2022

Информация о пользователе

Добавлены методы для получения информации о пользователе:

  • GET /api/v1/individual/subscription

7 апреля 2022

Cпецпредложения и кэшбэк

POST /api/v1/loyalty/offers/by-phone

  • Убрана заглушка при параметре test=false

Платежи

POST /api/v1/payment/ruble-transfer/pay

  • Добавлена возможность указывать 4 цифры в поле УИН

4 апреля 2022

Cпецпредложения и кэшбэк

POST /api/v1/loyalty/offers/by-phone

  • В ответе добавлено опциональное поле compactImage
  • В ответе поля image280, image626, image1252 теперь опциональны
  • В ответе удалено поле trancheDurationInMonths

Номинальные счета. Реквизиты бенефициаров

POST /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details

DELETE /api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details/{bankDetailsId}

Номинальные счета. Управление сделками

GET /api/v1/nominal-accounts/deals

DELETE /api/v1/nominal-accounts/deals/{dealId}

Номинальные счета. Управление этапами сделок

GET /api/v1/nominal-accounts/deals/{dealId}/steps

DELETE /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}

Номинальные счета. Депоненты и реципиенты

GET /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/deponents/{beneficiaryId}

DELETE /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/deponents/{beneficiaryId}
DELETE /api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients/{recipientId}

Номинальные счета. Биллинг

GET /api/v1/nominal-accounts/payments

25 марта 2022

Cпецпредложения и кэшбэк

POST /api/v1/loyalty/offers/by-phone

  • Убрана заглушка при вызове метода с параметром test=true

Платежи

POST /api/v1/payment/sbp/pay

  • Метод временно закрыт для интеграций

15 марта 2022

Счета и выписки

GET /api/v1/account-operations

  • В ответ добавлено поле authStatus

Бизнес-карты

POST /api/v1/card/{ucid}/block

Номинальные счета. Бенефициары, скоринг бенефициаров

POST /api/v1/nominal-accounts/beneficiaries

14 февраля 2022

Cпецпредложения и кэшбэк

POST /api/v1/loyalty/receipt

  • В информации о неуспешном начислении кэшбека обновлен список возможных ошибок

10 февраля 2022

Платежи

POST /api/v1/payment/ruble-transfer/pay

  • В Коде бюджетной классификации добавлена возможность указывать код 0

Счета и выписки

GET /api/v1/account-operations

  • Из ответа убрано поле date
  • В ответ добавлено поле accountNumber
  • В ответе все подполя поля поля card сделані опиональными
  • В ответе поле rrn сделано опциональным

3 февраля 2022

Документация

  • Обновлена инструкция по выпуску и отзыву токена в селф-сервисе

24 января 2022

Счета и выписки

GET /api/v1/account-operations

  • Добален метод для получения выписки с авторизациями

23 декабря 2021

Квалифицированная электронная подпись

POST tls/api/v1/qualified-digital-signature/issue

PUT /tls/api/v1/qualified-digital-signature/issue/{issueRequestId}/certificate-request

GET /tls/api/v1/qualified-digital-signature/issue/{issueRequestId}/status

GET /tls/api/v1/qualified-digital-signature/issue/{issueRequestId}/certificate

24 ноября 2021

Tinkoff ID. Информация о пользователе

GET /api/v1/individual/addresses

  • Убрали из ответа опциональное поле address

Документация

  • Добавили примеры ошибок с непустым полем errorDetails

9 ноября 2021

Платежи

POST /api/v1/payment/ruble-transfer/pay

  • В основании налогового платежа добавлена возможность указывать таможенные платежи

2 ноября 2021

28 октября 2021

Платежи

POST /api/v1/payment/create

  • В запрос добавилась возможность совершать налоговые платежи за третьих лиц. Для этого запрос должен содержать опциональное поле thirdParty

14 октября 2021

Партнерская доставка

PUT /api/v1/delivery/tasks/{id}

  • Добавлена возможность указывать статус проверки фото при обновлении задания

Платежи

POST /api/v1/payment/sbp/pay

  • Изменилась комиссия за платежи по СБП. Теперь при превышении бесплатного лимита она составляет 1% от суммы + 25 рублей

POST /api/v1/payment/payment-registry/pay

  • При оплате реестра не нужно указывать информацию о НДС

GET /api/v1/payment/{paymentId}

  • В ответе от метода добавлен комментарий платежам в статусе FAILED

4 октября 2021

Счета и выписки

GET /api/v3/bank-accounts

  • Добавлено отображение овернайт счетов

30 сентября 2021

Специальные счета

GET /api/v1/special-accounts/arrest-etp

  • В ответе от метода, в информации о блокировке теперь присутствует дата окончания блокировки

23 сентября 2021

Платежи

POST /api/v1/payment/ruble-transfer/pay

  • Добавлена возможность указывать Номер налогового документа в формате 2 буквы + 13 цифр

16 сентября 2021

Бизнес-карты

GET /api/v1/card/virtual/{ucid}/requisites

26 августа 2021

Платежи

POST /api/v1/payment/sbp/pay

5 августа 2021

E-invoicing

27 июля 2021

Торговый эквайринг

GET /api/v1/tacq/terminals

26 июля 2021

Платежи

POST /api/v1/payment/payment-registry/pay

15 июля 2021

Компании

GET /api/v1/company/signer/status

12 июля 2021

Облачный колл-центр

POST /api/v1/cloudcc/applications/{applicationId}/contact

  • Реализован метод добавления контакта для звонка оператора

8 июля 2021

Платежи

POST /api/v1/payment/card-transfer/pay

1 июля 2021

E-invoicing

POST /api/v1/e-invoice

GET /api/v1/e-invoice/{id}/status

POST /api/v1/e-invoice/{id}/confirm

POST /api/v1/e-invoice/{id}/cancel

24 июня 2021

Специальные счета

GET /api/v1/special-accounts/arrest-etp

3 июня 2021

Безопасная сделка

POST /api/v1/safe-deal/beneficiaries GET /api/v1/safe-deal/beneficiaries/result

27 мая 2021

Выплаты самозанятым

POST /api/v1/self-employed/payment-registry/create

  • Добавлено новое поле companyAccountNumber для указания номера счёта компании, с которого производится выплата

26 апреля 2021

Компании

GET /api/v1/company

22 апреля 2021

Платежи

POST /api/v1/payment/ruble-transfer/pay

  • Метод создания платежа поддерживает налоговые платежи и налоговые платежи за третьих лиц.

5 апреля 2021

Бизнес-карты

2 апреля 2021

Счета и выписки

GET /api/v1/bank-statement

  • В ответ метода добавлено новое поле operationId, которое содержит уникальный идентификатор операции

OpenApi

25 марта 2021

Сценарий Селф-Сервис

  • Перенесли возможность выпуска токена для сценария селф-сервис в раздел "Интеграции". (См. "Получение токена".)

18 марта 2021

OpenApi

  • Добавлена спецификация ошибки при большой нагрузке на сервис

Зарплатный проект

15 марта 2021

Счета и выписки

GET /api/v3/bank-accounts

  • Добавлен новый метод для получения расчетных счетов. Отличия от старого метода:
    • Добавлены спец.счета и счета бизнес-копилки GET /api/v2/bank-accounts
  • Метод теперь считается устаревшим

25 февраля 2021

SDK

  • Добавлены SDK для партнерской авторизации

19 февраля 2021

Выплаты самозанятым

POST /api/v1/self-employed/payment-registry/create

  • Добавлен флаг для автоматического удержания налога taxHolding POST /api/v1/self-employed/payment-registry/create
  • Добавлен выбор способа создания платежного реестра registryCreateType

Зарплатный проект

POST /api/v1/salary/payment-registry/create

  • Добавлен выбор способа создания платежного реестра registryCreateType

Платежи

POST /api/v1/salary/payment-registry/create

  • В запрос добавилось опциональное строковое поле revenueTypeCode. Оно может принимать значения "1", "2" или "3". Подробнее смотри тут.
  • В запрос добавилось опциональное числовое поле collectionAmount - yдержанная сумма в рублях. Актуально только при платежах в пользу физлиц.

8 февраля 2021

Платежи

POST /api/v1/payment/create

  • Изменён пример налогового платежа

28 января 2021

Платежи

POST /api/v1/payment/sbp/pay

  • Отчество получателя to.middleName, содержащееся в запросе, стало опциональным.

21 января 2021

Платежи

POST /api/v1/payment/create

  • В тело запроса добавлено необязательное поле: корреспондентский счет получателя recipientCorrAccountNumber (В связи с нововведением от 2021 года, данное поле будет обязательным для налоговых платежей)

Счета и выписки

GET /api/v2/bank-accounts

  • Исправлены неточности в документации

18 января 2021

Торговый эквайринг

GET /api/v1/tacq/operations/terminal/{terminalKey}

Платежи

POST /api/v1/payment/sbp/pay

12 января 2021

Выплаты самозанятым

GET /api/v1/self-employed/payment-registry/receipts/result

  • Добавлен идентификатор самозанятого в SelfEmployedReceipt.selfEmployedInfo

Спецификация OpenApi

Счета и выписки

GET /api/v1/bank-statement

  • Исправлено описание и добавлена валидация на поле operationType

10 декабря 2020

Информация о пользователе

8 декабря 2020

Выплаты самозанятым

GET /api/v1/self-employed/payment-registry/

  • Добавлены айди самозанятого в selfEmployedInfo

Зарплатный проект

GET /api/v1/salary/payment-registry/

  • Добавлены айди сотрудника в employeeInfo

Счета и выписки

GET /api/v2/bank-accounts

  • Добавлен новый метод для получения расчетных счетов. Отличия от старого метода:
    • Информация о транзитном счете возвращается вместе с основным счетом
    • Возвращается информация о наименовании и типе счета, бике банка получателя

3 декабря 2020

Партнерская доставка

Информация о пользователе

Добавлен метод для получения информации о статусе самозанятого:

  • GET /api/v1/individual/self-employed/status

26 ноября 2020

Спецификация OpenApi

  • Скорректирована спецификация ошибки 400: ошибка отдается в виде json
  • Исправлен формат вывода ошибок перечисления

16 ноября 2020

Бизнес-карты

GET /api/v1/card

  • Метод теперь доступен без сертификата mTLS
  • Убрали поле expiryDate из ответа метода

GET /api/v1/card/{ucid}

  • Метод теперь доступен без сертификата mTLS
  • Убрали поле expiryDate из ответа метода

Спецификация OpenApi

  • Обновлена спецификация ошибки 403: добавлена информация о причинах ошибки

9 ноября 2020

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

POST api/v1/invoice/send

  • В запрос добавлено опциональное поле accountNumber. Теперь отправитель счета может сам выбирать счет на который он хочет получить оплату.
  • Поля плательщика payer.inn, payer.name стали опциональными, как и само поле payer, чтобы пользователь мог выставлять счета физическим лицам не указывая лишних данных, если в них нет необходимости.
  • Добавлено новое опциональное поле kpp для плательщика. Пользователи по желанию смогут передать дополнительную информацию о плательщике в счет.

Информация о пользователе

  • Добавлено описание метода получения учётных данных

Партнерская доставка

Бизнес-карты

GET /api/v1/card

  • Добавлен новый метод для получения данных о картах компании
  • В запросе есть опциональный строковый параметр agreementNumber. Он передается, если нужен список с данными карт компании, привязанных к заданному расчетному счету.
  • В запросе есть опциональный числовой параметр offset - количество карт, которые необходимо пропустить. По умолчанию offset = 0.
  • В запросе есть опциональный числовой параметр limit - количество карт, которые необходимо вывести. По умолчанию limit = 1000. Значение для этого параметра не может быть больше 1000. GET /api/v1/card/{ucid}
  • Добавлен метод для получения данных об одной карте по UCID

2 ноября 2020

Спецификация OpenApi

GET /openapi/docs/openapi.yaml

  • Скорректирован формат загружаемого файла спецификации с .json на .yaml

Бизнес-карты

  • Изменено название раздела "Корпоративные карты" на "Бизнес-карты"

Платежи

POST /api/v1/payment/create

  • Добавлена валидация номера документа при создании платежей. Строковое поле должно содержать не более 6 цифр.

Информация о пользователе

Добавлены методы для получения информации о пользователе: GET /api/v1/individual/documents/passport GET /api/v1/individual/documents/driver-licenses GET /api/v1/individual/documents/inn GET /api/v1/individual/documents/snils GET /api/v1/individual/addresses GET /api/v1/individual/identification/status

Партнерская доставка

Добавлены методы, предоставлющие функционал доставки для партнеров GET /api/v1/delivery/tasks/{id} PUT /api/v1/delivery/tasks/{id} POST /api/v1/delivery/tasks POST /api/v1/delivery/tasks/{id}/cancel POST /api/v1/delivery/meetings POST /api/v1/delivery/intervals

Сертификаты

  • Указано правило транслитерации

13 октября 2020

Счета и выписки

GET /api/v1/bank-statement

  • Поправлена ошибка, возникающая у некоторых клиентов при запросе больших выписок.

5 октября 2020

Платежи

POST /api/v1/payment/create

  • Поле inn, содержащееся в запросе, теперь может иметь значение "0". Такое допустимо, если платеж выполняется в пользу физического лица и его ИНН неизвестен.
  • В документации обновлены описания полей inn и kpp, содержащиеся в запросах.

24 сентября 2020

Платежи

POST /api/v1/payment/ruble-transfer/pay

  • В документацию добавлено описание лимитов, установленных по умолчанию, на выполнение платежей:
    • максимальная сумма одного платежа - 100000 рублей
    • максимальная сумма платеже в день - 100000 рублей
    • максимальная сумма платежей в месяц - 1000000 рублей
    • максимальное количество платежей в день на одного контрагента - 3

Селф-сервис

  • Добавлена возможность выпускать токены с определенными скопами. Для подробностей смотри: Сценарий Селф-Сервис, Получение токена, n.6

Выплаты самозанятым

Добавлены методы для реестровых выплат самозанятым: POST /api/v1/self-employed/recipients/create GET /api/v1/self-employed/recipients/create/result POST /api/v1/self-employed/recipients/list POST /api/v1/self-employed/payment-registry/create GET /api/v1/self-employed/payment-registry/create/result GET /api/v1/self-employed/payment-registry/{paymentRegistryId} POST /api/v1/self-employed/payment-registry/submit GET /api/v1/self-employed/payment-registry/submit/result POST /api/v1/self-employed/payment-registry/fiscalize GET /api/v1/self-employed/payment-registry/fiscalize/result POST /api/v1/self-employed/payment-registry/receipts GET /api/v1/self-employed/payment-registry/receipts/result

14 сентября 2020

Счета и выписки

GET /api/v1/bank-statement

  • Поле recipientInn, содержащееся в ответе, стало опциональным. Оно может отсутствовать, например, в случае, если идет расчет с контрагентами, так как данное поле не является обязательным для совершения перевода.
  • Поле payerAccount, содержащееся в ответе, стало опциональным. Оно может отсутствовать, например, в случае, если, плательщиком является кредитная организация или филиал кредитной организации.

Платежи

POST /api/v1/payment/create

  • В запрос добавилось опциональное строковое поле revenueTypeCode. Оно может принимать значения "1", "2" или "3". Подробнее смотри тут.
  • В запрос добавилось опциональное числовое поле collectionAmount - yдержанная сумма в рублях. Актуально только при платежах в пользу физлиц.

Cертификаты

  • Выпущенные с данного момента сертификаты предоставляются в формате pem, что избавляет их владельцев от необходимости конвертации сертификатов перед использованием.

openapi@tinkoff.ru

APIСценарииПодключение

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