Подключение

Перед интеграцией

Перед тем как интегрироваться Корзиной, нужно подключить интернет-эквайринг Т‑Кассы.

Если у вас уже подключен интернет-эквайринг:

1. В личном кабинете Т‑Бизнеса выберите Интернет-эквайринг → Магазины. Нажмите Создать магазин → Интернет-магазин.

2. В созданном магазине перейдите в раздел Терминалы. Вы увидите два терминала — тестовый и рабочий: у тестового будет статус «Протестируйте платежи», у рабочего — «Выключен». Игнорируйте статус тестового терминала — сразу переходите к настройке рабочего.

3. Нажмите Настроить на плашке рабочего терминала и в поле Подключение выберите Мобильное приложение → Сохранить.

   
   

4. Выпустите токен. Как выпустить токен.

   
   

5. Выпустите mTLS-сертификат. Как выпустить сертификат.

   Его может выпустить только директор. Для выпуска понадобится КЭП. Выпустить КЭП через Т‑Банк.

   Токен и сертификат свяжутся, когда у вас сделают первую покупку на сайте.

Сертификат привязан к IP‑адресу сайта, с которого будут отправляться запросы в Корзину. Если сайт переедет и у него изменится адрес сервера, перевыпустите сертификат и токен.

6. Напишите нашему специалисту по интеграции на checkout_integation@tinkoff.ru и отправьте ему информацию о своем магазине:
   • URL‑адрес для получения уведомлений по заказу;
   • URL‑адрес главной страницы вашего магазина, куда должна вести кнопка возврата в магазин;
   • логотип — будет отображаться на форме оформления заказа;
   • контактное лицо — укажите того, с кем будет общаться наш менеджер по интеграции в ходе подключения Корзины;
   • тип магазина — без доставки, с доставкой со сбором и передачей адреса, с доставкой и интеграцией со службами доставки.

Специалист по интеграции отправит вам универсальный идентификатор магазина — shop ID. Он будет нужен вашим разработчикам, чтобы встроить кнопку Корзины на сайт.

7. Если у вас магазин, который пользуется услугами служб доставки, зарегистрируйтесь в сервисе-агрегаторе служб доставки MetaShip. В личном кабинете MetaShip получите идентификатор вашего виртуального магазина и склада. Как это сделать.

После этого Корзину можно интегрировать на ваш сайт.

Интеграция

Настроить чеки

Когда вы интегрируете Корзину на сайт, подключите облачную онлайн-кассу или сервис Чеки от Т‑Кассы. Это делается обязательно и нужно, чтобы отправлять чеки в налоговую и покупателям — так налоговая будет узнавать о доходах бизнеса и понимать, какой налог с вас удержать. Есть закон, который запрещает торговать без онлайн-кассы всем, кроме ИП на НПД — ИП‑самозанятыми: 54-ФЗ «О применении контрольно-кассовой техники».

Можно выбрать один из вариантов:

• Облачная онлайн-касса — подойдет, если вы готовы платить за аренду или подключение онлайн-кассы раз в месяц. Какую облачную онлайн-кассу выбрать.
• Чеки от Т‑Кассы — подойдут, если вы готовы отдавать комиссию после каждой покупки.

Как интегрировать онлайн-кассу с интернет-эквайрингом

Перед подключением нужно пройти тесты № 7 и 8 — так вы проверите передачу данных чека. Для этого нам нужно переключить вас с рабочего терминала на тестовый — напишите на checkout_integation@tinkoff.ru, наш специалист переключит терминал. После интеграции облачной онлайн-кассы или Чеков с магазином мы сами переключим терминал на рабочий, повторно писать специалисту не нужно.

Настроить интеграцию Корзины со службами доставки

Чтобы Корзина передавала данные о заказах в службы доставки и получала от них трек‑номер доставки:

1. Зарегистрируйтесь в агрегаторе служб доставки MetaShip.
2. Создайте виртуальный магазин в личном кабинете MetaShip
3. Подключите службы доставки,с которыми работаете.

Пошаговая инструкция

В разделе Настройки личного кабинета MetaShip в подразделе Мои магазины появится идентификатор вашего магазина, а в подразделе Мои склады — идентификатор вашего виртуального склада.

Передайте их вашим разработчикам — они добавят параметры в метод Создать заказ для клиента-физического лица.

Чтобы покупатели могли оформлять заказы с самовывозом из пунктов выдачи заказов и постаматов, создайте виджет в личном кабинете MetaShip:

1. Перейдите в Настройки → Виджеты → Создать виджет.

2. В выпадающем списке выберите ваш магазин с Корзиной и нажмите Создать виджет.

   
   

3. Виджет сразу появится в личном кабинете MetaShip. В плашке будет значение токена — скопируйте его и передайте нашему специалисту по интеграции на checkout_integation@tinkoff.ru.

   
   

В течение рабочего дня специалист настроит этот тип доставки на сайте, где вы подключили Корзину.

Настроить передачу данных заказа через метод

При нажатии на кнопку Корзины должен вызываться метод вашего API, который в свою очередь вызывает метод API Корзины. Для этого реализуйте вызов метода Создать заказ для клиента-физического лица.

Для магазинов с доставкой в метод нужно включить дополнительные параметры — набор параметров будет зависеть от того, своя у вашего магазина доставка или он работает с сервисами доставки.

Что нужно передать в методе:

Метод POST возвращает ссылку на заказ в сервис «Корзина». Кнопка Купить быстро Корзины перенаправляет покупателя по этой ссылке для дальнейшего оформления заказа. Как добавить кнопку на сайт магазина.

Добавить кнопку Корзины на сайт магазина

Вы можете добавить кнопку Корзины рядом со стандартной кнопкой оформления заказа на вашем сайте или заменить ее.

В обоих случаях сгенерируйте скрипт кнопки Корзины с помощью виджета ниже.

Вместо выделенного желтым маркером кода:

• В объекте createOrder — встройте метод Создать заказ для клиента-физического лица. Как настроить метод.
• В параметре document.querySelector — поставьте селектор HTML‑элемента, на месте которого должна появиться кнопка.

Подключить прием оплаты через СБП

Вы можете подключить прием оплаты через Систему быстрых платежей, если покупатели совершили на сайте хотя бы один платеж:

1. В личном кабинете Т‑Бизнеса выберите Интернет-эквайринг → Магазины.
2. Выберите свой магазин → Способы оплаты → СБП → Своя платежная форма → Включить.
3. Отправьте запрос на добавление кнопки оплаты через СБП на форму Корзины на checkout_integation@tinkoff.ru — наш специалист завершит настройку в течение одного рабочего дня.

Сценарии работы с Корзиной

Дополнительно

Какие данные Корзина отдаст магазину после оформления заказа

После оформления заказа Корзина отправит следующие данные URL‑адрес для уведомлений, который вы указали при заведении магазина:

checkoutOrderId	Номер заказа в Корзине.
orderId	Номер заказа в системе мерчанта.
timestamp	Дата создания заказа.
status	Статус заказа. Какие есть статусы и что они означают.
message	Сообщение-расшифровка статуса.
"payment": { "amount": 2 000, "paymentId" }	Если платеж совершен — сумма заказа и ID платежа.
"delivery": { "deliveryId": "167b8034-99b3-4851-bfbd-34eab62e7dc3" "trackingNumber": "119037732223" }	Если создан заказ на доставку — ID доставки в системе MetaShip. Если заказ уже передан в службу доставки — трек‑номер заказа.

Как обрабатывается уведомление о статусе заказа

• Какие есть статусы и что они означают
• Вебхук Статус заказа в системе Корзина

Обработчик уведомлений должен возвращать ответ 200 OK с пустым телом, когда статус платежа успешно меняется.

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

Пример, как это работает:

1. Корзина посылает уведомление о статусе ORDER_PROCESSING.
2. В обработчике уведомлений на стороне магазина произошла ошибка, и он вернул 500 Internal Server Error, а не 200 OK.
3. Через случайное время снова отправляется уведомление о статусе ORDER_PROCESSING.
4. Обработчик возвращает ответ 200 OK.
5. Отправка уведомлений прекращается — оно успешно доставлено.

Как найти заказ в личном кабинете MetaShip

• Перейдите в личный кабинет MetaShip и по идентификатору deliveryID найдите нужный заказ.

• Скопируйте идентификатор deliveryID в URL‑адрес заказа. URL‑адрес заказа в MetaShip всегда имеет такой вид: https://cabinet. MetaShip.ru/orders/deliveryID.

Получить дополнительные данные о заказе или покупателе

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

С помощью метода можно получить следующие данные: