Tutarın Teknik Gösterimi
PayTR iFrame token isteğinde payment_amount, ödeme tutarının yüz ile çarpılmış tam sayı karşılığını taşır. Örneğin 129,90 TL için 12990 gönderilir. Ekrandaki Türkçe fiyat gösterimi ile API alanının beklediği biçim ayrı ele alınmalıdır.
Bir yazılımın ondalık ayıracı olarak virgül göndermesi veya kuruş değerini ikinci kez yüzle çarpması ciddi fark yaratabilir. AdPix’in önerisi sipariş tutarı, ödeme isteğindeki tutar ve müşterinin gördüğü tutarı aynı örnek üzerinde karşılaştırmaktır. Yalnızca tam liralı ürünlerle deneme yapmak kuruş kaynaklı hataları gizleyebilir. Deneme sepetinde ondalıklı fiyat da bulunmalıdır.
Sepet Bilgisinin Oluşturulması
user_basket alanı siparişteki ürün veya hizmet bilgisini taşır. PayTR örneklerindeki veri dizisi JSON ve Base64 dönüşümüyle iletilir. Bu kodlama, sepetin ticari hesabının doğru olduğunu garanti etmez; miktar ve ürün satırlarının ayrıca doğrulanması gerekir.
Örneğin iki adet ürünün toplam tutarı tek ürün fiyatı gibi yazılmış olabilir. Aynı şekilde ürün adındaki özel karakterler hatalı kodlama nedeniyle bozulabilir. İnceleme, aktarım öncesindeki satırları ve çözülmüş sepet verisini karşılaştırır. Sepet hesaplaması kullanıcı tarafından değiştirilebilen tarayıcı alanlarına bırakılmaz; işletmenin sunucuda doğruladığı sipariş kaydı esas alınır.
İndirim ve Kargo Bileşenleri
Müşterinin ödeyeceği tutar ürün etiket fiyatlarının basit toplamından farklı olabilir. Kupon, sepet indirimi ve kargo gibi bileşenler işletmenin ödeme hesabında açıkça izlenmelidir. Buradaki inceleme bir PayTR ücret tarifesi oluşturmaz; mağazanın kendi sipariş hesabının tutarlılığını ele alır.
Örnek bir sepette indirim ürünlere dağıtılırken yuvarlama farkı oluşabilir. Ödeme isteğine giden toplamın son anda başka yöntemle yeniden hesaplanması kuruş farkını büyütebilir. AdPix’in önerisi tek bir doğrulanmış sipariş toplamını kullanmak ve her bileşenin bu toplama nasıl ulaştığını saklamaktır. Müşteriye gösterilen son onay da aynı hesabı kullanmalıdır.
Token ile Gönderilen Verinin Uyumu
Token oluşturulurken kullanılan alanlar ile ödeme isteğinde gönderilen alanların aynı değeri taşıması gerekir. Tutar veya sepet daha sonra değişiyorsa eski token üzerinden devam etmek uygun değildir. İstek hazırlama ve doğrulama aynı sipariş sürümüne dayanmalıdır.
Örneğin müşteri ödeme ekranına geçtikten sonra başka sekmede kupon uygular. İşletme hangi sipariş sürümünün tahsil edileceğini belirlemeden iki toplamı birlikte kullanmamalıdır. Aynı durum stok veya fiyat değişikliğinde de araştırılır. Hata incelemesinde gizli anahtarlar kayda yazılmaz; sipariş kimliği, maskelenmiş istek özeti ve teknik sonuç yeterli izlenebilirlik sağlayacak şekilde düzenlenir.
Deneme Senaryoları ve Sonuç
Doğrulama yalnızca başarılı bir tek ürün ödemesine dayanmaz. İki adet ürün, farklı fiyatlı ürünler, ondalıklı tutar ve indirimli sepet ayrı örnekler olarak ele alınır. Her örnekte beklenen son tutar denemeden önce belirlenir.
Ödeme ekranının açılması bütün hesabın doğru olduğu anlamına gelmez. Gösterilen değer, ödeme sonucundaki işlem ve mağaza siparişi birlikte karşılaştırılır. Bir fark bulunduğunda müşteri hesabını elle değiştirmek yerine farkın ilk üretildiği adım düzeltilir. Böylece aynı yanlışın sonraki siparişlerde tekrarlanması önlenebilir. Başarı ölçütü, doğru sepetin müşteriye gösterilen doğru tutarla işlenmesidir.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- JSON
- JSON (JavaScript Object Notation), veriyi ad ve değer çiftleriyle düz metin olarak yazan bir veri değişim biçimidir; API’ler ürün, sipariş ve stok bilgisini çoğunlukla JSON olarak gönderir ve alır.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
PayTR