Bu modülü kullanmak için WooCommerce kurulu ve etkin olmalıdır. WooCommerce yoksa Payfoni ödeme yöntemi görünmez.
NE IŞE YARAR?
Müşteri WooCommerce checkout’ta Payfoni’yi seçer; kart bilgileri sitenizde tutulmaz. Ödeme Payfoni ortak ödeme (iframe)ekranında tamamlanır.
Origin whitelist zorunludur. Ayar ekranındaki adresi Payfoni panelinde Marketplace → Iframe Ödeme → İzin verilen origin’ler listesine yazmazsanız ödeme formu açılmaz. Örnek kurulumdaki adres http://localhost:8080 şeklindedir; kendi sitenizde kutuda görünen adresi kullanın.
Ödeme akışı
- Sipariş oluşturulur
- Embed session açılır → iframe
postMessage/return_urlile dönüş- Status API ile doğrulama
- Sipariş ödendi olarak tamamlanır
Iade: eklenti WooCommerce iade akışını Payfoni API üzerinden destekler.
Gerekli ayarlar
- API / Panel URL — örn.
https://magaza.payfoni.com.tr - API Key — Panel → Ayarlar
- API Secret — Panel → Ayarlar
Debug
Ayarlardan debug log’u açın; loglar WooCommerce → Durum → Loglar altında kaynak payfoni ile görünür.
İlgili API
Eklenti arka planda Iframe & Ortak Ödeme oturumlarını kullanır. Ham API entegrasyonu için sol menüden o bölüme bakın.
1- Kurulum
WordPress paneline girin. Sol menüde Eklentiler üzerine gelin ve Eklenti ekleye tıklayın.
2- Eklenti yükle sekmesi
Eklenti ekle sayfasında üstteki Eklenti yükle sekmesine geçin.
3-Zip dosyasını seçin
Dosya Seç ile indirdiğiniz woocommerce-payfoni.zip dosyasını seçin, ardından Şimdi kura basın.
4-Eklentiyi etkinleştirin
“Eklenti kuruldu” yazısını görünce Eklentiyi etkinleştire tıklayın.
5-WooCommerce şart
Listede Payfoni SanalPos Entegrasyonu etkin görünür. Bu modülün çalışması için WooCommerce de kurulu ve etkin olmalıdır. WooCommerce yoksa ödeme yöntemi çıkmaz.
7-Ödeme yöntemini açın
WooCommerce → Ayarlar → Ödemeler ekranında Payfoni’yi etkinleştirin ve Yönete tıklayın.
7-API bilgileri ve origin
API / Panel URL, API Key ve API Secret alanlarını doldurun. Alttaki Origin whitelist kutusunda sitenizin adresi yazar. Örnek kurulumda bu adres http://localhost:8080 şeklindedir; canlı sitede kendi adresiniz görünür. Bu adresi aynen Payfoni panel → Marketplace → Iframe Ödeme → İzin verilen origin’ler listesine ekleyin. Eklenmezse ödeme formu açılmaz.
