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

Обновления API

12.10.2026​

Теперь интеграцию с API можно писать вместе с ИИ-агентом. Агент сам подбирает методы и разрешения, проверяет окружение и разбирает ошибки — по готовым инструкциям, которые мы для него подготовили. Такие инструкции называются скиллами.

Что умеет агент со скиллами:

  • подбирать методы и разрешения под вашу задачу до выпуска ключа — чтобы не столкнуться с ошибкой 403
  • проверять окружение: сертификаты Минцифры, доступность API, песочницу
  • вести по сценариям: платёжные ссылки, подписки, QR-коды, выписки, платёжные поручения, счета на оплату
  • проверять подпись вебхуков и находить причину ошибок

Скиллы подходят для агентов с поддержкой формата Agent Skills — например, Claude Code, Cursor и Codex. Скачать их и узнать, как подключить, можно в разделе «Скиллы для ИИ-агентов».

Если вы работаете с обычной языковой моделью — ChatGPT, Claude, GigaChat, — для неё появились готовые промты. Скопируйте промт, подставьте свои данные, и модель с загруженной документацией:

  • подберёт методы и разрешения под задачу
  • соберёт запрос и проверит уже написанный
  • найдёт причину ошибки по ответу API
  • напишет обработчик вебхука с проверкой подписи

Все промты собраны в разделе «Коллекция промтов». Базовый промт из раздела «Документация для LLM» теперь тоже там.

25.09.2026​

Теперь документацию Точка Банка можно загрузить в языковую модель — ChatGPT, Claude, GigaChat или другую — и задавать вопросы по API обычными словами. Модель подскажет, какой метод вызвать и какие поля передать, опираясь на документацию, а не на догадки.

Для этого мы подготовили два файла:

  • llms.txt — краткий обзор API со ссылками на разделы, для моделей с доступом в интернет
  • llms-full.txt — вся документация одним текстом, чтобы загрузить её в модель как вложение

Как подключить документацию к модели — в разделе Документация для LLM.

При работе с полным файлом llms-full.txt дополнительно загрузите в модель swagger.json — так у неё будут и логика сценариев, и точные поля методов.

21.09.2026​

Теперь к API можно подключить AI-агента через MCP (Model Context Protocol) и управлять банком обычными словами — агент сам вызывает нужные методы.

Что умеет агент:

  • запрашивать список компаний и счетов
  • показывать баланс по счёту
  • формировать и получать выписку
  • создавать платёж на подпись

Для подключения выпустите JWT-ключ для работы с MCP в интернет-банке и передайте его агенту. Как это настроить и какие тулы доступны — в разделе Работа с AI-агентами и Точка.API.

Для каждой компании или ИП нужен свой токен. Платёж, созданный агентом, не исполняется без вашей подписи в интернет-банке.

14.09.2026​

Платёжные ссылки и вебхук acquiringInternetPayment теперь поддерживают оплату цифровым рублём.

Для того, чтобы оплатить цифровым рублём - отдельно ничего настраивать не нужно, оплата приходит вместе с СБП. Отличить способ оплаты можно по полю paymentType в вебхуке:

  • sbp — оплата по СБП
  • digitalRuble — оплата цифровым рублём

09.09.2026​

В вебхук по событию incomingSbpPayment добавили поддержку оплаты цифровым рублём. Теперь событие приходит не только при оплате по СБП, но и при оплате цифровым рублём. Различить способ оплаты можно по новому полю paymentType:

  • sbpPayment — оплата по СБП
  • drPayment — оплата цифровым рублём

При оплате цифровым рублём в вебхуке приходят сумма, наименование и идентификатор ТСП, идентификатор QR-кода, данные покупателя и идентификатор клиента на Платформе цифрового рубля.

09.09.2026​

В Точке появилась возможность принимать оплату по СБП цифровым рублём. Со стороны API ничего менять не нужно — оплата принимается тем же способом, что и обычная оплата по СБП. В разделе Система быстрых платежей добавили, как работать с цифровым рублём:

  • как проверить, подключён ли у клиента цифровой рубль — через объект digitalRubleWallet в ответе метода Get Customer Info
  • как определить, что оплата прошла цифровым рублём — по длине идентификатора trxId
  • где оформить возврат по цифровому рублю

Возврат платежа, поступившего цифровым рублём, оформляется только в личном кабинете интернет-банка Точка Банка.

06.07.2026​

В вебхук по событию acquiringInternetPayment при оплате картой добавили три новых поля:

  • maskedPan — маскированный номер карты
  • cardType — платёжная система
  • tokenCardId — токен карты покупателя

С их помощью вы сможете понимать, какой картой прошла оплата, вести аналитику по платёжным системам и отличать карты по токену.

Новые поля приходят при работе с подписками без графика списания.

27.03.2026​

В вебхуке acquiringInternetPayment появилось поле paymentLinkId — номер заказа, который вы передаёте при создании платёжной ссылки или подписки.

Пожалуйста, помните, что при каждом создании платёжной ссылки или подписки в поле paymentLinkId нужно указывать уникальное значение.

04.03.2026​

С помощью метода Create Closing Document теперь можно создать новый вид закрывающих документов — универсальный передаточный документ (УПД):

  • УПД СЧФДОП — такой УПД заменяет комплект «счёт-фактура + акт или накладная»
  • УПД ДОП — его можно использовать вместо накладной или акта выполненных работ

05.02.2026​

  • В ответе метода Create Payment For Sign появилось поле Data.redirectUrl. Оно содержит ссылку, по которой можно перейти в интернет-банк к созданной платёжке — как это было у метода Create Payment.

  • Метод Create Payment больше неактуален и перестанет работать с 27 февраля.

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, необязательно заходить в интернет-банк.