İçeriğe atlayın

Eklentiler

Bu sayfada

WooCommerce Eklentisi

WooCommerce için resmî Paymos eklentisini kurun, proje kimlik bilgilerini bağlayın, ödeme sayfasını test edin ve siparişleri imzalı webhook ile güncelleyin.

1. Gereksinimler

  • WordPress 6.2 veya üzeri
  • WooCommerce 8.0 veya üzeri
  • OpenSSL'li PHP 7.4 veya üzeri
  • Panelde seçili bir projesi olan Paymos hesabı

Paket, Paymos PHP SDK'sını kendisiyle birlikte getirir; mağazada Composer gerekmez.

2. Resmî sürümü kurun

En güncel paketi Paymos WooCommerce Releases sayfasından indirin, ardından WordPress Admin → Plugins → Add New → Upload Plugin üzerinden yükleyip etkinleştirin.

Resmî sürüm arşivleri her işyeri için aynıdır; API anahtarı, API secret'ı, proje ID'si, webhook secret'ı, erişim token'ı veya cihaz kodu içermez.

3. Mağazayı bağlayın

  1. Bu mağazanın faturalarını alacak projeyi Paymos panelinde açın. O an seçili proje otomatik olarak kullanılır.
  2. WooCommerce → Settings → Payments → Paymos yolunu açın.
  3. Connect Paymos'a tıklayın.
  4. Paymos sekmesindeki isteği onaylayın. Onay sayfası mağaza URL'sini ve o an seçili projeyi gösterir; ikinci bir proje seçici yoktur.
  5. WooCommerce'e dönün. Ayarlar sayfası bağlantıdan sonra yeniden yüklenir.

Sandbox ve Live için Paymos, işyerinin tek etkin Payment anahtarını yeniden kullanır; yoksa bir tane oluşturur. Webhook'u yalnızca tam callback URL'si, Invoice kategorisi ve mevcut proje eşleştiğinde yeniden kullanır; aksi halde özel bir Invoice webhook'u oluşturur. Aynı URL'deki çakışan bir webhook asla sessizce üzerine yazılmaz:

https://shop.example.com/wp-json/paymos/v1/webhook

OAuth cihaz token'ı kısa ömürlüdür ve atılır. Normal Merchant API çağrıları HMAC kimlik doğrulaması kullanmaya devam eder.

4. Kimlik bilgisi saklama

Sandbox ve Live kimlik bilgileri doğrulanır ve AES-256-GCM ile şifrelenmiş, autoload edilmeyen bir WordPress option'ında saklanır. Şifreleme anahtarı malzemesi, kurulumun WordPress güvenlik tuzlarından türetilir. Kaydedilen değerler asla tarayıcıya geri döndürülmez ve elle girilemez ya da düzenlenemez. Bir anahtar veya webhook secret'ı iptal edildiğinde ya da rotasyona alındığında mağazayı yeniden bağlayın.

5. Test ve canlıya geçiş

  1. Sandbox'ı seçin, Paymos'u etkinleştirin ve bir test siparişi verin.
  2. Faturanın seçili Paymos projesinde göründüğünü ve webhook'un siparişi güncellediğini doğrulayın.
  3. Hazır olduğunuzda Live'ı seçin. Aynı eklenti kurulumu, bağlanan Live kimlik bilgilerini kullanır.

Bir sipariş güncellenmiyorsa WooCommerce → Status → Logs bölümünü kontrol edin, sitenin dışarıdan erişilebilir olduğunu doğrulayın ve siparişin ortamının eklenti moduyla eşleştiğinden emin olun.

Webhook'ları test etme WHMCS Eklentisi