Adım 1. Login ve secret değerlerini alın
UTOPAY panelinde gizli anahtar oluşturun (Integration → API keys); test anahtarı utopay_sk_test_… ile başlayın. Buraya yapıştırın: anahtar yalnızca api.utopay.app’e gönderilir ve bu sayfada saklanmaz.
Test anahtarı sandbox ayarlarını, canlı anahtar canlı ayarları verir. Her birinin kendi login ve secret değeri vardır.
Adım 2. Tilda’da ödeme sistemini oluşturun
- Tilda → Site settings → Payment systems → Universal payment system → «New payment system (for developers)» şablonu.
- Ana alanlar: Login ve Secret for order signing — 1. adımdan; Currency — USD, EUR ya da UTOPAY’in kabul ettiği başka bir para birimi (RUB kabul edilmez); Country.
- Gelişmiş ayarlar → API URL: 1. adımdaki değer (
https://api.utopay.app/tilda/pay). - Alan eşleştirme: Login →
login, Currency →currency, Notification URL →notify_url, Order number →order_number, Order description →order_description, Order amount →order_amount, Buyer email →client_email, Signature →signature. - Sipariş imzası: özel kurallar
{{login}}{{order_amount}}{{order_number}}{{secret}}, algoritma SHA-256, «Use the secret as the algorithm key (HMAC)» kutusunu işaretleyin. - Bildirim imzası: özel kurallar
{{login}}{{order_amount}}{{order_number}}{{secret}}{{paid}}, SHA-256, HMAC. Başarı göstergesi: alanpaid, değer1. İşlem kimliği:transaction_id. - Kaydedin, sepetli sayfaları yeniden yayınlayın, test siparişi verin ve UTOPAY sandbox’ında yeşil ✅ düğmesine basın: Tilda siparişi ödendi gösterir. Sonra 1. adımı canlı anahtarla tekrarlayıp login ve secret değerlerini değiştirin.
API URL seçenekleri
| API URL’ye ekleyin | Ne yapar |
|---|---|
?method=crypto&coin=bep20/usdt | Kart yerine kripto (%1,5). Ağ için cüzdanınızı panelde ekleyin → Funds & payouts. |
?provider=paypal | Alıcıları doğrudan tek bir kart yöntemine yönlendirir (stripe, paypal, revolut…). |
?success=https://siteniz/tesekkurler | Alıcının ödemeden sonra döndüğü sayfa (varsayılan: sitenizin ana sayfası). |
Seçenekler birleştirilebilir: https://api.utopay.app/tilda/pay?method=crypto&coin=bep20/usdt&success=https://siteniz/tesekkurler. Hem kart hem kripto sunmak için Tilda’da farklı API URL’leriyle iki evrensel ödeme sistemi oluşturun.
Sipariş nasıl onaylanır
Tilda her siparişi secret değerinizle imzalar (HMAC-SHA256); UTOPAY imzası yanlış siparişi reddeder, bu yüzden tutar yolda değiştirilemez. Ödemeden sonra UTOPAY Tilda’ya aynı şekilde imzalanmış, paid = 1 ve UTOPAY ödeme kimliğini içeren bir bildirim gönderir; Tilda imzayı, sipariş numarasını ve tutarı kontrol edip siparişi ödendi yapar. Tilda yanıt vermezse UTOPAY altı saat boyunca yeniden dener.
Sürüm geçmişi
- 1.0 — Evrensel ödeme sistemi: kart / PayPal ve kripto, imzalı siparişler ve bildirimler.
Güncellendi · UTOPAY entegrasyon ekibi