Bildirimi Göndereni Doğrulama
iyzico webhook, sunucular arasında ödeme veya ilgili işlem hakkında bilgi taşır. İstek gövdesinde başarı yazması tek başına kaynağın güvenilir olduğunu göstermez. Hesapta etkinleştirilen imza özelliğiyle gelen X-IYZ-SIGNATURE-V3 başlığı doğrulamanın bir parçasıdır.
AdPix’in önerisi bu bildirimi normal bir ziyaretçi isteği gibi işleyip siparişi doğrudan tamamlamamaktır. Önce imza, beklenen işlem ve mağaza kaydı arasındaki ilişki incelenir. Örneğin başka siparişe ait bir sonuç yanlış kayda uygulanmamalıdır. Kontrolün amacı sadece sahte mesajı reddetmek değil, gerçek mesajın da doğru işlem için kullanıldığını doğrulamaktır.
Bildirim Biçiminin Önemi
iyzico doğrudan ödeme, ödeme formu ve abonelik bildirimleri için farklı alan birleşimleri tanımlar. V3 doğrulamasında HMAC-SHA256 kullanılır; hangi alanların hangi sırayla işleneceği bildirim türünün güncel tanımına bağlıdır. Tek bir alan listesini bütün ürünlere uygulamak hatalı sonuç verebilir.
İncelemende önce alınan bildirimin hangi ödeme yönteminden geldiği belirlenir. Ardından uygulamadaki doğrulama o biçimle karşılaştırılır. Gizli anahtar, hata mesajına veya istemci tarafına taşınmaz. İmza uyuşmazlığını çözmek için doğrulamayı kapatmak yerine alan biçimi, ortam ve kullanılan hesap bilgileri kontrollü biçimde araştırılır.
iyzico Bildirim Adresi Ayarı
iyzico panelindeki örnek alan, olay bildirimlerinin gönderileceği adresin tanımlandığı yeri gösterir. Buraya adres yazmak gelen isteğin doğrulanmasını sağlamaz. İmza kontrolü ve tekrar gelen mesajların güvenli işlenmesi, bildirimi alan uygulamada ayrıca uygulanmalıdır.
Tekrar Gelen Mesajlar
Webhook teslimi tekrar edebilir; iyzico belgesinde başarılı HTTP yanıtı alınamayan iletiler için yeniden gönderim davranışı açıklanır. Aynı işlemin ikinci kez bildirilmesi yeni bir sipariş veya ikinci stok düşümü üretmemelidir. İşletmenin uygulaması tekrarları kendi kayıtları üzerinden tanımalıdır.
Örneğin ilk bildirim siparişi güncellediği hâlde yanıt karşı tarafa ulaşmamış olabilir. AdPix’in önerisi önce kalıcı işlem kaydı oluşturmak, ardından bildirimin tamamlandığını belirtmektir. Tekrar geldiğinde mevcut sonuç okunur. Bu yaklaşım, ikinci e-posta, ikinci fatura talebi veya gereksiz sevkiyat gibi yan etkilerin aynı ödeme nedeniyle çoğalmasını engellemeye yardımcı olur.
Belirsiz Sonuçta Ödeme Sorgusu
Bildirim kaydı ile mağaza siparişi arasında uyuşmazlık varsa iyzico ödeme sorgulama servisi mevcut işlemin ayrıntısını araştırmak için kullanılabilir. Sorgu yeni ödeme oluşturmaz. Hangi ödeme kimliğinin sorgulandığı ve sonucun hangi siparişe bağlandığı açık olmalıdır.
Örneğin uygulama yeniden başlarken bildirim işlenmiş fakat sipariş ekranı güncellenmemiş olabilir. Destek görevlisinin siparişi gelişigüzel tamamlandı yapması yerine işlem sonucu incelenir. Tutar, para birimi ve sipariş ilişkisi doğrulanır. Müşteriden yeniden ödeme istenmeden önce mevcut tahsilatın durumu belirlenir. Bu yaklaşım hem müşteri deneyimini hem operasyon kayıtlarının tutarlılığını korur.
İzlenebilir Hata Yönetimi
Webhook incelemesinde alınma zamanı, bildirim türü, ilgili işlem ve uygulamanın verdiği yanıt kaydedilir. Tam ödeme verisini herkesin erişebildiği loglara yazmak gerekli değildir. İşletme, hatayı araştırmaya yetecek sınırlı veriyi uygun erişimle saklamalıdır.
Kontrolde geçersiz imza, bilinmeyen işlem, yinelenen ileti ve geçici sunucu hatası ayrı senaryolar olarak denenir. İmzası doğrulanmış mesajın ticari içeriği de beklenen siparişle karşılaştırılır. İşlem tamamlanmadan verilen başarılı yanıtın sonraki takibi zorlaştırabileceği unutulmaz. Sağlıklı sonuç, bildirim geldiğinin görülmesiyle değil, doğru siparişin bir kez ve doğrulanmış bilgiyle güncellenmesiyle ölçülür.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- Webhook
- Webhook, bir sistemde sipariş oluşması ya da ödeme tamamlanması gibi bir olay gerçekleştiğinde olay bilgisini önceden kaydedilmiş bir adrese HTTP isteğiyle kendiliğinden gönderen bildirim yöntemidir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.