Hangi İşlem Başarısız Oldu?
iyzico aboneliğinde müşterinin hesabı, abonelik kaydı ve dönemsel ödeme aynı kimlikle temsil edilmez. Bir dönem tahsilatı başarısız olduğunda bütün aboneliği yeniden oluşturmak gereksiz bir ikinci sözleşme kaydı yaratabilir. Önce sorunlu dönemi ve o döneme ait ödeme girişimini belirlemek gerekir. İşletmenin kendi sipariş numarası ile iyzico'nun döndürdüğü referanslar da ayrı tutulmalıdır. Böylece destek ekibi, geçmişte ödenmiş bir dönem ile halen bekleyen tahsilatı karıştırmadan aynı kaydı inceleyebilir.
Retry İsteğinde Beklenen Değer
Ödeme tekrarlama servisi /v2/subscription/operation/retry adresini kullanır. İstek gövdesindeki referenceCode alanı, başarısız ödeme bildiriminde bulunan orderReferenceCode değerini bekler. Aboneliğin subscriptionReferenceCode değeri bu alanın yerine kullanılmaz. İsimlerin birbirine yakın olması entegrasyonda kolay bir karışıklık yaratır. Kayıt tasarımında abonelik kimliği ve dönem ödeme kimliği için ayrı alanlar kullanılması bu hatayı azaltır. Logları incelerken gönderilen değerin hangi yanıttan alındığını izleyebilmek, yalnızca hata mesajını okumaktan daha açıklayıcıdır.
Bildirimden Sonra Güncel Durum
Tekrarlayan ödemeler için gelen webhook bildirimi sonrasında aboneliğin güncel durumu kontrol edilmelidir. Eski bir başarısızlık bildirimi, o ödemenin halen başarısız olduğunu tek başına göstermez; arada başka bir girişim yapılmış olabilir. İşletme sisteminin tekrar işleminden önce son durumu sorgulaması bu nedenle önemlidir. Ağ hatası veya gecikmiş bildirim durumunda aynı tahsilatı körlemesine tekrar başlatmak yerine, abonelik ayrıntısı ve ödeme girişimleri birlikte değerlendirilir. Teknik isteğin kabul edilmesi ile muhasebede sonuçlandırılmış tahsilat birbirinden ayrılır.
Kart Güncellemesi Hangi Aboneliğe Uygulanır?
Kartın süresinin dolması gibi durumlarda müşterinin ödeme aracını güncellemesi gerekebilir. iyzico'nun abonelik akışında belirli subscriptionReferenceCode ile yapılan kart güncellemesi ilgili aboneliği hedefler. Aynı müşterinin başka aboneliklerinin de değiştiğini varsaymayın. Kart güncelleme formunun tamamlanması sonrasında sorunlu dönem yeniden incelenmelidir. Güncelleme işlemi ile geçmiş borcun tahsil edilmesi ayrı olaylardır. Kullanıcıya gösterilecek mesaj da yalnızca doğrulanmış sonucu anlatmalıdır; kart değişti diye bekleyen faturaya otomatik olarak ödendi etiketi verilmemelidir.
Tekrar Denemeyi Nasıl Sınırlandırmalı?
Örnek bir işletmede müşteri kartını güncellerken destek personeli de panelden ödeme tekrarı başlatabilir. Uygulamadaki otomatik görev aynı anda çalışıyorsa üç ayrı süreç aynı döneme dokunur. Bu nedenle önerilen uygulama, ilgili ödeme için devam eden girişimi kaydetmek ve güncel sonuç görülmeden başka bir denemeyi başlatmamaktır. Deneme zamanı, kullanılan dönem referansı ve yanıt kaydı tutulabilir. Kart numarası, güvenlik kodu veya erişim anahtarları teşhis kayıtlarına eklenmemelidir.
Başarılı Sonuç Nasıl Doğrulanır?
Kontrol, aynı dönemin ödeme girişiminde başarılı sonuç görülmesi ve işletmenin kayıtlarının bu sonuçla eşleşmesiyle tamamlanır. Önceki hata mesajının ekranda kaybolması yeterli değildir. Tutar, para birimi, dönem ve müşteri birlikte değerlendirilir. Başarısızlık devam ediyorsa bütün aboneliği iptal edip yeniden açmadan önce sağlayıcının hata kodu incelenir. Bu yaklaşım, müşterinin aynı hizmet için ikinci kez abonelik başlatmasını ve destek ekibinin farklı kayıtlar üzerinde çalışmasını önlemeye yardımcı olur.
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.