Крок 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