𝗦𝘁𝗿𝗶𝗽𝗲 𝗪𝗲𝗯𝗵𝗼𝗼𝗸 𝗧𝗲𝘀𝘁𝗶𝗻𝗴: 𝗟𝗼𝗰𝗮𝗹 𝗗𝗲𝘃𝗲𝗹𝗼𝗽𝗺𝗲𝗻𝘁 𝗚𝘂𝗶𝗱𝗲 -> Stripe Webhook Test Etme: Yerel Geliştirme Rehberi

Stripe webhook'ları uygulamanızı ödemeler ve abonelikler hakkında bilgilendirir. Kaçırılan bir webhook, başarısız siparişlere neden olur. Test yapmak eskiden zordu. Artık Stripe CLI ile çok kolay.

Önce CLI'ı kurun.

  • macOS: brew install stripe/stripe-cli/stripe
  • Windows: scoop install stripe
  • Linux: Releases sayfasını kullanın.

Hesabınızı bu komutla bağlayın: stripe login

Olayları sunucunuza iletmek için dinleyiciyi başlatın: stripe listen --forward-to localhost:3000/webhooks/stripe

Çıktıdan imzalama sırrını (signing secret) kaydedin. Bunu ortam değişkeninize ayarlayın: export STRIPE_WEBHOOK_SECRET=whsec_abc123

Para harcamadan olayları test edin. Tetikleyicileri (triggers) kullanın.

  • Ödeme başarılı: stripe trigger payment_intent.succeeded
  • Ödeme başarısız: stripe trigger payment_intent.payment_failed
  • Yeni abonelik: stripe trigger customer.subscription.created

Sahte istekleri durdurmak için imzaları doğrulayın. Ham istek gövdesini (raw request body) kullanın. JSON ayrıştırıcılar (parsers) doğrulamayı bozar. Express'te express.raw() kullanın.

Yaygın hataları çözün.

  • 400 yanıtı, imza doğrulamasının başarısız olduğu anlamına gelir.
  • CLI sırrınızı kontrol edin. Dashboard sırları burada çalışmaz.
  • Günlüklerinizi (logs) inceleyin.

Canlı ortam (Production) kontrol listesi.

  • HTTPS kullanın.
  • Production sırrını kullanın.
  • 30 saniyenin altında yanıt verin.
  • Yinelenen olayları (duplicate events) yönetin.

Kaynak: https://dev.to/digital_trubador/stripe-webhook-testing-local-development-guide-391