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

Обновления API

1.77.3

07.08.25

1.65.1

18.04.25

  • Добавили в методы Create Payment Operation и Create Payment Operation With Receipt параметр ttl, который позволяет задавать срок действия платёжной ссылки в минутах, и объект Supplier, в котором можно передавать данные поставщика.
  • Реализовали возможность создавать подписки без графика списания и с изменением суммы платежа. Для создания такой подписки в методах Create Subscription и Create Subscription With Receipt нужно указывать boolean параметр recurring со значением true, а для списания денег — вызывать метод Charge Subscription.
  • В методы Get Payment Operation Info и Get Payment Operation List добавили параметр paidAt, который показывает время оплаты платёжной ссылки, и объект Order, содержащий информацию обо всех совершённых платежах и возвратах по платёжной ссылке.

1.63.1

31.03.25

1.59.1

11.02.25

1.58.0

03.02.25

  • Добавили в вебхук incomingSbpPayment параметр refTransactionId, с помощью которого вы можете проводить возвраты по СБП.

1.56.0

23.12.24

  • Добавили в методы Create Payment Operation и Create Payment Operation With Receipt возможность принимать платежи через T-Pay. Для этого у торговой точки в интернет-банке нужно выбрать Т-Pay как способ для приёма платежей, а в методах API использовать параметр paymentMode: tinkoff.
  • Обогатили данными метод Get Retailers: теперь он отдаёт информацию о возможных способах оплаты и наличии онлайн-касс.

1.55.0

06.12.24

  • Добавили новые методы для работы с подписками в интернет-эквайринге. С их помощью вы сможете создавать подписки (рекуррентные платежи) на определённый период, чтобы в течение этого периода у вашего покупателя списывались деньги с банковской карты.
  • Добавили необязательное поле merchantId в метод Create Payment Operation. Это поле необходимо заполнять, если у вас есть несколько торговых точек в интернет-эквайринге. Оно позволяет нам понять, по какой торговой точке будут происходить зачисления на ваш счёт.
  • Исправили задержки при отправке вебхуков, теперь они работают еще быстрее.
  • Добавили новые методы в песочницу и коллекцию запросов Postman.
  • Создали метод Get Payment For Sign List, который позволяет просматривать все платежи из раздела «На подпись» интернет-банка.
  • Обновили дизайн раздела «Интеграции и API» в интернет-банке.
  • По каждому обновлению добавили информацию в документацию, чтобы вам было легче разобраться с нашим API.

1.46.0

30.05.24

  • Добавили методы по работе с кассовыми QR-кодами.
  • Обновили методы по работе с платёжными ссылками, выставлением счетов и закрывающих документов в песочнице.
  • Добавили необязательный параметр email в метод Create Payment For Sign.

1.45.0

22.05.24

  • Добавили новый метод по работе с платёжными ссылками Create Payment Operation With Receipt. Он позволяет формировать ссылки на оплату с автоматической фискализацией чеков от партнёров Точки.

1.44.6

05.04.24

Создали четыре новых метода для работы с выставлением счетов и формированием закрывающих документов:

1.44.1

01.02.24

  • Добавили новый тип вебхука outgoingPayment для получения уведомлений об исходящих платежах.
  • Добавили новый параметр в методы Get Statements List и Get Statement, а также в вебхук типа incomingPayment. Это paymentId — уникальный идентификатор платежа.
  • Сделали обязательным поле purpose в методе Create Payment Operation.
  • Обновили в документации пример тела вебхука по событию incomingPayment.
  • Доработали методы для выставления счетов и формирования закрывающих документов. Поле totalNds больше не является обязательным.

1.43.3

08.12.23

  • Добавили методы для выставления счетов на оплату и создания закрывающих документов. Также с помощью API теперь можно получить PDF с выставленными счетами и закрывающими документами, а также посмотреть статус оплаты счетов.
  • Создали метод Get Authorized Card Transactions, который позволяет получать информацию о карточных операциях, находящихся в резерве.
  • Обновили разрешения для работы с вебхуками — теперь для создания, удаления или изменения вебхука нужно использовать разрешение ManageWebhookData. Существующие вебхуки продолжат свою работу, но для новых интеграций необходимо использовать новое разрешение.

1.42.5

20.11.23

  • Добавлена возможность работы с платёжными ссылками,
  • в методах Get Balance Info и Get Balances List появился новый тип баланса — OverdraftAvailable.
  • В методе Create Payment обновлён способ авторизации для проведения платежа.
  • Из документации и коллекции запросов в Postman удалены неактуальные методы.

1.38.5

07.07.2023

  • Добавили в метод Register Qr Code необязательный атрибут - redirectUrl.
    С помощью этого атрибута вы сможете перенаправить покупателя после оплаты по QR-коду на ваш сайт или приложение.

1.38.3

27.06.2023

  • Удалили из документации устаревшие методы для работы в СБП.

1.37.10

26.04.2023

После получения Точкой банковской лицензии мы изменили несколько методов:

  • В методе для получения информации о клиенте в СБП Get Customer Info теперь необходимо передавать bankCode — БИК банка.
  • В теле запроса метода для регистрации клиента в СБП Register Legal Entity теперь нужно будет передавать bankCode — БИК банка.
  • В методе для получения данных о QR-коде и ТСП по идентификатору QR-кода Get Qr Code Payment Data изменился эндпоинт запроса.
    Предыдущие методы объявлены deprecated и в ближайшее время перестанут работать.

1.37.9

13.04.2023

  • Обновили тело вебхука по событию icomingSbpPayment, чтобы подпись корректно валидировалась с нашим публичным ключом openAPI.
  • Удалили проверку длины названия юридического лица при запросе выписки.
  • Добавили ограничение на попытки отправлять вебхук и создали проверку доступности URL вебхука при его создании или обновлении: если на отправленный вебхук мы не получили ответ с кодом состояния HTTP 200, а получили любой другой код, то будем отправлять его повторно 30 раз с периодичностью в 10 секунд.
    Для проверки доступности указанного вами хоста при создании или изменении вебхука мы отправим на ваш URL по одному тестовому вебхуку на каждое из событий, на которые вы подписаны.
    Если в статусе ответа не придёт код HTTP 200, то вебхук не будет создан или изменён.
  • Добавили в песочницу все методы по работе в СБП, теперь вы сможете отладить работу с QR-кодами без регистрации QR-кодов на боевом слое.

1.37.0

01.02.2023

  • Добавили пример с телом вебхука по событиям icomingPayment и icomingSbpPayment.
  • Теперь при регистрации QR-кода на несуществующий merchantId мы отдаём ошибку 403 — forbidden by consent.
  • Добавили для работы с API БИК Точки.
  • Исправили ошибку в методах Get Balance Info и Get Balances List — мы отдавали accountId без значения БИК.
  • Поправили ошибку метода Start Refund, которая позволяла вернуть деньги по чужому QR-коду.

1.36.4

13.12.2022

  • Обновили в документации описание всех методов, чтобы вам было проще разобраться в нашем API.

1.36.0

20.10.2022

  • Вы просили, мы сделали: добавили JWT-токен для упрощённой авторизации. А ещё он избавляет от необходимости обновлять токены каждый день — просто подставьте сгенерированный ключ в заголовок -Authorization-.

1.34.0

18.07.2022

  • Добавили методы для работы с тендерными спецсчетами. Теперь вы сможете получать актуальный баланс спецсчёта и видеть, сколько денег и какими электронными торговыми площадками (ЭТП) заблокированы.

1.30.0

22.03.2022

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

1.29.0

24.02.2022

  • Появились методы на совершение возвратов сбп платежей и отслеживания их статуса. Подробнее.

1.28.0

01.12.2021

  • Теперь у нас есть вебхуки, подробнее можно прочитать здесь.

1.26.5

23.09.2021

  • В методе регистрации ТСП в СБП теперь необходимо передавать customerCode как параметр, а не как заголовок.
  • В методе регистрации юрлица в СБП изменился адрес и набор параметров.

1.25.0

23.07.2021

  • Теперь сформировать ссылку для подписания списка разрешений можно передав в нее id разрешения, без необходимости генерировать jwt объект.

1.24.1

16.06.2021

  • В выписке появился баланс счёта на начало и конец запрашиваемого периода. Теперь вы можете посмотреть полную выписку: с начальными и итоговыми остатками на счёте.
  • В методы работы со счетами добавили поле registrationDate с датой открытия счёта. Можно запросить выписку за весь период работы, отдельно вводить дату открытия счёта не нужно.

1.23.1

21.05.2021

  • Обновили метод работы с выписками. Теперь в поле amountNat лежит сумма транзакции в рублях, а в amount — в валюте счёта.
  • Для методов Create-payment и Payment-for-sign добавили валидацию полей. Проверяем все поля перед отправкой платежа в банк. Если будет какая-то ошибка, вы сразу сможете показать её тому, кто создаёт платёж.

1.21.5

12.04.2021

  • Добавлена валидация поля окончания срока действия разрешения expirationDateTime. Теперь нельзя указать дату меньше текущей.

1.20.0

25.02.2021

  • Добавили метод создания и подписания платежа. Теперь подписывать платежи можно через API, не заходя в интернет-банк.

1.19.0

10.02.2021

  • Добавили новый метод запроса статуса платежей для СБП, который работает быстрее.

1.13.0

10.11.2020

  • Добавили метод создания платежа на подпись. Теперь можно формировать платежи и отправлять их напрямую в интернет-банк. Подписать такие платежи пока можно только в интернет-банке.

1.11.0

08.10.2020

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