Hatanın Hangi Aşamada Oluştuğu
iyzico API yanıtında başarısızlık bilgisiyle birlikte errorCode ve errorMessage alanları dönebilir. Kimlik doğrulama hataları, kart bankasının verdiği ödeme reddiyle aynı aşamayı anlatmaz. Bu nedenle teknik bağlantı hatasında müşteriden tekrar tekrar başka kart denemesini istemek sorunu çözmeyebilir. İncelemede istek gönderilen servis, kullanılan ortam, hata kodu ve işlem kimliği birlikte alınır. Tam kart verileri veya gizli anahtarlar hata raporuna eklenmez.
1000 İmza Uyuşmazlığı
1000 kodu, oluşturulan imzanın iyzico tarafındaki doğrulamayla eşleşmediğini belirtir. HMACSHA256 yönteminde istek yolu, gövde, rastgele değer ve gizli anahtar imzanın oluşturulmasında rol oynar. İmzalanan gövdeyle gerçekten gönderilen gövdenin farklılaşması incelemede araştırılacak noktalardan biridir. Örneğin imzadan sonra JSON metninin yeniden biçimlendirilmesi aynı iş verisini farklı baytlarla gönderebilir. Kullanılan resmî SDK veya doğrulanmış örnekle aynı isteğin nasıl hazırlandığı karşılaştırılır.
1001 Ortam ve Hesap Eşleşmesi
1001 kodu, API bilgileri ile baseUrl eşleşmediğinde veya hesap üzerinde kısıt bulunduğunda görülebilir. Test ortamına ait bilgilerle canlı ortam adresini kullanmak ilk kontrol edilecek eşleşmelerden biridir. Anahtarların doğruluğu sadece uygulama ayar ekranından değerlendirilmez; çalışan sunucunun hangi yapılandırmayı yüklediği de incelenir. Doğru bilgiler kullanıldığı halde hata devam ediyorsa hesap kısıtları için iyzico desteğiyle işlem özelinde görüşülür. Gizli bilgiler açık mesajlara kopyalanmaz.
Başlık ve Rastgele Değer Kontrolü
HMACSHA256 belgesi Authorization başlığında IYZWSv2 öneki ve kodlanmış yetkilendirme değerini kullanır. İsteklerde x-iyzi-rnd değeri de bulunur. İmza oluşturulurken kullanılan rastgele değerin ilgili istekle tutarlı olması gerekir. Eski bir yetkilendirme başlığının farklı gövde veya farklı servis yoluyla tekrar kullanılması doğru kontrol yaklaşımı değildir. İnceleme, her istekte yeniden oluşturulan değerlerin birbirine nasıl bağlandığı üzerinden yürütülür; üretim anahtarı tarayıcıya taşınmaz. Servis değiştiğinde önceki yolun imza hesabında kalması da kontrol edilir; aynı anahtarla çalışan başka bir uç nokta yeni isteğin doğru imzalandığını kanıtlamaz.
Yayın Sonrası Ortaya Çıkan Hata Örneği
AdPix örneğinde testte çalışan bağlantının canlı dağıtımdan sonra 1001 verdiğini düşünelim. Önce hata kart sahibine yüklenmez. Uygulamanın dağıtım ayarındaki servis adresi, kullanılan anahtarın ortamı ve yeni ayarların çalışan sürece geçip geçmediği karşılaştırılır. Birden fazla sunucu varsa yalnızca bir sunucuda eski ayarın kalması da araştırılır. Bulgular kesinleşmeden ödeme akışında rastgele değişiklikler yapmak, asıl nedeni izlemeyi zorlaştırabilir.
Düzeltme Sonrası Kabul Kontrolü
Düzeltme kaydında hatalı ortam veya imza bileşeni, yapılan değişiklik ve doğrulanan sonuç belirtilir. Kontrollü testte yetkilendirmenin geçmesi, bütün ödeme sürecinin başarıyla tamamlandığı anlamına gelmez; ilgili işlemin sonucu da ayrıca incelenir. Yanıt belirsiz kaldığında mevcut işlem kontrol edilmeden tahsilat isteği gelişigüzel yinelenmez. Destek kaydına kod, zaman ve maskelenmiş işlem bilgisi eklenir. Böylece teknik ekip hatayı inceleyebilirken mağazanın gizli bağlantı bilgileri korunur.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- API
- API (Application Programming Interface), farklı yazılımların birbirleriyle veri alışverişi yapmasını sağlayan bağlantı yöntemidir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.