Uzantı ne yapar
- Ödeme sayfasında alıcı Kart, Apple Pay, Google Pay, PayPal ya da coin seçicili Kripto seçer, Onayla’ya basar ve UTOPAY sayfasında öder.
- Sipariş, ödeme API üzerinden yeniden okunup tutar ve para birimi eşleştikten sonra ödendi durumunu (varsayılan Processing) alır.
- Alıcı ödeme onaylanmadan döndüyse (kripto hâlâ ağda), sipariş bekleme durumuyla (varsayılan Pending) görünür olur ve sonra ödendi olur.
- Eksik ödenen kripto ve uyuşmayan tutarlar, sipariş geçmişinde bir notla bekleme durumunda kalır.
- Sipariş para birimi desteklenmiyorsa ya da sepette abonelik ürünleri varsa (4.x) yöntem gizlenir.
Kurulum
- Sürümünüze uygun paketi indirip açın: içinde utopay.ocmod.zip ve README.txt vardır.
- OpenCart 3.0 ve 4.x: Extensions → Installer → Upload →
utopay.ocmod.zipdosyasını seçin (4.x’te yanındaki Install’a da basın). Dosya adını değiştirmeyin: OpenCart 4 uzantı kodunu ondan alır. - OpenCart 2.3:
utopay.ocmod.zipdosyasını açın ve içindekiuploadklasörünün içeriğini FTP ile mağaza kök dizinine yükleyin; 2.3 yükleyicisi FTP ayarı ister. - Extensions → Extensions → Payments → UTOPAY → Install → Edit.
- UTOPAY panelinde Integration → API keys bölümünü açın, test anahtarı
utopay_sk_test_…oluşturup yapıştırın. Anahtar kaydederken kontrol edilir. - Kripto için EVM cüzdanınızı panelde ekleyin (Project settings → Funds & payouts) ve coinleri listeleyin.
Ayarlar
| Alan | Ne yapar |
|---|---|
| Secret key | Sandbox için utopay_sk_test_…, gerçek ödemeler için utopay_sk_live_…. |
| 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… |
| Paid order status | Ödeme onaylandığında atanır. Varsayılan Processing. |
| Awaiting / check status | Alıcı onaydan önce döndüğünde ya da eksik kripto ödediğinde atanır. Varsayılan Pending. |
| Geo zone, status, sort order | Her OpenCart ödeme yöntemindeki gibi. |
Test ödemesi
- Test anahtarıyla sipariş verin, UTOPAY’i seçin ve Confirm order düğmesine basın.
- UTOPAY sandbox’ında yeşil ✅ düğmesine basın.
- Başarılı sipariş sayfasına gelirsiniz; sipariş «UTOPAY: payment ord_test_… received (test)» notuyla Processing durumundadır.
- Anahtarı
utopay_sk_live_…ile değiştirin.
Siparişler nasıl onaylanır
Her ödeme, sipariş numarası, tutar ve para birimiyle gizli anahtarınızla imzalanmış kendi bildirim URL’sini taşır. UTOPAY her olayı imzalar (HMAC-SHA256) ve mağaza 2xx dönmezse altı saat boyunca yeniden dener.
Uzantı iki imzayı da kontrol eder, ödemeyi API üzerinden yeniden okur ve siparişi yalnızca istenen tutar ve para birimiyle tam ödenmişse değiştirir. Ödenmiş bir sipariş asla geri alınmaz.
Sorun giderme
- UTOPAY ödeme sayfasında çıkmıyor: sipariş para birimi desteklenmiyor, anahtar boş, yöntem kapalı ya da coğrafi bölge uymuyor.
- «amount is below the minimum»: toplam, yöntemin ya da coinin minimumunun altında; alıcı başka birini seçebilir.
- Sipariş yönetimde görünmüyor: alıcı ödemeden ayrıldı; OpenCart bu siparişleri «missing orders» olarak tutar (Missing Orders ile filtreleyin).
- Sipariş Pending kalıyor: mağaza internetten erişilebilir olmalı; System → Maintenance → Error Logs içinde
UTOPAYsatırlarına bakın.
Sürüm geçmişi
- 1.0.0 — ilk sürüm: OpenCart 2.3 – 3.0 ve 4.0 – 4.1, kart ve PayPal, kripto, Rusça çeviri.
SHA-256 (2.3 – 3.0): 75fda725c1a514f5723ea19caf8f3fae64dc7c0576b1d3eb17a43d54cc439191
SHA-256 (4.x): bc1e1f62e1da1ca9e5bb1f7c83b59e34804508d2cebc3aa46b5125856c4b65b9
Güncellendi · UTOPAY entegrasyon ekibi