# Сайты на Tilda

Сайт на Tilda начисляет баллы участникам за оплаченные заказы: Tilda присылает заказ вебхуком на адрес сайта в
платформе, а платформа находит участника по телефону из формы корзины. Мерчанту не нужен программист: он подключает
сайт в кабинете и вписывает адрес и ключ в настройки Tilda. Устройство описано в [ADR-0028](../../adr/0028-tilda.md).

## Настройка (мерчант)

Те же шаги показывает страница «Интеграция → Tilda» в кабинете мерчанта.

1. В кабинете: «Подключить сайт» — название, программа и точка продаж. Скопировать ключ: он показывается один раз.
2. В Tilda: «Настройки сайта → Формы → Webhook», адрес — «Адрес для Tilda» из таблицы сайтов.
3. В настройках приёмщика Webhook:
   - отметить «Передавать данные по товарам в заказе — массивом»;
   - ключ API: имя `X-Loyal-Key`, значение — ключ сайта, передавать — в заголовках.
4. В «Настройках сайта → Платёжные системы» отметить «Отправлять данные в сервисы приёма данных только после оплаты».
5. Подключить Webhook **только к форме корзины** и опубликовать страницы. К другим формам — нет: их поля заполняет
   посетитель, и он сможет прислать поддельный заказ.
6. Добавить на сайт кнопку «Бонусная карта» со ссылкой на кабинет покупателя программы (ссылка — на той же странице).

Если поле телефона в форме корзины называется не `Phone`, его имя меняется в кабинете: «Изменить» у сайта.

## Проверка до пилота (владелец продукта)

Приём данных и корзина с оплатой доступны на платных тарифах Tilda. Поля оплаченного заказа (`payment.systranid`,
`payment.sys`, `payment.delivery_price`) и их кодировка (вложенные поля формы) взяты из описаний интеграторов, а не из
справки Tilda. Проверить на сайте с платным тарифом и тестовой оплатой:

1. Подключить сайт по шагам выше; заказ участника с тестовой оплатой — на странице «Tilda» растёт «с участником», в
   карточке участника — чек с баллами.
2. Заказ с оплатой при получении — растёт «не оплачено», чека нет. Посмотреть, что Tilda присылает в `payment.sys` и
   `payment.systranid` для такого заказа: платформа считает неоплаченными `sys` = `none` или `cash` и `systranid` из
   одних нулей.
3. Снять галочку «только после оплаты», оформить заказ и оплатить: если Tilda присылает заказ ещё раз после оплаты,
   «не оплачено» превращается в «с участником».
4. Заказ с промокодом Tilda и доставкой — сумма чека равна сумме товаров со скидкой, без доставки.
5. Дописать в форму корзины на странице скрытое поле `payment[amount]` (инструменты разработчика браузера) и оформить
   заказ — заказ не берётся: поле дано дважды.
6. Неверный ключ в настройках Tilda — в таблице сайтов появляется время в «Неверный ключ».

Если Tilda называет поля иначе, чем в ADR-0028, — поправить `Modules\Tilda\Internal\OrderReader` и его тесты.

## Возврат заказа

Tilda о возвратах не сообщает. Возвращённый заказ мерчант возвращает сам: «Вернуть заказ» у сайта на странице «Tilda»,
номер заказа из Tilda. Заказ возвращается целиком (или остаток, если часть вернули на кассе), баллы за него отменяются
по правилам возврата программы. Это может сделать владелец или администратор мерчанта.

## Чего нет

- Списания баллов в корзине Tilda: промокоды Tilda проверяет только по своему списку.
- Возврата части заказа из кабинета: часть товаров возвращают ручной корректировкой баллов в карточке участника.
