Paket ne yapar
- utopay namespace’ini ve utopay_* sistem ayarlarını (anahtar, para birimi, kur, coin…) İngilizce ve Rusça açıklamalarla oluşturur.
- miniShop2 ile: ödeme sınıflarını kaydeder ve iki kapalı ödeme yöntemi oluşturur: «Card, Apple Pay, Google Pay, PayPal» (Utopay sınıfı) ve «Crypto: USDT, USDC» (UtopayCrypto sınıfı).
- miniShop3 ile (MODX 3): aynı iki yöntemi, miniShop3 ödeme denemeleri ve webhook rotasıyla çalışan
Utopay\MiniShop3\UtopayPaymentsağlayıcısıyla oluşturur. - Sipariş verildikten sonra alıcı UTOPAY sayfasına gider; sipariş yalnızca API üzerinden yeniden okunan ödeme tutar ve para birimiyle eşleştiğinde ödendi olur.
- Güncellemeler ayarlarınızı korur; kaldırma yöntemleri kapatır ve siparişlere dokunmaz.
Kurulum
- Yukarıdaki paketi indirin (
utopay-1.1.0-pl.transport.zipadını değiştirmeyin). - MODX yöneticisi → Extras → Installer → «Download Extras» yanındaki ok → Upload a package → dosyayı seçin → Install.
- System → System Settings → namespace utopay: utopay_secret_key değerini girin; UTOPAY panelinde test anahtarı
utopay_sk_test_…oluşturun (Integration → API keys). Fiyatlarınız USD değilse para birimini ve kuru ayarlayın. - miniShop2 / miniShop3 → Settings → Payments: «Card, Apple Pay, Google Pay, PayPal» ve/veya «Crypto: USDT, USDC» yöntemlerini açın ve teslimat yöntemlerinize bağlayın.
- Kripto için EVM cüzdanınızı panelde ekleyin (Project settings → Funds & payouts) ve utopay_coin değerini girin.
- Test siparişi verin, UTOPAY sandbox’ında yeşil ✅ düğmesine basın: sipariş ödendi olur. Anahtarı
utopay_sk_live_…ile değiştirin.
Ayarlar
| Sistem ayarı | Ne yapar |
|---|---|
| utopay_secret_key | utopay_sk_test_… / utopay_sk_live_…. |
| utopay_currency, utopay_rate | UTOPAY’in tahsil ettiği para birimi ve fiyatlarınızdan sabit kur (fiyatlar zaten o para birimindeyse 1). |
| utopay_shop_currency | Yalnızca miniShop3: fiyatların para birimi; ödeme denemeleri bu para biriminde tutulur. |
| utopay_coin | Kripto yönteminin coini, örn. bep20/usdt. |
| utopay_provider | İsteğe bağlı: alıcıları doğrudan Stripe, PayPal, Revolut… yöntemine yönlendirir. |
| utopay_ms2_paid_status, utopay_success_id | miniShop2 ödendi durumu (2) ve alıcının döndüğü kaynak. |
Siparişler nasıl onaylanır
Her ödeme, sipariş kimliği, tutar ve para birimiyle gizli anahtarınızla imzalanmış kendi bildirim URL’sini taşır. UTOPAY her olayı imzalar (HMAC-SHA256) ve altı saat boyunca yeniden dener.
Ödeme her zaman UTOPAY API’si üzerinden yeniden okunur; yalnızca tam tutar ve para birimi siparişi ödendi yapar. Eksik ödenen kripto ve uyuşmazlıklar MODX hata günlüğüne [UTOPAY] önekiyle yazılır.
Sürüm geçmişi
- 1.1.0-pl — MODX yükleyicisi için kurulum paketi: namespace, sistem ayarları, ödeme yöntemleri otomatik oluşturulur.
- 1.0.0 — dosya olarak ilk sürüm: miniShop2 (MODX 2.8 – 3.x) ve miniShop3 1.14 beta.
SHA-256: 4c3b62e6f9d3dab65ad40b9610b463f40b78327eff0ec5aaabed77fac64a3a2a
Güncellendi · UTOPAY entegrasyon ekibi