Gelişmiş Bir Stripe Webhook Kurulumu Nasıl Yapılandırılır

Bu belge, çoğu site için gerekmeyen gelişmiş kurulum seçeneklerini içerir.
_{Temel kurulum için standart webhook belgelerimize bakın.}

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

Webhook Uç Noktası Ekleme

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.

Ş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:

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

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 Tablosu'nun webhook ayarlarından alın. Gizli anahtarını almak istediğiniz bir uç noktası seçin, ardından Göster düğmesine tıklayın.

Ardından Stripe Gösterge Tablosu'ndan imzalama gizli anahtarını kopyalayın, WP yöneticinizdeki Stripe Kurulumu sekmesine geri dönün ve mevcut ödeme modu için Uç Nokta Gizli Anahtarı metin kutusuna yapıştırın.

Webhook'larınız artık ayarlandı ve güvende.

Şu anda WP Simple Pay aşağıdaki olayları kullanmaktadır:

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 Abonelikten sonra ek işlem için simpay_webhook_subscription_created eylemini sunar.

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

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

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.

plan.updated

• Abonelik Seçenekleri yapılandırılırken Abonelik Planları listesinin güncel olduğundan emin olmak için kullanılır.

charge.failed

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