Обновления API
1.77.3
07.08.25
- Добавили возможность создавать платёжные ссылки с двухэтапной оплатой — с помощью поля
preAuthorization
в методах Create Payment Operation и Create Payment Operation With Receipt. - В вебхуке с событием acquiringInternetPayment у поля
status
появилось значениеAUTHORIZED
. Событие с таким статусом приходит после заморозки денег на счёте плательщика при двухэтапной оплате.
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
- Добавили метод для создания B2B QR-кодов, с которыми у вас появляется возможность принимать платежи от своих контрагентов в любое время дня и ночи.
- Добавили метод для получения информации о созданных B2B QR-кодах.
- Создали новый тип вебхука incomingSbpB2BPayment, чтобы вы всегда были в курсе поступающих по B2B QR-кодам платежей.
- При создании счёт-фактуры добавили объект
shipmentDocuments
, который подтверждает отгрузку товаров, работ или услуг.
1.59.1
11.02.25
- Добавили параметры
nds_5
иnds_7
при выставлении счетов и закрывающих документов. - Обновили вебхук acquiringInternetPayment, теперь в нём содержится больше полезной информации.
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
Создали четыре новых метода для работы с выставлением счетов и формированием закрывающих документов:
- Delete Invoice — для удаления счёта.
- Send Invoice To Email — для отправки счёта в PDF на электронную почту.
- Delete Closing Documents — для удаления закрывающих документов.
- Send Closing Documents To Email — для отправки закрывающих документов на электронную почту.
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