Ödeme tamamlandığı hâlde webhook bildirimi dakikalar sonra mı geliyor? Gecikenin sağlayıcının gönderimi mi, sunucunun kabulü mü yoksa mağazanın arka plan işlemesi mi olduğunu 8 sistematik kontrolle ayırın.
Ödeme webhook bildirimleri gecikiyorsa önce “gecikme” kelimesinin hangi zamanı anlattığını belirleyin. Ödeme olayının oluşması, sağlayıcının POST isteğini göndermesi, sunucunun yanıt vermesi ve sipariş/ERP kaydının tamamlanması ayrı işlemlerdir. Tek bir “ödeme başarılı” ekranına bakarak gecikmenin kaynağı bulunamaz. sanal POS çalışma mantığı ile çalışan işletmelerde bu ayrım satış operasyonu ve müşteri güveni için önemlidir.
Bu makale, ödeme alınmasına rağmen hiç sipariş oluşmaması problemine değil, webhook olayının teslim/işleme zamanlamasının bozulmasına odaklanır. Sipariş kaydının tümüyle eksik olduğu senaryolarda ayrıca kontrol edilmesi gerekenler vardır. Bir olayın tekrar gönderilmesi, ödeme sağlayıcısının yanıtı alamamasından kaynaklanabilir; iki bildirimin gelmesi iki tahsilat olduğu anlamına gelmez.
Sağlayıcı ilk gönderim denemesini geç başlatıyorsa sağlayıcı olay/zamanlama tarafına bakın. İlk deneme zamanında fakat HTTP 4xx/5xx, bağlantı hatası veya timeout varsa teslim tarafını inceleyin. Sağlayıcı 2xx görürken sipariş geç güncelleniyorsa uygulama kuyruğu ve işleyiciyi kontrol edin.
Önce hangi aşamada gecikme var, bunu bulun
Gecikmeyi sağlayıcı panelindeki tek bir “teslim edildi” etiketine bağlamayın. Ödeme işleminin gerçekten ne zaman tamamlandığını, olayın ne zaman üretildiğini, ilk HTTP teslim denemesinin ne zaman yapıldığını ve işletme yazılımının ne zaman işlediğini birbirinden ayırın.
| Zaman noktası | Ne anlatır? | Nasıl kontrol edilir? |
|---|---|---|
| Ödeme tamamlanma zamanı | Provizyon/tahsilat/ödeme yöntemi sonucu | Ödeme işlem geçmişi |
| Event created_at | Webhook olayının sağlayıcıda üretildiği an | Sağlayıcı event günlüğü |
| First attempt / accepted_at | İlk POST ve HTTP yanıt zamanı | Webhook deneme geçmişi, sunucu access log |
| processed_at | Sipariş, ERP veya fatura etkisinin tamamlandığı an | Uygulama iş kuyruğu, veritabanı ve ERP kayıtları |
Örneğin olay 14:00:10’da oluşturulup 14:00:12’de sunucuya geliyorsa fakat sipariş 14:07’de güncelleniyorsa ilk bakılacak yer sağlayıcının teslim süresi değildir. Kuyruk/worker sistemi sorgulanmalıdır. Bu, e-ticaret operasyonlarının yönetimi içinde en kritik hata ayıklama ayrımlarından biridir.
Webhook olayı sağlayıcıda henüz oluşmamış veya normal bildirim zamanlaması yanlış yorumlanıyor
Belirti ve olası teknik neden
Ödeme panelinde işlem tamamlandığı hâlde webhook günlüğünde olay görünmüyor. Bunun gerçek gecikme mi, yanlış beklenen olay mı yoksa henüz tamamlanmamış ödeme mi olduğu belirsiz.
Sağlayıcıların ödeme sonucu ile bildirim olayı aynı zaman noktasında oluşmayabilir. 3D Secure, provizyon/capture, banka yanıtı ve alternatif ödeme yöntemlerinde farklı olaylar meydana gelir. iyzico, standart webhook bildiriminde ilk isteği ilk ödeme girişiminden yaklaşık 10–15 saniye sonra gönderebildiğini belirtiyor; bunu tüm sağlayıcılar için SLA kabul etmek yanlıştır.
Nasıl doğrulanır?
- Sağlayıcı panelinden işlemin ödeme girişimi, provizyon, tahsilat veya iade aşamasında olduğunu bulun.
- Beklenen event type değerini (ör. payment success, capture veya failed) işlem türüne göre doğrulayın.
- Sağlayıcının olay oluşturma saati ile ilk gönderim denemesi zamanını farklı sütunlarda karşılaştırın.
Bir ödeme olayı oluşmadan “webhook gecikti” alarmı üretmeyin. Olay oluştuysa gönderim zamanını; hiç oluşmadıysa ödeme durumunu ve etkin olay aboneliklerini inceleyin. Sağlayıcının belgelediği deneme ritmini baz alarak alarm eşiği oluşturun.
Güvenli test
Aynı entegrasyonun test ortamında beklenen ödeme durumunu oluşturun ve ilgili event type için ilk deneme kaydını izleyin.
Müşterinin tarayıcıda başarı sayfası görmesini ödeme sağlayıcısının resmi tahsilat teyidi yerine kullanmayın.
Webhook endpoint’i yanlış, erişilemez veya eski ortama bağlı
Belirti ve olası teknik neden
Sağlayıcı bildirimi göndermeye çalışıyor ama mağaza erişim günlüklerinde hiç istek yok; gönderim denemelerinde DNS, bağlantı veya TLS hatası var.
Eski alan adı, yanlış alt alan adı, taşınmış API yolu, canlı/sandbox karışıklığı ya da SSL sertifikası problemi isteği uygulamaya varmadan durdurabilir. HTTP yönlendirmeleri de bazı bildirim sağlayıcılarında başarısız teslimat olarak işaretlenebilir.
Nasıl doğrulanır?
- Sağlayıcı hesabındaki bildirim URL’sini karakter karakter canlı endpoint ile karşılaştırın.
- HTTPS sertifika zinciri, DNS A/AAAA kayıtları, TLS ve geçersiz yönlendirmeleri kontrol edin.
- Canlı ve test ortamlarında ayrı endpoint ve ayrı kimlik bilgileri kullanıldığını doğrulayın.
Kesintisiz, doğrudan erişilen HTTPS webhook uç noktası sağlayın. İstekleri oturum açma sayfasına ya da önbellekli bir WordPress sayfasına göndermeyin. Endpoint değiştiğinde sağlayıcı panelini ve dağıtım süreçlerini eşzamanlı güncelleyin.
Güvenli test
Sağlayıcının test webhook aracını kullanın; normal tarayıcı GET isteğini başarılı webhook POST testiyle eşdeğer saymayın.
Hatalı endpointi düzeltmeden başarısız olayları körlemesine yeniden göndererek çift işleme riskini büyütmeyin.
Ödeme sayfası bizzat yüklenmiyorsa WooCommerce ödeme sayfası sorunları rehberi, kullanıcının tarayıcısındaki ayrı sorunu teşhis eder.
Sunucu HTTP yanıtı yanlış biçimde veya çok geç döndürülüyor
Belirti ve olası teknik neden
Uygulama logunda bildirim var; sağlayıcı panelinde “timeout”, “failed” ya da yeniden deneme işareti görülüyor.
İstek gelir gelmez fatura üretmek, ERP aktarımı yapmak veya e-posta göndermek HTTP yanıtını geciktirir. 5xx, beklenmedik 3xx, 401/403 veya yanlış gövde de teslimatı başarısız gösterebilir. Adyen genel webhook kabulünde 10 saniyelik sınır açıklar; PayTR ilgili bildirim URL’sinde düz metin yalnızca OK yanıtını ister.
Nasıl doğrulanır?
- Sağlayıcı panelinde her denemenin HTTP durum kodunu, yanıt gövdesini ve süresini görün.
- Ağ erişimi, uygulama başlatma, imza doğrulama ve veritabanı kaydetme sürelerini ayrı kaydedin.
- Yanıt sözleşmesini sağlayıcı ve ödeme yöntemi bazında doğrulayın; PayTR’nin OK kuralını Stripe’a genellemeyin.
Olayı doğrulanabilir biçimde güvenli bir kuyruğa/alım kaydına aktardıktan sonra, sağlayıcının beklediği doğru yanıtı hızlı döndürün. Uzun raporlama ve ERP işlerini arka planda işleyin; kayıt yapılamadıysa sahte başarı yanıtı vermeyin.
Güvenli test
Yapay ağ gecikmesi ve yavaş veritabanı senaryosunda sağlayıcının teslim denemeleri ve endpoint yanıt sürelerini izleyin.
HTTP 200 tek başına işletme siparişinin tamamlandığını kanıtlamaz; teslim alma ve işleme başarılarını ayrı ölçün.
WAF, CDN veya IP güvenliği bildirimleri kuyrukta bırakıyor
Belirti ve olası teknik neden
İsteklerin bir bölümü uygulamaya ulaşırken bazıları 403/429 ile geri dönüyor; hata yoğun saatlerde artıyor.
Bot koruması, coğrafi engel, rate limit, CAPTCHA, CDN caching ya da sunucu güvenlik yazılımı makineden makineye POST isteklerini engelleyebilir. Sağlayıcı yeniden denemeye geçer ve görünen gecikme büyür.
Nasıl doğrulanır?
- WAF güvenlik olaylarında endpoint yolu ve işlem saatine göre 403/429 kayıtlarını filtreleyin.
- CDN’nin webhook yolunda cache, challenge veya otomatik yeniden yönlendirme yapmadığını doğrulayın.
- Sağlayıcının doğrulama yaklaşımıyla uyumlu dar kapsamlı güvenlik istisnası inceleyin.
Tüm güvenliği kapatmak yerine yalnız webhook yoluna ve sağlayıcı tarafından belgelenen kriterlere uygun, denetlenebilir istisnalar oluşturun. İmza/hash doğrulamasını muhafaza edin. Rate limit için güvenli olay saklama veya kontrollü kapasite ayırın.
Güvenli test
Test eventleri farklı saatlerde gönderin; WAF olay kaydı, reverse proxy ve uygulama günlüklerini tek zaman çizelgesinde eşleştirin.
Sırf webhook gelsin diye herkese açık bir URL üzerinde imza doğrulamasını kaldırmayın.
İmza doğrulaması veya yanlış kimlik bilgisi nedeniyle olaylar reddediliyor
Belirti ve olası teknik neden
Sunucu istek alıyor ama 400/401 yanıtlıyor; webhook sisteminde tekrar denemeler artıyor.
Yanlış secret, test/canlı anahtar karışıklığı, payload’ın doğrulamadan önce değiştirilmesi, imza başlığı sürüm farkı veya saat damgası toleransı hatalı doğrulamaya yol açabilir. iyzico belgelerinde X-IYZ-SIGNATURE-V3 desteğine geçiş bilgisi yer alıyor.
Nasıl doğrulanır?
- İmza başlığını ve sağlayıcı dokümanındaki güncel algoritmayı kontrol edin.
- İmza hesabında ham istek gövdesinin kullanılması gerekip gerekmediğini doğrulayın.
- Secret rotasyonu, webhook yapılandırması ve canlı/test ortamı eşlemesini gözden geçirin.
Sağlayıcıya özel doğrulama kütüphanesi veya referans algoritma kullanın. JSON’u yeniden biçimlendirdikten sonra imza kontrolü yapmaktan kaçının. Yetkisiz mesajı işleme almayın; hatayı kayıt altında tutun ve meşru olayları güvenli biçimde yeniden denetin.
Güvenli test
Geçerli ve bilerek bozulmuş imzalı iki ayrı test olayı ile beklenen kabul/ret davranışlarını ölçün.
İmza anahtarlarını makale, ekran görüntüsü, hata sayfası veya açık günlüklerde yayımlamayın.
Sağlayıcının tekrar deneme kuyruğu önceki hatalı olay yüzünden birikiyor
Belirti ve olası teknik neden
Düzeltme yapılmasına rağmen yeni bildirimler beklemeye devam ediyor veya olaylar toplu hâlde daha sonra geliyor.
İlk teslimat başarısız olduğunda sağlayıcı kendi tekrar deneme aralığını ve kuyruğunu kullanır. Adyen’de bir endpoint’in başarısız olması yeni olayların da retry queue’ya girmesine yol açabilir. iyzico da 2xx alınamadığında belirli aralıklarla yeniden gönderim yapar; bu aralıklar sağlayıcıdan sağlayıcıya değişir.
Nasıl doğrulanır?
- Başarısız ilk olayın zamanını, son denemeyi ve birikmiş olay sayısını belirleyin.
- Yeni olaylar ile eski olayların gönderim sırasını ve retry politikasını karşılaştırın.
- Sağlayıcının yeniden dene, başarısız olayları görüntüle ve hata alarmı ekranlarını kullanın.
Önce kök HTTP/erişim sorununu giderin; ardından sağlayıcı tarafından desteklenen yeniden gönderim ya da kontrollü uzlaştırma adımlarını uygulayın. Eski olayları manuel işlerken daha önce tamamlanmış siparişleri tekrar etkilemediğini doğrulayın.
Güvenli test
Bir test bildirimini geçici olarak başarısız bırakıp düzeltme sonrası nasıl yeniden teslim edildiğini sandbox ortamında izleyin.
Kuyruğu temizlemek için “yok say/ignore” seçeneğini kullanmak, bildirimin işlenmeden kaybolmasına yol açabilir.
Webhook hızlı alınıyor ancak kuyruk, worker veya veritabanı işleme gecikiyor
Belirti ve olası teknik neden
Sağlayıcı panelinde 2xx ve başarılı teslimat görülüyor; müşterinin siparişi, aboneliği veya faturası dakikalar sonra güncelleniyor.
Burada geciken webhook’un gönderilmesi değil, işletme uygulamasındaki tüketilmesidir. Duran worker, yoğun mesaj kuyruğu, veritabanı kilidi, cron aralığı, düşük işlem kapasitesi veya ERP servis yanıtı gecikmesi olayı bekletebilir.
Nasıl doğrulanır?
- received_at, accepted_at, queued_at, processed_at zamanlarını aynı event ID için karşılaştırın.
- Başarısız işler, dead-letter queue, worker yeniden başlama ve job retry günlüklerini inceleyin.
- Sipariş/fatura/ERP güncellemesinin hangi arka plan işiyle gerçekleştiğini bulun.
Kuyruk derinliğini ve en eski işin bekleme yaşını izleyin. İşleri idempotent tasarlayın, işleme hatalarını görünür kılın ve ayrı retry politikası kurun. Ölçekleme kararı almadan önce yavaş sorgu ve üçüncü taraf ERP çağrılarını ölçün.
Güvenli test
Sağlayıcıdan başarılı teslimat gelen bir test eventinde sipariş durumuna yansıma zamanını ölçün.
Sağlayıcı “delivered” gösteriyorsa doğrudan sağlayıcıyı suçlamak yerine uygulama işleme gecikmesini araştırın.
Webhook sonrası süreçte sipariş e-postasının gönderilmemesi ve sipariş sonrası stok güncellemesi sorunları ayrı iş akışlarıdır; yalnız HTTP 2xx almak bu adımların tamamlandığını kanıtlamaz.
Olay sırası, yinelenen bildirim ve saat damgası yorumu yanlış gecikme oluşturuyor
Belirti ve olası teknik neden
İlk gelen bildirim daha yeni işlemle ilgili, eski durum sonra güncelleniyor veya dashboard saatleri birbiriyle uyuşmuyor.
Webhook’lar farklı türde olaylardan oluşabilir ve bazı sağlayıcılar olay sırasını garanti etmez. Ağ ve retry nedeniyle aynı event birden fazla teslim edilebilir. Sunucunun UTC, panelin Türkiye saati göstermesi üç saatlik sahte gecikme algısı yaratabilir.
Nasıl doğrulanır?
- Olay oluşturulma, ilk teslim, son deneme ve yerel işleme saatlerini hepsini UTC bazında karşılaştırın.
- Tekil event ID ile ödeme/order ID alanlarını ayırın; aynı işlemin birden çok türde olayını listeleyin.
- Daha eski durumun yeni durumu geriye almaması için durum geçiş kurallarını inceleyin.
Her event ID için idempotency, ödeme referansı için tekil uzlaştırma ve geriye gitmeyen durum geçişi uygulayın. Zamanı UTC saklayıp yönetim panelinde Europe/Istanbul olarak gösterin. Ölçümde median, p95 ve başarısız deneme oranını ayrı raporlayın.
Güvenli test
Tekrar gönderilen olayın sipariş/stoğu ikinci kez değiştirmediğini ve geç gelen eski olayın ödeme durumunu bozmadığını doğrulayın.
UTC ve Türkiye saatlerini dönüştürmeden iki ayrı paneldeki görünen saati doğrudan çıkarmayın.
Webhook teslimi ile ödeme sağlayıcısının GA4 kaynak raporuna etkisi gibi analitik kaynak raporlaması birbirine karıştırılmamalıdır.
PayTR, iyzico, Stripe ve Adyen: hangi davranışa bakılmalı?
Sağlayıcıların bildirim yanıtı, yeniden deneme ve hata görüntüleme sistemleri aynı değildir. Aşağıdaki tablo tek bir evrensel zaman sınırı yerine, resmî belgelerde belirtilen farkları özetler. Entegrasyon türü ve kullanılan API sürümü mutlaka ayrıca doğrulanmalıdır.
| Sağlayıcı | Önemli resmî davranış | Teşhis başlangıcı |
|---|---|---|
| PayTR | İlgili Bildirim URL servislerinde yanıt gövdesi yalnız OK olmalı; uygunsuz yanıt tekrar bildirime yol açabilir. | Bildirim URL, hash kontrolü, düz metin OK ve merchant_oid |
| iyzico | Belgesinde ilk webhook yaklaşık 10–15 saniye; 2xx gelmezse belgelenen tekrar denemeler. | Event time, X-IYZ-SIGNATURE-V3 ve 2xx kaydı |
| Stripe | Başarısız webhook teslimlerinde yeniden deneme ve deneme geçmişi görünümü. | Event ve failed attempts, timeout, 3xx/4xx/5xx |
| Adyen | Zamanında başarılı HTTP kabul yoksa retry queue; webhook endpoint’leri ayrı izlenir. | Troubleshoot ekranı, endpoint yanıt süresi ve birikmiş olaylar |
PayTR bildirim sözleşmesi ve ödeme altyapısı seçimi için iyzico ve PayTR karşılaştırması rehberini karşılaştırma amacıyla kullanabilirsiniz; ancak çözümü mutlaka kullandığınız sağlayıcının resmî entegrasyon belgesine göre uygulayın.
Webhook gecikmesi nasıl ölçülür? Dört ayrı metrik
Gecikmeye tek bir rakam atamak yanıltıcı olabilir. Olayın ne zaman oluşturulduğu ile hangi sistemde kullanıldığı ayrı gözlemlenmelidir. Bir işletmede saniyelik teslim iyi olabilir fakat ERP işleme süresi dakikaları bulabilir. Ölçümde saat damgalarını UTC olarak normalleştirmek, Türkiye saatinde görüntülemek yeterlidir.
| Metrik | Hesaplama | Yanıt verdiği soru |
|---|---|---|
| Olay üretim süresi | event_created_at − payment_completed_at | Sağlayıcı olayı ne kadar sonra oluşturdu? |
| İlk teslim beklemesi | first_attempt_at − event_created_at | Sağlayıcı ilk denemeyi ne zaman başlattı? |
| Teslimat gecikmesi | accepted_at − first_attempt_at | Retry ve HTTP hataları ne kadar bekletti? |
| İşleme gecikmesi | processed_at − accepted_at | Mağaza/ERP olayı ne kadar sürede sonuçlandırdı? |
Buradaki farkların hepsi aynı saat standardında ölçülmelidir. 95. yüzdelik gecikme (p95) ile ortalamayı birlikte izlemek, birkaç uzun kuyruk olayının müşteriye etkisini görmeye yardımcı olur. İşlemin başarılı olması ve dönüşüm optimizasyonu çalışmasının dönüşüme katkısı için gerçek sipariş onay zamanını da ayrıca raporlayın.
Olay UTC 11:00:15, uygulama Europe/Istanbul saatinde 14:00:17 gösteriyorsa iki kayıt arasında 3 saat 2 saniye değil yalnızca 2 saniye vardır. İki saat damgasını aynı zaman dilimine çevirmeden alarm üretmeyin.
Gerçek operasyonlarda karşılaşılan dört senaryo
Olay geldi; sistemde sipariş 12 dakika sonra güncellendi
Sağlayıcı panelinde 2xx var. Uygulama iş kuyruğunda bekleyen işler ve başarısız ERP çağrılarını inceleyin. Webhook teslimatı başarılı olabilir; işleyici gecikmiştir.
PayTR “Devam Ediyor” gösteriyor
Bildirim URL’sinde yalnız OK yanıtı, hash doğrulaması ve HTTP erişimini kontrol edin. Aynı merchant_oid için tekrar gelen bildirimi yeni tahsilat olarak işlemeyin.
İyzico webhook yaklaşık 15 saniyede geldi
Bu tek başına gecikme hatası göstermez; sağlayıcının belgelenen ilk bildirim zamanlamasıyla uyumludur. Asıl farkı accepted_at ve processed_at ile ölçün.
Stripe eski olayları yeniden denedikten sonra siparişler toplu güncellendi
Başarısız teslim denemelerindeki timeout/4xx/5xx nedenini çözün, olay ID tekilleştirmesini doğrulayın, eski bildirimlerin güncel ödeme durumunu geriye taşımadığını sınayın.
Bildirimin geç gelmesi ile sonrasında müşteriye otomatik bilgilendirme mesajının gitmemesi farklı kök nedenlere sahip olabilir. CRM eşleştirme ve sipariş durumu takibini küçük işletmeler için CRM gibi ayrı kayıtların performansından bağımsız değerlendirin.
9 adımda güvenli çözüm ve doğrulama planı
Canlı müşteri ödemelerini art arda tekrar oluşturmak yerine test ortamını ve mevcut olay geçmişini kullanın. Ödeme durumu konusunda belirsizlik varsa müşteriden ikinci kez ödeme istemeden önce sağlayıcıda işlem referansıyla uzlaştırma yapın.
- Sorunlu bir ödeme için kişisel veri paylaşmadan işlem ID, olay ID ve dört zaman damgasını çıkarın.
- Ödemenin provizyon mu kesinleşmiş tahsilat mı olduğunu sağlayıcı panelinden teyit edin.
- Event type ve olayın gerçekten oluşturulup oluşturulmadığını kontrol edin.
- Sağlayıcının ilk HTTP gönderimi, yanıt kodu, yanıt gövdesi ve retry sayısını kaydedin.
- DNS, TLS, URL ve CDN/WAF üzerinden erişim sorunlarını giderin.
- Yanıt sözleşmesini sağlayıcı bazında doğrulayın: PayTR OK gereksinimi ile genel 2xx gereksinimini karıştırmayın.
- Webhook imza/hash doğrulamasını koruyarak alım kaydı ve kuyruk işlemeyi ayırın.
- Aynı olayın tekrar gönderilmesini test edin; çift sipariş/çift tahsilat tetiklenmediğini doğrulayın.
- Son olarak sandbox testleri, log karşılaştırması ve alarmlarla ilk teslim/işleme gecikmesini ayrı izleyin.
Sorun çözüldüğünde Zeymedya Reklam Ajansı tarafından hazırlanan ilgili dijital süreç rehberlerindeki temel ilke geçerlidir: müşteri tıklaması, ödeme onayı, sipariş kaydı ve teslimat birbirinden ayrı izlenmelidir.
18 maddelik son kontrol listesi
- ☐ Ödeme işlem türü ve kesin durum doğrulandı.
- ☐ Sağlayıcı event ID ve işlem referansı kaydedildi.
- ☐ Ödeme anı ile event oluşma zamanı ayrıldı.
- ☐ İlk HTTP gönderimi ve son deneme zamanı karşılaştırıldı.
- ☐ Endpoint URL canlı/test ortamıyla eşleşiyor.
- ☐ DNS/TLS ve HTTPS yönlendirmeleri denetlendi.
- ☐ CDN/WAF engel günlükleri kontrol edildi.
- ☐ HTTP status, response body ve timeout ölçüldü.
- ☐ Sağlayıcıya özel başarılı yanıt sözleşmesi uygulandı.
- ☐ İmza/hash doğrulaması kapatılmadan test edildi.
- ☐ Retry queue ve geçmiş başarısız olaylar incelendi.
- ☐ Event alım ve uygulama işleme zamanları ayrı kaydedildi.
- ☐ Worker/cron/queue gecikmesi ölçüldü.
- ☐ Olay ID ile ödeme referansı birbirinden ayrıldı.
- ☐ Aynı olayın yeniden teslimi idempotent işlendi.
- ☐ Eski olayın yeni ödeme durumunu bozması engellendi.
- ☐ Tüm zaman damgaları UTC standardına dönüştürüldü.
- ☐ Sandbox uçtan uca test ve alarm eşikleri doğrulandı.
Ödeme teslimatı istikrarlı hâle geldiğinde e-ticaret sitesi kullanıcı deneyimini ve WooCommerce ödeme seçenekleri gibi ödeme seçenekleriyle ilgili başka problemleri ayrıca değerlendirmek gerekir.
Webhook gecikmesi hakkında sık sorulan sorular
Webhook neden dakikalar sonra geliyor?
İlk olayın oluşma zamanı, ilk teslim denemesi, HTTP yanıtları ve sonrasında kuyrukta işlenme süresi incelenmeli. Retry veya arka plan işleyici gecikmesi olabilir.
Ödeme başarılı görünüyorsa webhook hemen gelmek zorunda mı?
Hayır. Sağlayıcılar farklı ödeme yöntemlerinde ve farklı zamanlamalarda event üretebilir. Sabit bir evrensel anlık teslim süresi varsayılmamalı.
iyzico webhook ilk kez kaç saniye sonra gönderilir?
iyzico resmî webhook belgesinde ilk bildirimin ödeme girişiminden yaklaşık 10–15 saniye sonra gönderilebileceğini açıklıyor.
PayTR callback için HTTP 200 yeterli mi?
İlgili PayTR Bildirim URL dokümanı düz metin yalnızca OK yanıtını şart koşuyor. Doğru yanıt sözleşmesini ödeme ürününüze göre kontrol edin.
Webhook tekrar gönderildiğinde iki kez sipariş oluşur mu?
Doğru tasarlanmış idempotent işleyicide oluşmamalı. Tekil olay ve ödeme referansları kontrol edilmelidir.
2xx dönüşü yapıldığı hâlde işlem neden geç güncelleniyor?
Webhook alımı başarılı olabilir, fakat iş kuyruğu, worker, veritabanı veya ERP işleminde gecikme yaşanabilir.
Webhook 403 hatası alıyorsa ne kontrol edilmeli?
Güvenlik duvarı, WAF, kimlik doğrulama gereksinimi, URL erişimi ve sağlayıcı imza kontrolü incelenmeli.
Webhook 429 ile dönüyorsa?
Rate limit ya da güvenlik katmanı sınırına takılıyor olabilir. Kontrollü kapasite ve endpoint istisnası değerlendirilmelidir.
Webhook olayları sıralı mı gelir?
Her sağlayıcı için garantili sıraya güvenilmemeli; aynı ödeme için geç gelen eski olaylar yeni durumu bozmamalı.
Türkiye saati yüzünden gecikme yanlış ölçülür mü?
Evet. UTC ile Europe/Istanbul farklı gösteriliyorsa saat damgalarını aynı zaman standardına çevirin.
Webhook imza kontrolünü geçici kapatabilir miyiz?
Güvenli değil. Hatanın nedeni doğru anahtar, ham gövde ve güncel imza başlığı kontrol edilerek çözülmelidir.
Stripe webhook teslimatı nereden izlenir?
Stripe Dashboard üzerinde webhook endpoint, failed events ve delivery attempt geçmişi incelenebilir.
Webhook görünmüyor ama sipariş oluşuyorsa hata var mı?
Uygulama ödeme API sonucuyla işlemeyi yapmış olabilir. Kullanılan entegrasyon tipinin akışını ve beklenen olayları doğrulayın.
Kuyrukta bekleyen eski olaylar nasıl işlenir?
Önce kök teslim hatası düzeltilir; sonra sağlayıcının desteklediği yeniden gönderim ve tekilleştirme mekanizmasıyla işlenir.
Resmî kaynaklar ve teknik belgeler
Aşağıdaki kaynaklar, kullanılan sağlayıcıya göre bildirimin ne zaman gönderildiğini, nasıl kabul edildiğini ve hangi durumda tekrarlandığını doğrulamak içindir. Güncel entegrasyon sözleşmesi her zaman kullanılan ürün ve API sürümü bazında kontrol edilmelidir.
- PayTR — Link API Callback, OK yanıtı ve tekrarlı bildirim
- iyzico — Webhook ve bildirim tekrarları
- Stripe — Webhook teslimat hatalarını giderme
- Adyen — Webhook hataları ve retry queue
- Adyen — Webhook kabul süresi ve HTTP yanıtı
Ödeme olaylarının doğru işlenmesi, Zeymedya Reklam Ajansı tarafından ele alınan müşteri kazanımı ve satış süreçlerinin güvenilir ölçülmesini de destekler. Genel satış ve ödeme dönüşüm analizlerinde dönüşüm optimizasyonu yaklaşımı uygulanabilir.



