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

Обновления API

26.09.2025​

  • Добавили возможность оплатить заказ частями через сервис «Долями» при переходе по платёжной ссылке. Для этого при создании платёжной ссылки методом Create Payment Operation или Create Payment Operation With Receipt в массиве Data.Operation[].paymentMode[] укажите значение dolyame.
    Как и при других оплатах, при платеже Долями мы отправим вебхук acquiringInternetPayment. Узнать, какие в нём будут данные, можно в описании вебхука.

  • При создании платёжной ссылки или подписки можно указать идентификатор заказа — в необязательном поле Data.paymentLinkId. Значение должно быть уникальным. Если не передать его, интернет-эквайринг автоматически заполнит это поле порядковым номером. Актуально для методов:

17.09.2025​

  • В методах Create Payment Operation With Receipt и Create Subscription With Receipt теперь можно указать поставщика для каждого товара — в объекте Items.Supplier.
    Возможность добавить поставщика в отдельном объекте Supplier остаётся. Если использовать оба варианта одновременно, приоритет будет у Items.Supplier, а поставщик из отдельного объекта Supplier будет указан в чеке для товаров, у которых нет Items.Supplier.
    Подробнее читайте в описании методов создания платёжной ссылки и создания подписки с фискализацией чеков.

  • Добавлен метод Get Payment Registry. С помощью него можно получить реестр платежей, выполненных через интернет-эквайринг. Узнать подробнее можно в описании метода.

07.08.2025​

18.04.2025​

  • Добавили в методы 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, содержащий информацию обо всех совершённых платежах и возвратах по платёжной ссылке.

31.03.2025​

11.02.2025​

03.02.2025​

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

23.12.2024​

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

06.12.2024​

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

30.05.2024​

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

22.05.2024​

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

05.04.2024​

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

01.02.2024​

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

08.12.2023​

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

20.11.2023​

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

07.07.2023​

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

27.06.2023​

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

26.04.2023​

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

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

13.04.2023​

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

01.02.2023​

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

13.12.2022​

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

20.10.2022​

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

18.07.2022​

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

22.03.2022​

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

24.02.2022​

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

01.12.2021​

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

23.09.2021​

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

23.07.2021​

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

16.06.2021​

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

21.05.2021​

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

12.04.2021​

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

25.02.2021​

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

10.02.2021​

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

10.11.2020​

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

08.10.2020​

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