Шаг 1. Получите логин и секрет
Создайте секретный ключ в личном кабинете UTOPAY (Integration → API keys), сначала тестовый utopay_sk_test_…. Вставьте его сюда — ключ уходит только в api.utopay.app и на этой странице не сохраняется.
Тестовый ключ даёт настройки песочницы, боевой — боевые. У каждого свои логин и секрет.
Шаг 2. Создайте платёжную систему в Tilda
- Tilda → Настройки сайта → Платёжные системы → Универсальная платёжная система → шаблон «Новая платёжная система (для разработчиков)».
- Основные поля: Логин и Секрет для подписи заказа — из шага 1; Валюта — USD, EUR или другая валюта, которую принимает UTOPAY (рубли не принимаются); Страна.
- Расширенные настройки → API URL: значение из шага 1 (
https://api.utopay.app/tilda/pay). - Список соответствия полей: Логин →
login, Валюта →currency, URL для уведомлений →notify_url, Номер заказа →order_number, Описание заказа →order_description, Сумма заказа →order_amount, Email покупателя →client_email, Подпись →signature. - Подпись заказа: особые правила
{{login}}{{order_amount}}{{order_number}}{{secret}}, алгоритм SHA-256, галочка «Использовать секрет в качестве ключа алгоритма (HMAC)». - Подпись уведомления: особые правила
{{login}}{{order_amount}}{{order_number}}{{secret}}{{paid}}, SHA-256, HMAC. Признак успешного платежа: полеpaid, значение1. Идентификатор транзакции:transaction_id. - Сохраните, переопубликуйте страницы с корзиной, оформите тестовый заказ и нажмите в песочнице UTOPAY зелёную кнопку ✅ — Tilda покажет заказ оплаченным. Затем повторите шаг 1 с боевым ключом и замените логин и секрет.
Параметры в API URL
| Добавьте к API URL | Что делает |
|---|---|
?method=crypto&coin=bep20/usdt | Криптовалюта вместо карты (1,5%). Добавьте кошелёк для сети в кабинете → Funds & payouts. |
?provider=paypal | Сразу вести покупателей к одному способу для карт (stripe, paypal, revolut…). |
?success=https://ваш-сайт/thanks | Страница, куда покупатель вернётся после оплаты (по умолчанию — главная вашего сайта). |
Параметры можно сочетать: https://api.utopay.app/tilda/pay?method=crypto&coin=bep20/usdt&success=https://ваш-сайт/thanks. Чтобы предложить и карту, и крипту, создайте в Tilda две универсальные платёжные системы с разными API URL.
Как подтверждается заказ
Tilda подписывает каждый заказ вашим секретом (HMAC-SHA256); заказ с неверной подписью UTOPAY отклоняет, поэтому сумму по дороге не подменить. После оплаты UTOPAY отправляет в Tilda уведомление с такой же подписью, paid = 1 и номером платежа UTOPAY; Tilda проверяет подпись, номер и сумму заказа и отмечает его оплаченным. Если Tilda не ответила, UTOPAY повторяет отправку шесть часов.
История версий
- 1.0 — Универсальная платёжная система: карта / PayPal и криптовалюта, подписанные заказы и уведомления.
Обновлено · Команда интеграций UTOPAY