Skip to main content

Работа с Корзиной

С помощью методов API для работы с системой Корзина вы можете:

  • создавать заказы для клиентов-физических лиц в зависимости от типа магазина и доставки;
  • гибко настраивать способы оплаты и доставки в зависимости от бизнес-потребностей;
  • получать информацию о заказе: товары, их описание и стоимость, данные о покупателе — электронная почта, телефон, адрес доставки.

Методы в документации

Принцип работы

  1. Вы формируете заказ на своей стороне и запрос на создание заказа в Корзине через метод Создать заказ для клиента-физического лица.
  2. Корзина возвращает вам идентификатор заказа и ссылку на страницу оплаты.
  3. Вы перенаправляете пользователя на страницу оплаты.
  4. Получаете вебхуки с информацией об изменении состояния заказа.
  5. При получении вебхуков запрашиваете информацию о заказе через метод Получить информацию о заказе клиента-физического лица.
  6. На основании состояния заказа в Корзине принимаете решение о том, какую информацию сейчас нужно получить и что следует сделать с заказом в вашей системе.

Статусы заказа

Каждый статус заказа в Корзине описывается кодом. История статусов заказа возвращается в поле order.statuses — оно хранит массив объектов. У каждого объекта есть два поля:

  • name — код состояния;
  • timestamp — время, когда заказ перешел в это состояние.

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

Схемы процессов оплаты и доставки:


Описания кодов статусов заказа:


Способы создания заказа

По типу доставки

Примеры создания заказов для трех типов заказов, которые поддерживаются Корзиной от Т-Банка:

По типу оплаты

В системе можно гибко настраивать способы оплаты для разных типов доставки. Для этого нужно передать соответствующее условие в запросе метода Создать заказ для клиента-физического лица.

Примеры:

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.