Eklenti ne yapar
- UTOPAY — kart ve PayPal: kart, Apple Pay, Google Pay, PayPal, Revolut, banka havalesi. Alıcı UTOPAY sayfasında öder ve «Teşekkürler» sayfasına döner.
- UTOPAY — kripto: alıcı ödeme sayfasında coin seçer (BNB Chain, Ethereum, Polygon, Arbitrum, Base… üzerinde USDT ve USDC; ETH, BNB) ve tam tutarlı bir adres alır.
- Sipariş, eklenti ödemeyi API üzerinden yeniden okuyup tutar ve para birimi eşleştikten sonra ödendi olarak işaretlenir.
- Eksik ödenen kripto siparişi bir notla On hold durumuna geçer: para zaten cüzdanınızda, ne yapacağınıza siz karar verirsiniz.
- Ödenmeyen ödemeler 24 saat sonra sona erer; WooCommerce siparişi kendi stok rezerv süresine göre iptal eder.
Kurulum
- Yukarıdaki ZIP’i indirin. Açmayın.
- WordPress yönetimi → Plugins → Add New → Upload Plugin → dosyayı seçin → Install Now → Activate.
- UTOPAY panelinde Integration → API keys bölümünü açın ve test gizli anahtarı
utopay_sk_test_…oluşturun. - WooCommerce → Settings → Payments → UTOPAY — cards & PayPal → anahtarı yapıştırın → Enable kutusunu işaretleyin → Save. Anahtar kaydederken kontrol edilir.
- Kripto için: panelde cüzdanlarınızı Project settings → Funds & payouts, Crypto wallets bölümüne ekleyin (tek bir EVM adresi tüm EVM ağlarını kapsar), sonra UTOPAY — crypto yöntemini açın ve coinleri seçin.
Ayarlar
| Alan | Ne yapar |
|---|---|
| Secret key | Sandbox için utopay_sk_test_…, gerçek ödemeler için utopay_sk_live_…. İki yöntem için ortaktır. |
| Title / Description | Alıcının ödeme sayfasında gördüğü metin. |
| Payment method on the UTOPAY side | Boş: alıcı seçer. Ya da herkesi doğrudan tek bir yönteme yönlendirin (Stripe, PayPal, Revolut…); yöntem kullanılamıyorsa yöntem seçici gösterilir. |
| Coins | Yalnızca kripto yöntemi: ödeme sayfasında sunulan coinler. Yalnızca panelde cüzdanınız olan ağları açın. |
| Debug log | İstekleri ve bildirimleri WooCommerce → Status → Logs bölümüne, utopay kaynağıyla yazar. |
Test ödemesi
- Test anahtarıyla sipariş verin ve bir UTOPAY yöntemi seçin.
- UTOPAY sandbox’ı açılır. Ödemeyi simüle etmek için yeşil ✅ düğmesine basın.
- Bir buçuk saniye içinde «Teşekkürler» sayfasına dönersiniz; sipariş «UTOPAY payment ord_test_… received (test)» notuyla Processing olur.
- Kırmızı ❌ düğmesiyle tekrarlayın: sipariş Failed olur.
- Anahtarı
utopay_sk_live_…ile değiştirin. Hazır.
Siparişler nasıl onaylanır
Her ödeme kendi bildirim URL’siyle oluşturulur: https://siteniz/?wc-api=utopay&order_id=…&key=…. UTOPAY her durum değişikliğini oraya HMAC-SHA256 ile imzalayarak gönderir (anahtar gizli anahtarınızdan türetilir). Siteniz 2xx dönmezse UTOPAY 30 sn, 2 dk, 15 dk, 1 sa ve 6 sa sonra yeniden dener.
Eklenti bildirim gövdesine güvenmez: ödemeyi API’den ister ve siparişi yalnızca ödeme bu siparişe aitse, tutar ve para birimi eşleşiyorsa tamamlar. Alıcı «Teşekkürler» sayfasına döndüğünde aynı kontrol bir kez daha çalışır; böylece yerel ya da korumalı bir site bile siparişlerini onaylar.
Sorun giderme
- Yöntemler ödeme sayfasında görünmüyor: mağaza para birimi desteklenmiyor ya da anahtar boş. Desteklenenler: USD EUR GBP CAD AUD NZD CHF SEK NOK DKK PLN CZK HUF TRY UAH INR JPY SGD HKD AED MYR THB PHP IDR BRL MXN COP ZAR NGN.
- «Payment could not be started: amount is below the minimum»: sipariş toplamı seçilen yöntemin ya da coinin minimumunun altında; alıcı başka birini seçebilir.
- Sipariş «Pending payment» durumunda kalıyor: site internetten HTTP kimlik doğrulaması olmadan erişilebilir olmalı ve güvenlik eklentileri
/?wc-api=utopayadresine giden POST isteklerini engellememeli. Debug log’u açın vecallbacksatırlarını arayın. - «no evm wallet…»: coin eklentide açık ama panelde ağı için cüzdan yok.
Sürüm geçmişi
- 1.0.2 — ortak UTOPAY çekirdeği güncellendi, davranış değişmedi.
- 1.0.1 — white-label API alan adı desteği (UTOPAY_API_BASE sabiti); EVM ağlarında varsayılan coinler.
- 1.0.0 — ilk sürüm: kart ve PayPal, kripto, blok ödeme sayfası, HPOS, Rusça çeviri.
SHA-256: 8a3900be6f724ca8c467fa538aeaedb9c81a6789dd59840313767688e1ffcf1b
Güncellendi · UTOPAY entegrasyon ekibi