Получить секрет Документация

Подключение platega к Tilda — пошаговая инструкция

Интеграция занимает около 5 минут. В настройках сайта создайте шаблон «Универсальная платёжная система» и заполните поля по шагам ниже.

Названия полей даны ровно так, как их видит ваш Tilda-аккаунт.

Заполняйте поля ровно так, как это написано. Любое отклонение (лишний пробел, не тот регистр, пустое обязательное поле) может вызвать проблемы с приёмом платежей.

Шаги

  1. Получить секрет
  2. Создать шаблон Tilda. Заполнить «Логин» и «Секрет для подписи заказа»
  3. Список соответствия полей
  4. Товары — пропустить
  5. ФФД и дополнительные поля
  6. Подпись заказа — правила
  7. Подпись заказа — алгоритм
  8. Уведомление об оплате
  9. Если что-то не работает

С чего начать

В Tilda откройте: Настройки сайта → Платёжные системы → Универсальная платёжная система → Создать новый шаблон. Затем заполните его по шагам ниже.

1Получить секрет

  1. Откройте главную страницу tilda.platega.io.
  2. Введите ваш merchant ID и Secret от platega. Их можно взять в личном кабинете my.platega.io или у вашего менеджера.
  3. Нажмите «Получить секрет», скопируйте полученное значение. Это и есть секрет, который необходим для интеграции с Tilda.

2Заполнить «Логин» и «Секрет для подписи заказа»

В Tilda в настройках шаблона:

Поле TildaЧто вписать
API URLhttps://tilda.platega.io/pay
Логинсекрет, полученный на шаге 1 (длинная строка из /, +, = и букв)
Секрет для подписи заказаваш merchant ID из my.platega.io (например 583544c7-28ba-42a3-a288-729f610ba4a9)
Скрин: Логин и Секрет для подписи заказа
Шаг 2 — «Логин» и «Секрет для подписи заказа»
Проверьте поля: в «Логин» вставьте секрет из шага 1, а в «Секрет для подписи заказа» — merchant ID. При неверных значениях подпись не совпадёт, а платежи будут отклонены.

3Список соответствия полей

В разделе «Поля» → «Список соответствия полей» заполните вторую и третью колонки строго по таблице ниже. Строки, где обе колонки указаны как «пусто», оставьте без изменений.

Поле Tilda«Поле» (вторая колонка)Третья колонка (формат / дополнительно)
ЛогинmerchantIdпусто
Валютаcurrency643/840/...
ЯзыкпустоВерхний регистр
СтранапустоВерхний регистр
URL для уведомленийnotifyurlпусто
Номер заказаorderid<ID проекта>:<ID заказа>
Описание заказаdescriptionМакс. длина
Сумма заказаamountВ рублях / долларах / ...
Время заказапустоISO-8601 (2014-09-16T14:...)
Email покупателяпустопусто
Телефон покупателяпустоБез изменений
Имя покупателяпустоИмя (или ФИО, если пусто)
Подписьsignatureпусто
Товарыпусто (см. шаг 4)Массив в JSON
Скрин: Список соответствия полей
Шаг 3 — Список соответствия полей

4Товары — пропустите

Внутренний блок «Товары» (Порядковый номер, Название, Количество и т.д.) оставьте полностью пустым. Адаптер не использует разбивку по позициям — Tilda формирует единый JSON и передаёт его целиком.

Скрин: блок Товары
Шаг 4 — Товары оставьте как есть, все поля пустыми

5ФФД и дополнительные поля

ФФД 1.05 — оставьте Receipt как есть в «Поле», и включите галку «Использовать цену со скидкой в массиве ФФД». Остальные галки в этом блоке снимите.

Список дополнительных полей — нажмите «Добавить поле» и создайте три записи:

Имя поля (левый столбец)Значение (правый)
successurlпусто (или ваш Tilda-URL «Спасибо за покупку»)
failurlпусто (или URL страницы ошибки)
paymentMethodномер метода: 2 СБП, 11 Карты РФ, 12 Международные карты, 13 Крипта. По умолчанию — карты РФ.
Скрин: ФФД и дополнительные поля
Шаг 5 — ФФД 1.05 + три дополнительных поля (successurl, failurl, paymentMethod)
Если поля successurl или failurl не заполнены, после оплаты покупатель будет перенаправлен на исходную страницу (корзину Tilda).

6Подпись заказа — правила

В разделе «Подпись заказа»:

Правила подписиВсе поля
Исключить поляоставьте значение по умолчанию (signature)
Не использовать поля с пустыми значениями в подписивключить ✅
Порядок сортировкиВ алфавитном порядке, с начала
Разделительоставьте пустым; допускается также символ |
Скрин: Подпись заказа — правила
Шаг 6 — правила подписи

7Подпись заказа — алгоритм

Ниже на той же странице:

Добавлять секрет в подписьНет
Алгоритм шифрования подписиSHA-256
Использовать секрет в качестве ключа алгоритма (HMAC)включить ✅ (обязательно)
Преобразовать к верхнему региструвыключить ⬜
Преобразовать итоговую подпись в base64выключить ⬜
Скрин: Алгоритм подписи
Шаг 7 — алгоритм + HMAC
Обязательно включите опцию HMAC. Без неё расчёт подписи будет неверным, и запрос отклонится с ошибкой Bad signature.

8Уведомление об оплате

Внизу страницы — включите галку «Использовать аналогичные правила для подписи уведомления» и заполните блок «Уведомление»:

Признак успешного платежа — Полеstatus
Признак успешного платежа — Значениеsuccess
Идентификатор транзакции — Полепусто
Ответ об успехе уведомленияOK
Ответ об ошибке уведомленияERROR
Ответы на уведомление в формате jsonвыключить ⬜
Скрин: Уведомление — признак успеха
Шаг 8.1 — «Признак успешного платежа» = status / success
Скрин: Уведомление — ответы
Шаг 8.2 — ответы об успехе/ошибке
Callback URL в личном кабинете platega настраивать не требуется. Адаптер автоматически извлекает URL из запроса Tilda и использует его для отправки уведомлений.

Готово

Создайте тестовый товар, оформите и оплатите заказ. Через несколько секунд статус заказа в панели Tilda автоматически изменится на «Оплачено».

Если что-то не работает

Заказ не помечается оплаченным

Проверьте настройки интеграции:

  1. Соответствие «Логина» и «Секрета» (шаг 2).
  2. Отсутствие лишних пробелов в поле «Логин».
  3. Наличие галочки HMAC (шаг 7).

Если статус заказа не изменится в течение 5 минут — пришлите его номер из Tilda команде поддержки platega.