Как подключить Tilda Cart

Создание заказов и платежей из корзины Tilda

Как подготовить Creamy

Откройте «Пространство» → «Интеграции» → «Tilda»Пространство
Включите «Принимать webhook Tilda»
Создайте ключ и сразу сохраните его
Скопируйте адрес из поля «Webhook Tilda»

Как настроить webhook в Tilda

Откройте «Формы» → «Webhook» в Tilda
Создайте webhook с адресом из Creamy
Выберите API Method: HEADER
Укажите API NAME: Authorization
Укажите API KEY: Bearer <API_TOKEN>
Включите отправку application/json, товаров массивом и дополнительных данных товаров
Оставьте «Отправлять только после оплаты» выключенным
Создайте второй webhook с тем же адресом и завершающим /, затем включите для него «Отправлять только после оплаты»
Подключите оба webhook в настройках блока «Корзина»

Первый webhook создаёт заказ сразу. Второй добавляет оплату после появления payment.systranid. Creamy принимает адреса с завершающим / и без него как один endpoint.

Как связать товары

Передавайте externalid товара Tilda, равный id карточки Creamy
Если externalid совпал, заказ использует товар из каталога Creamy
Без совпадения заказ всё равно создаётся, позиция сохраняется из данных Tilda

Если externalid нельзя настроить, используйте маппинг товаров:

«Маппинг товаров по опциям» связывает полный набор внешних опций с карточкой Creamy. Например, запись Вкус: Красный бархат не совпадёт с товаром, у которого вместе со вкусом пришла опция Размер
«Маппинг товаров по названиям» связывает полное название позиции Tilda с карточкой Creamy. Вводите видимый текст с обычными кавычками, например Открытка "Вылезай пойдем есть тортик"; значение " из webhook распознаётся как те же кавычки
Регистр, порядок опций и лишние пробелы не влияют на сопоставление

Приоритет сопоставления: валидный externalid, затем полный набор опций, затем название. Маппинг связывает позицию с каталогом, но snapshot заказа сохраняет исходное название и цену из Tilda.

Как сопоставить поля

Откройте «Маппинг полей» и укажите имена полей формы Tilda
Без настройки имя, телефон, email, дата и время читаются из Name, Phone, Email, Date и Time
Получатель и доставка читаются из полей внутри payment
Платформу, статус, данные получателя и текст открытки сопоставьте явно, если они нужны
Включите сохранение нераспознанных полей, чтобы поместить их в комментарий магазина

Дата принимает YYYY-MM-DD или unix timestamp. Время принимает 15, 15:00, 15-16 и 15:00-16:00.

Как создаётся оплата

Платёж создаётся только при непустом payment.systranid
Повтор с тем же systranid не создаёт второй платёж
Новый systranid создаёт отдельную операцию
Платёж Tilda показывается в подробной истории независимо от выбранного режима оплат

Как проверить запросы

В настройках Tilda хранится история последних 50 авторизованных webhook. В ней видны время, результат и данные запроса. Cookies, ключи и пароли заменяются на [redacted].