Новые методы!

Прислушиваемся к вашей обратной связи и работаем над новыми методами. Вот те, что помогут работать со счетами и закрывающими документами:

1⃣ Send Invoice To Email — метод для отправки счёта на электронную почту;

2⃣ Delete Invoice — метод для удаления ранее выставленного счёта;

3⃣ Send Closing Documents To Email — метод для отправки закрывающего документа на электронную почту;

4⃣ Delete Closing Documents — метод для удаления ранее выставленного закрывающего документа.

Делитесь в комментариях, чего не хватает ещё 👇🏻

Новые методы работы с интернет-эквайрингом!

В открытом API можно формировать платёжные ссылки для оплаты по карте или СБП и фискализировать чеки от нашего партнёра.

Перед работой с API платёжных ссылок нужно отправить заявку в интернет-банке на подключение интернет-эквайринга и выбрать партнёра, который будет фискализировать чеки по 54-ФЗ.

Сделать это может руководитель или распорядитель с правом подписи в разделе «Сервисы» → «Интернет-эквайринг»

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

Также, у нас появились новые необязательные параметры при создании платёжной ссылки:

🔘failRedirectUrl — URI-адрес, на который нужно переправить покупателя если оплата не прошла;

🔘saveCard — параметр, указывающий, будет ли покупателю предложено сохранить карту для следующих платежей;

🔘consumerId — идентификатор покупателя. Если ранее был указан параметр saveCard и клиент согласился с сохранением карты, то из ответа можно взять consumerId и подставить в запрос, чтобы покупатель мог выбрать карту, по которой уже происходила оплата.

Кассовый QR-код — подтип статического QR-кода, имеющий признаки динамического QR-кода.

При создании кассовой ссылки создаётся идентификатор QR-кода, по которому можно проводить неограниченное количество оплат. После каждой оплаты необходимо активировать ссылку заново.

Чтобы зарегистрировать кассовую ссылку необходимо вызвать метод Register Cashbox Qrcode. Чтобы принимать оплату по QR-коду, его нужно каждый раз активировать с помощью метода: Activate Cashbox Qrcode.

Если покупатель передумал совершать оплату или больше нет необходимости в активном QR-коде, можно вручную вызвать метод на деактивацию QR-кода: Deactivate Cashbox Qrcode

При работе с кассовыми QR-кодами есть возможность изменить расчётный счёт для зачисления денег — но в рамках одной компании. Изменить расчётный счёт одной компании на счёт другой не получится. Для изменения счёта необходимо вызвать метод Change Cashbox Qrcode Account

Чтобы посмотреть информацию обо всех выпущенных кассовых QR-кодах, вызовите метод Get Cashbox Qrcode List. Чтобы посмотреть информацию по конкретному кассовому QR-коду, вызовите метод Get Cashbox Qrcode.

Вместе с кассовыми ссылками мы сделали следующее:

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

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

2⃣ Добавили необязательное поле merchantId в метод Create Payment Operation. Это поле необходимо заполнять, если у вас есть несколько торговых точек в интернет-эквайринге. Оно позволяет нам понять, по какой торговой точке будут происходить зачисления на ваш счёт.

3⃣ Исправили задержки при отправке вебхуков, теперь они работают еще быстрее.

4⃣ Добавили новые методы в песочницу и коллекцию запросов Postman.

5⃣ Создали метод Get Payment For Sign List, который позволяет просматривать все платежи из раздела «На подпись» интернет-банка.

6⃣ Убрали обязательность параметра paymentNumber в методах Create Payment For Sign и Create Payment. Если не передавать номер платёжки — она проставится автоматически.

7⃣ Обновили дизайн раздела «Интеграции и API» в интернет-банке.

8⃣ По каждому обновлению добавили информацию в документацию, чтобы вам было легче разобраться с нашим API.

Так торопились к вам с новогодним релизом, что успели сильно заранее 🎄

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

🔘Обогатили данными метод Get Retailers: теперь он отдаёт информацию о возможных способах оплаты и наличии онлайн-касс.

🔘Исправили баг, из-за которого в выписке терялась часть данных.

Всё уже работает, дожидаться боя курантов ни к чему. Желаем отличных праздников, ждём встречи в новом году!

Добавили в вебхук acquiringInternetPayment новые параметры:

🔘 merchantId — идентификатор торговой точки в интернет-эквайринге. Теперь вы наверняка сможете понять, по какой торговой точке произошла оплата.
🔘 operationId — идентификатор платежа. Раньше этот параметр возвращался только при оплате по карте, а сейчас он будет приходить и при оплате через СБП. С помощью operationId вы сможете проводить возвраты платежей.

В методы по работе со счетами и закрывающими документами добавили новые ставки НДС — 5% и 7%.

🔘Добавляйте информацию о поставщике, чтобы больше не вносить исправления в фискальные чеки. Для указания данных поставщика в методах Create Payment Operation With Receipt и Create Subscription With Receipt нужно заполнить объект Supplier.

🔘Теперь вы можете задавать свой срок действия платёжной ссылки. Для этого в методах Create Payment Operation и Create Payment Operation With Receipt нужно передать параметр ttl. Сразу подскажем, что указать можно от 1 до 44 640 минут. Если при создании ссылки не передать этот параметр, срок её действия составит 10 080 минут.

🔘Поддержали создание рекуррентных платежей без графика. Для создания такой подписки в методах Create Subscription и Create Subscription With Receipt нужно указывать boolean параметр recurring со значением true, а для списания денег — вызывать метод Charge Subscription.

🔘Расширили методы Get Payment Operation Info и Get Payment Operation List. Теперь можно использовать параметр paidAt. Он показывает время оплаты платёжной ссылки. А объект Order содержит информацию обо всех совершённых платежах и возвратах по ссылке.

В этом релизе добавили возможность создавать платёжные ссылки с двухэтапной оплатой — когда перед списанием со счёта деньги сначала замораживаются на нём. Это удобно для агрегаторов, турагентств и других бизнесов, где перед оплатой нужно получить актуальные данные от другого сервиса. Например, стоимость авиабилета или номера в отеле.

Как это устроено в нашем API:

🔘 В методах создания платёжных ссылок Create Payment Operation и Create Payment Operation With Receipt теперь есть поле preAuthorization. Укажите в нём true, чтобы создать ссылку с двухэтапной оплатой.
🔘 В вебхуке с событием acquiringInternetPayment у поля status появилось значение AUTHORIZED. Такой статус придёт при успешной заморозке денег на счёте плательщика.
🔘 А чтобы списать деньги со счёта после их заморозки, используйте метод Capture Payment.

Узнать больше деталей и изучить логику работы вы можете в нашей документации 👌

🔘 Появился метод для получения реестра платежей, выполненных через интернет-эквайринг — Get Payment Registry. В реестре будет вся нужная информация для расчётов: платежи, возвраты и комиссии. Теперь можно получать их прямо у себя в сервисе, без перехода в интернет-банк. Детали работы метода описали здесь.

🔘 В методах Create Payment Operation With Receipt и Create Subscription With Receipt можно добавить поставщика для каждой позиции в чеке — в объекте Items.Supplier.
Если вы продаёте товары от разных продавцов, это нужно для соблюдения 54-ФЗ.
Возможность указать поставщика сразу для всех товаров оставили, её можно использовать вместе с Items.Supplier. Как это работает, рассказали в описании методов для оплаты с фискализацией чеков: в создании платёжной ссылки и создании подписки 🤝

Продолжаем добавлять возможности в наш API

Вот что нового появилось в этом релизе:

🔘 Оплата через сервис «Долями» при переходе по платёжной ссылке. Чтобы покупатель мог оплатить заказ через него, укажите paymentMode: [“dolyame”] при создании платёжной ссылки. После оплаты придёт вебхук acquiringInternetPayment. Узнать, какие в нём будут данные, можно в его описании, а подробнее изучить оплату Долями — в документации. Чтобы подключить сервис, оставьте заявку в интернет-банке 👌

🔘 При создании платёжной ссылки или подписки можно указать уникальный ID заказа — в необязательном поле Data.paymentLinkId. Если его не передать, интернет-эквайринг сам заполнит это поле порядковым номером. Опция актуальна для всех методов создания платёжных ссылок и подписок.

В следующем году ставка НДС увеличится с 20 до 22%. Налог необходимо указывать в некоторых наших методах — с 1 января, с 00:00 по Москве в них нужно будет передавать новое значение:

🔘В методах Create Invoice и Create Closing Document в поле ndsKind — значение nds_22
🔘В методах Create Payment Operation With Receipt и Create Subscription With Receipt в поле vatType — vat22 или vat122

Эти изменения уже на продакшене. Обновите запросы в вашем коде, чтобы все операции в новом году прошли успешно. Если передать старую ставку НДС, вернется ошибка.

Если у вас остались вопросы, пишите — поможем и проконсультируем 🤝

Раньше у нас было два метода для создания платёжек:

🔘Create Payment — чтобы получить URL, перейти по нему к платёжке и подписать её

🔘Create Payment For Sign — чтобы платёжка отобразилась в интернет-банке

Мы объединили логику обоих запросов в методе Create Payment For Sign: платежи, созданные им, по-прежнему отображаются в разделе «На подпись» в интернет-банке, и теперь в ответе метод возвращает `redirectUrl` для перехода к созданному платежу.

С 27 февраля метод Create Payment перестанет работать. Обновите создание платёжек в вашем сервисе на метод Create Payment For Sign 🤝

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

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

Подробнее рассказали в нашей документации. Если вам нужно больше информации о закрывающих документах, заглядывайте в нашу Бизнес-энциклопедию, в ней есть подробный гайд 👌