Modül ne yapar
- Ödeme sayfası Kart, Apple Pay, Google Pay, PayPal ve Kripto (coin seçicili) seçeneklerini gösterir. İkisinden biri kapatılabilir.
- Sipariş Awaiting UTOPAY payment durumunda oluşturulur, ardından alıcı UTOPAY sayfasında öder.
- Ödeme API üzerinden yeniden okunup tutar ve para birimi eşleşince sipariş Payment accepted olur; UTOPAY ödeme kimliği işlem kimliği olarak kaydedilir.
- Sipariş onay sayfası ödemeyi yeniden kontrol eder ve sipariş ödenmediği sürece Tekrar öde düğmesini gösterir.
- Eksik ödenen kripto ve uyuşmayan tutarlar sipariş için Advanced Parameters → Logs bölümüne yazılır.
Kurulum
- Yukarıdaki ZIP’i indirin.
- Modules → Module Manager → Upload a module → ZIP’i seçin (PrestaShop 1.6: Modules → Add a new module).
- Configure’u açın. UTOPAY panelinde test anahtarı
utopay_sk_test_…oluşturun (Integration → API keys) ve yapıştırın. Anahtar kaydederken kontrol edilir. - Ödeme seçeneklerini ve coinleri seçin. Kripto için EVM cüzdanınızı panelde ekleyin (Project settings → Funds & payouts).
- Modülün para birimleriniz ve ülkeleriniz için Payment → Preferences bölümünde izinli olduğundan emin olun.
Ayarlar
| Alan | Ne yapar |
|---|---|
| Secret key | Sandbox için utopay_sk_test_…, gerçek ödemeler için utopay_sk_live_…. Kayıtlı anahtarı korumak için boş bırakın. |
| Payment options | Kart / PayPal ve kripto, yalnızca kart ya da yalnızca kripto. |
| Crypto coins | Virgülle ayrılmış tickerlar, örn. bep20/usdt,erc20/usdt,polygon/usdc. |
| Card method | Boş: alıcı seçer; ya da doğrudan Stripe, PayPal, Revolut… |
Test ödemesi
- Test anahtarıyla sipariş verin ve bir UTOPAY seçeneği seçin.
- UTOPAY sandbox’ında yeşil ✅ düğmesine basın.
- Sipariş onay sayfasına dönersiniz: «Ödeme alındı». Yönetim panelinde sipariş Payment accepted durumundadır.
- Anahtarı
utopay_sk_live_…ile değiştirin.
Siparişler nasıl onaylanır
Her ödeme, sipariş kimliği, tutar ve para birimiyle gizli anahtarınızla imzalanmış kendi bildirim URL’sini (/module/utopay/callback) taşır. UTOPAY her olayı imzalar (HMAC-SHA256) ve mağaza 2xx dönmezse altı saat boyunca yeniden dener.
Modül iki imzayı da kontrol eder, ödemeyi API üzerinden yeniden okur ve yalnızca sipariş toplamı ve para birimiyle tam ödenmişse Payment accepted yapar.
Sorun giderme
- UTOPAY ödeme sayfasında görünmüyor: sepet para birimi desteklenmiyor, anahtar boş ya da modül Payment → Preferences içinde para birimi / ülke için açık değil.
- Siparişler «Awaiting UTOPAY payment» durumunda kalıyor: mağaza internetten erişilebilir olmalı ve bakım modu kapalı olmalı; Advanced Parameters → Logs bölümüne bakın.
- «amount is below the minimum»: toplam, yöntemin ya da coinin minimumunun altında; alıcı Tekrar öde’ye basıp başka birini seçebilir.
Sürüm geçmişi
- 1.0.0 — ilk sürüm: PrestaShop 1.6.1 – 9, kart ve PayPal, kripto, Tekrar öde, Rusça çeviri.
SHA-256: 3fbdc9540feaa15a12ca677af2c56d55284f104a119c50bc139fe20e1248ac52
Güncellendi · UTOPAY entegrasyon ekibi