WooCommerce
ödemehub for WooCommerce, WooCommerce mağazanızı kod yazmadan ödemehub'a bağlar. İstekleri eklenti imzalar, ödeme sonucunu siparişe kendisi işler. Önce deneyin: demo-wp.odemehub.com eklentinin kurulu olduğu demo mağazadır.
Gereksinimler
| WordPress | 6.9 ve üzeri |
| WooCommerce | 10.0 ve üzeri; klasik ödeme sayfası ve Sepet / Ödeme blokları desteklenir |
| PHP | 8.1 ve üzeri |
| Mağaza para birimi | TRY, USD, EUR ya da GBP; başka para biriminde ödeme yöntemi gösterilmez |
Kurulum
- Panelde Entegrasyon sayfasını açın; Hazır altyapılar bölümünde WordPress (WooCommerce) kartındaki Eklentiyi indir ile
odemehub-for-woocommerce.zipdosyasını indirin. - WordPress yönetim panelinde Eklentiler → Yeni Ekle → Eklenti Yükle ile zip dosyasını yükleyin ve eklentiyi etkinleştirin. WooCommerce etkin olmalıdır.
- WooCommerce → Ayarlar → Ödemeler → ödemehub sayfasını açın, ödemehub'ı etkinleştirin ve aşağıdaki alanları doldurun.
- Kaydedin. Bilgiler doğruysa sayfada ödemehub'a bağlanıldı. yazar.
- Aynı sayfada gösterilen webhook adresini panelde Ödeme Ayarları → Webhook sayfasına ekleyin (Webhook).
Ayarlar
| Alan | Ne girilir |
|---|---|
| Ödeme modu | Hosted Checkout, Delegated Checkout (önerilen) ya da Payment API; bkz. Ödeme modları. |
| Ortam | Sandbox ya da Canlı. Varsayılan Sandbox. |
| Çalışma Alanı Kimliği | Seçilen ortamdaki hesabın Entegrasyon sayfasındaki 10 haneli sayı. |
| API Anahtarı | Aynı sayfadaki API anahtarı (key_...). |
| Gizli Anahtar | Aynı sayfadaki gizli anahtar (secret_...). Kaydedildikten sonra gösterilmez; boş bırakılırsa kayıtlı değer korunur. |
| Başlık, Açıklama | Müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı ve metni. |
Sandbox ve Canlı ayrı ödemehub hesaplarıdır (Ortamlar ve Adresler). Ortamı değiştirdiğinizde o hesabın kimliğini ve anahtarlarını girin. Mağazayı sandbox'ta kurup deneyin, canlıya geçerken ortamı Canlı yapıp app.odemehub.com hesabınızın bilgilerini girin.
Ödeme modları
| Mod | Ne olur | Panelde gereken |
|---|---|---|
| Hosted Checkout | Ödeme sürecinin tamamını ödemehub devralır; müşteri bilgilerini ve kartını ödemehub ödeme sayfasında girer. | Siparişler modülü |
| Delegated Checkout | Müşteri WooCommerce ödeme sayfasını doldurur, kartını ödemehub ödeme sayfasında girer. | Siparişler modülü |
| Payment API | Kart formu WooCommerce ödeme sayfasındadır; kart 3D Secure ile secure-payment üzerinden çekilir. Kart verisi mağaza sunucunuzdan geçer. | — |
Hosted ve Delegated Checkout create-order ile sipariş açar; modül kapalıysa gateway 403 döner (Hatalar).
Webhook
Müşteri ödedikten sonra mağazaya dönmese de siparişin tamamlanması için ayar sayfasındaki webhook adresini panelde Ödeme Ayarları → Webhook sayfasına ekleyin ve ödeme modunuzun olayını seçin:
| Mod | Olay |
|---|---|
| Hosted Checkout, Delegated Checkout | order.paid |
| Payment API | transaction.successful |
Eklenti bildirimin imzasını doğrular ve kararı retrieve-* yanıtına göre verir. Ayrıntılar: Webhook.
İade WooCommerce'ten yapılmaz. Ödemeyi panelden iade edin, siparişi WooCommerce'te kendiniz güncelleyin.