Stripe'dan Webhook Kabul Etmek İçin Sitenizi Nasıl Yapılandırırsınız

Webhook'lar, Stripe'ın WordPress sitenize mesaj göndermesini sağlar. WP Simple Pay'in bazı işlevleri için webhook kurulumu gereklidir; örneğin e-posta gönderme, taksit planları oluşturma, müşterilerin abonelik ödeme bilgilerini güncellemesine izin verme ve entegrasyonunu AffiliateWP ile kullanma.

WP Simple Pay, webhook uç noktalarını otomatik olarak oluşturmaya çalışır. Çoğu durumda aşağıda gösterildiği gibi manuel yapılandırma gerekli olmayacaktır.

Stripe'da Bir Uç Nokta Ekleyin

Uygun webhook uç noktalarını eklemek için Stripe Kontrol Paneli'nde Geliştiriciler → Webhook'lar bölümüne gidin.

Uç Nokta Ekle'ye tıklayın, ardından WP Simple Pay → Ayarlar → Stripe → Webhook'lar bölümünde bulunan URL'yi ekleyin.

WP Simple Pay webhook işlevselliğini bozacağından Bağlı hesaplarda olayları dinle seçeneğini etkinleştirmeyin.

Şimdi +Olayları seç düğmesine tıklayarak dinlenecek belirli olayları eklemeniz gerekecek. Bunu yaptıktan sonra, aşağıda listelenen her olayı Gönderilecek olayları seç → Olayları ara arama kutusuna kopyalayıp yapıştırabilirsiniz.

Her terimi aradıktan sonra, eklemek için onay kutusuna tıklayın ve ek terimleri arayın. Aşağıda listelenen tüm olayları işaretleyene kadar Olayları ekle'ye tıklamayın:

• payment_intent.processing
• payment_intent.succeeded
• charge.failed
• charge.refunded
• charge.succeeded
• checkout.session.completed
• customer.subscription.deleted
• customer.subscription.updated
• invoice.payment_succeeded
• invoice.upcoming

Bu olayların her birinin işlevselliği hakkındaki ayrıntılar bu belgenin altında gösterilmektedir.

Etkinlik eklemeyi bitirdiğinizde, işlemi tamamlamak için Uç Nokta Ekle düğmesine tıklayın. Uç noktayı ekledikten sonra, yeni URL'nin webhook ayarlarında listelendiğini görmelisiniz.

Webhook İmzalama Gizli Anahtarını Yapılandırma

Stripe, uç noktalarınıza gönderdiği webhook etkinliklerini ek güvenlik için imzalayabilir ve bunu ayarlamanızı şiddetle tavsiye ederiz.

Bunu yapmak için, uç noktanızın gizli anahtarını Gösterge Paneli webhook ayarlarınızdan alın. Gizli anahtarını almak istediğiniz eklenen uç noktayı seçin, ardından Göster düğmesine tıklayın.

Ardından Stripe Gösterge Paneli'nden imzalama gizli anahtarını kopyalayın, WordPress yöneticinizdeki WP Simple Pay → Ayarlar → Stripe → Webhook'lar bölümüne geri dönün, ardından mevcut ödeme modu için Uç Nokta Gizli Anahtarı metin kutusuna yapıştırın.

Test Modunda Tekrarlayın

Bir webhook uç noktası Test Modunda da oluşturulmalıdır. Stripe gösterge panelinin sağ üst köşesindeki Test modu geçişini değiştirin ve yukarıdaki adımları tekrarlayın.

Etkinlik Türü Açıklamaları

invoice.payment_succeeded

• Taksitli ödeme planlarını artırmak ve Abonelikler için “Ödeme Onayı” ve “Ödeme Bildirimi” e-postaları göndermek için kullanılır.
• Başarılı bir abonelik oluşturulduktan sonra ek işlem için simpay_webhook_subscription_created eylemini sunar.
• Bir fatura işlendikten sonra ek işlem için simpay_webhook_invoice_payment_succeeded eylemini sunar.

<?php
add_action(
	'simpay_webhook_subscription_created',
	/**
	 * Fires when a subscription is created in Stripe.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event        $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\Subscription $subscription Stripe Subscription.
	 */
	function( $event, $subscription ) {
		// Do something.
	},
	10,
	2
);

<?php
add_action(
	'simpay_webhook_invoice_payment_succeeded',
	/**
	 * Fires when a subscription invoice payment has succeeded.
	 * Does not fire for the subscription creation (first) invoice.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event        $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\Invoice      $invoice Stripe Invoice object.
	 * @param \SimplePay\Vendor\Stripe\Subscription $subscription Stripe Subscription object.
	 */
	function( $event, $invoice, $subscription ) {
		// Do something.
	},
	10,
	3
);

Özel kod eklemeyi öğrenin →

payment_intent.succeeded

• Tek seferlik ödemeler için “Ödeme Onayı” ve “Ödeme Bildirimi” e-postalarını gönderir.
• Başarılı ödemeden sonra ek işlem için simpay_webhook_payment_intent_succeeded eylemini sunar

<?php
add_action(
	'simpay_webhook_payment_intent_succeeded',
	/**
	 * Fires when a one-time payment has succeeded.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event         $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\PaymentIntent $paymentintent Stripe PaymentIntent.
	 */
	function( $event, $paymentintent ) {
		// Do something.
	},
	10,
	2
);

Özel kod eklemeyi öğrenin →

invoice.upcoming

• Bir Ödeme Yöntemini güncellemek için “Gelecek Fatura” e-posta hatırlatıcısını gönderir. Daha fazla bilgi edinin

checkout.session.completed

• Oluşturulan terk edilmiş Stripe Checkout kayıtlarını kaldırmak için kullanılır.
• Gerekirse ek işlem için simpay_webhook_checkout_session_completed eylemini sunar.

charge.succeeded

• ACH Debit kullanarak yapılan tek seferlik ödemeler için “Ödeme Onayı” ve “Ödeme Bildirimi” e-postalarını gönderir.
• Başarılı ödemeden sonra ek işlem için simpay_webhook_charge_succeeded eylemini sunar

charge.failed

• Bir Ödeme başarısız olduktan sonra ek işlem için simpay_webhook_charge_failed eylemini sunar.

Sıkça Sorulan Sorular

Webhook'lar gerekli mi?

Ödemeleri işlemek için webhook'lar gerekli değildir ve bir webhook başarısız olduğunda bu bir ödemenin işlenemediği anlamına gelmez. Ancak webhook'lar, dolandırıcılık tespiti, e-posta makbuzları, gelecek fatura bildirimleri ve taksitli ödeme planlarını yönetme gibi işlevleri desteklemek için kullanılır.

Dolandırıcılık tespit edildiğinde e-posta doğrulamasını kullanmak için webhook'lar gereklidir.

Bu özellikleri şu anda kullanmıyor olsanız bile, gelecekte bu özellikleri etkinleştirmeye karar vermeniz veya WP Simple Pay'in gelecekteki özellikler için bu işlevselliklere ihtiyaç duyması durumunda karışıklığı önlemek için webhook uç noktasını doğru şekilde yapılandırdığınızdan emin olmanız şiddetle tavsiye edilir.

Neden “WP Simple Pay doğru çalışmıyor olabilir.” mesajını görüyorum?

WP Simple Pay, webhook işlevselliğini kullanan özelliklerin (e-postalar, taksitli ödeme planları vb.) kesintiye uğramasını önlemek için olası webhook uç noktası yanlış yapılandırmasını veya hatasını size bildirmeye çalışır. WP Simple Pay beklenen bir webhook olayını doğrulayamazsa, eklenti ayarlarında bir bildirim balonu ve “WP Simple Pay doğru çalışmıyor olabilir.” hata mesajını görürsünüz.

Yanlış yapılandırılmış bir webhook uç noktasını nasıl düzeltirim?

Olası bir webhook uç noktası yanlış yapılandırmasını çözmek için Stripe kontrol panelinizdeki Geliştiriciler → Webhook'lar bölümünü ziyaret edin (Test Modundaysanız, test modu uç noktalarınızı görüntüleyin).

Barındırılan uç noktalar altında, WP Simple Pay webhook olay alıcısını içeren bir giriş görmelisiniz: wp-json/wpsp/v1/webhook-receiver. Bu uç noktayı görmüyorsanız, lütfen bu makalenin başında belirtilen yapılandırma adımlarını tamamlayın.

Uç noktanın yapılandırmasını görüntülemek için WP Simple Pay uç noktası URL'sine tıklayın. Burada uç noktaya gönderilen webhook olaylarının bir listesini bulacaksınız.

Başarısız olan olayları listelemek için Başarısız sekmesine tıklayın.

Başarısız webhook olaylarınız varsa, girişlerden birini seçmek, uç nokta URL'sinden alınan yanıtı ortaya çıkaracaktır. Bu yanıt genellikle Yanıt bölümünde uç noktanın olayı neden işleyemediğine dair bilgiler içerir.

Uzak ana bilgisayara bağlanılamadı

Stripe sunucunuzla iletişim kuramadı. Lütfen web sunucunuzun isteklere yanıt verdiğinden ve özellikle Stripe'ın tam nitelikli alan adlarına ve IP adreslerine yanıt verebildiğinden emin olun.

Beklenen yük imza ile eşleşen imza bulunamadı

Stripe, WP Simple Pay → Ayarlar → Stripe → Webhook'lar bölümünde sağlanan imzalama sırlarını kullanarak webhook olay verilerini doğrulayamadı. Webhook uç noktanızı görüntülerken, her ödeme modu için İmzalama Sırrı altında Göster'e tıklayın ve WP Simple Pay'deki imzalama sırrı ayarlarınızı güncelleyin.

404 HATA <!DOCTYPE html>

Webhook uç noktası URL'si yanlış ve 404 sayfa bulunamadı sayfasına yönlendiriyor. Webhook uç noktası URL'nizin doğru değerini bulmak ve Stripe'daki uç noktayı güncellemek için WP Simple Pay → Ayarlar → Stripe → Webhook'lar bölümünü ziyaret edin.

Uç nokta ayarlarımı doğruladım, neden hala bir hata görüyorum?

WP Simple Pay, gerçek bir hatanın fark edilmemesini sağlamak için olası yanlış yapılandırmalara karşı kasıtlı olarak aşırı duyarlıdır. Ancak, yanlış yapılandırılmış bir webhook olayı hakkında yanlış pozitif bildirimler almak hala mümkündür. Bu, Stripe olay verilerini göndermede ortalamadan daha uzun bir gecikme olduğunda veya bazı Stripe Checkout durumlarında, sitedışındaki ödeme sayfasından çıkıldığında meydana gelebilir.

Uç noktanızda başarısız webhook uç noktası olayı olmadığını doğruladıysanız, aşağıdaki adımları izleyerek yapılandırma bildirimini devre dışı bırakabilirsiniz.

Webhook yapılandırma bildirimlerini devre dışı bırakabilir miyim?

Daha önce de belirtildiği gibi, webhook uç noktanızı düzgün bir şekilde yapılandırmanız ve etkin tutmanız şiddetle tavsiye edilir. Ancak, kendi sorumluluğunuzda, olası yanlış yapılandırmalar veya yanlış alınan olaylar hakkında uyarılmak istemiyorsanız, bildirimi WP Simple Pay → Ayarlar → Stripe → Webhook'lar bölümünde Tekrar gösterme düğmesine tıklayarak kalıcı olarak kapatabilirsiniz.