Günün İşlem Listesi
iyzico gün bazında raporlama servisi, belirli bir tarihteki ödeme, iptal ve iade işlemlerini listelemek için kullanılır. Bu liste yalnız yeni siparişlerden oluşan bir satış tablosu değildir. Kurgusal bir mağazada bugün eski bir siparişin iadesi yapılmış olabilir. Ödeme günü farklı olsa da iade olayı raporun işlem kapsamıyla değerlendirilmelidir. AdPix önerisi dışa aktarımın hangi günü ve hangi olay türlerini içerdiğini baştan yazmaktır. Siparişin oluşturulma tarihine bakarak bütün satırları aynı listeye zorlamak açıklanamayan farklar üretebilir.
İlk Sayfayla Sınırlı Kalmamak
Servis page alanıyla sayfa numarası ister; belgeye göre sayfalama birden başlar. Yanıtta currentPage ve totalPageCount bilgileri bulunabilir. Bu nedenle tek başarılı yanıt bütün günün alındığını tek başına göstermez. iyzico resmî SDK örneği de işlem gününü ve sayfayı ayrı alanlar olarak kurar. AdPix entegrasyon önerisi seçili günün beklenen sayfalarını izlemektir. İlk sayfa geldikten sonra bağlantı kesilmişse rapor tamamlandı diye sunulmamalıdır. Sonuç ekranı veri kapsamının eksik olduğunu gösterebilmeli, hata sessizce sıfır satışa dönüşmemelidir.
Ödeme Kimliğiyle Satır Kimliğini Ayırmak
Günlük işlem satırları paymentId yanında transactionId ve paymentTxId gibi farklı kimlikler içerebilir. Aynı ödemenin birden fazla ürün kırılımı veya iade olayı bulunabileceğinden yalnız paymentId tekrarına bakarak satır silinmemelidir. AdPix kurgusal örneğinde tek siparişin iki kalemi için ayrı iade kaydı oluşmuş olsun. Bunları mükerrer ödeme diye birleştirmek bir iadenin kaybolmasına yol açabilir. Entegrasyon, işlem türünü ve ilgili olay kimliklerini kendi veri modelinde korumalıdır. Kimliklerin bütün servislerde aynı kapsamı taşıdığı veya evrensel benzersizlik sağladığı varsayılmamalıdır.
Günlük İşlem Raporunun Tamlığı İçin Örnek Durumlar
İlk sayfa başarılı fakat gün toplamı düşük.: currentPage ve totalPageCount değerlerini okuyun.. Tek yanıtı bütün gün tamamlandı diye göstermeyin.. Bir ödeme kimliği birkaç satırda bulunuyor.: Olay türü ve kırılım kimliklerini koruyun.. Sırf paymentId tekrarından satır silmeyin.. Yeniden indirme toplam tutarı artırıyor.: Önceden alınmış olayın nasıl tanındığını inceleyin.. Aynı olayı tekrar satış gibi saymayın.. Bu çizim, makaledeki koşulları açıklayan temsilî değerlendirmedir; gerçek hesap kaydı veya uygulanmış müşteri testi değildir.
İşlem Türüyle Tutarı Yorumlamak
Yanıttaki transactionType ödeme ve iade gibi farklı olayları ayırır. Aynı tutar alanını her satırda pozitif satış geliri gibi toplamak yanlış rapor üretir. AdPix önerisi ödeme, iptal ve iade gruplarını ayrı okuyup mutabakat hesabını açıkça tanımlamaktır. Para birimi alanları da korunmalıdır; farklı para birimlerini dönüştürmeden tek toplamda birleştirmek anlamlı değildir. Bu yaklaşım bankaya hangi gün ne kadar aktarım yapılacağını tek başına söylemez. Günlük işlem listesi ödeme olayını izler; banka hareketiyle eşleşme için uygun aktarım kayıtları ayrıca değerlendirilir.
Yeniden Denemenin Etkisini Kontrol Etmek
Rapor görevi zaman aşımı aldığında aynı gün ve sayfa yeniden istenebilir. AdPix uygulama önerisi daha önce alınmış olayların ikinci kez toplamı artırmasını önleyecek açık bir kayıt yaklaşımı belirlemektir. Bu davranışın entegrasyonda hazır olduğu varsayılmaz; kontrollü denemeyle doğrulanmalıdır. Hata kaydına sayfa numarası ve sonuç durumu yazmak, yeniden başlatmanın nereden devam edeceğini açıklamaya yardımcı olur. Kişisel müşteri bilgileri ve API anahtarları günlüklerde tutulmamalıdır. Aynı raporun tekrar indirilmesiyle yeni bir tahsilat oluşmaz; fakat iç sistemde yanlış tekrar sayım yapılması mümkündür.
Detay İncelemesine Geçiş
Açıklanamayan bir olayda işlem detay raporu ilgili ödeme kimliği veya ödeme conversation referansı üzerinden ayrıca incelenebilir. Sorgu isteğinin kendi conversationId alanıyla araştırılan ödeme referansı birbirine karıştırılmamalıdır. AdPix kabul kaydı günü, alınan sayfa aralığını, olay türlerine göre satır sayısını ve eşleşmeyen kayıtları içerir. Bütün sayfalar tamamlanmadan genel toplam kesin sonuç olarak sunulmaz. Tekrarlanan görevde aynı kapsamın korunması ve temizlenmiş örnek kimlikle ayrıntıya ulaşılabilmesi, günlük mutabakatın izlenebilir olduğunu gösterir; ekonomik sonuç veya aktarım garantisi vermez.
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.