Stripe Checkout

Uluslararası kart ödemeleri için Stripe kurulumu ve webhook.

Gereken bilgiler

Stripe Dashboard → Developers → API keys:

  • publishable_key (pk_…)
  • secret_key (sk_…)

Sonra Developers → Webhooks → Add endpoint:

  • Endpoint URL: https://<panel-alan-adınız>/payments/stripe_checkout/callback
  • Dinlenecek olay: checkout.session.completed

Oluşan Signing secret değerini (whsec_…) webhook_secret alanına girin.

Panelinizde Ayarlar → Ödemeler → Yöntem ekle → Stripe Checkout seçip üç değeri kaydedin.

Akış

  1. Müşteri tutarı girer, Stripe'ı seçer.
  2. Stripe'ın barındırdığı ödeme sayfasına yönlendirilir.
  3. Ödeme tamamlanınca müşteri panele döner; bakiye webhook geldiğinde yüklenir. Dönüş sayfası ödemeyi tamamlamaz, webhook olmadan bakiye yüklenmez.
  4. Aynı oturum için gelen ikinci bildirim yok sayılır.

Sık sorunlar

  • Bakiye yüklenmiyor: webhook endpoint'i yanlış alan adında ya da olay seçilmemiş. Stripe Dashboard → Webhooks'ta son teslimatların durumuna bakın; 200 dönmesi gerekir.
  • Test kartıyla deniyorum: test anahtarlarını (pk_test / sk_test) girin ve webhook'u test modunda oluşturun; canlı ve test webhook'ları ayrıdır.