İade Talebi ile Ödeme Reddini Ayırın
PayTR İade API, tahsil edilmiş siparişin tamamı veya bir bölümü için iade talebi oluşturur. Burada alınan hata, müşterinin ödeme sırasında gördüğü banka reddiyle aynı aşamaya ait değildir. İnceleme hangi servisin hangi işlem için çağrıldığını belirleyerek başlar.
AdPix’in önerisi ödeme, iade ve durum sorgulama sonuçlarını ayrı kayıt türleriyle tutmaktır. Örneğin müşterinin kartla ödeme yapabildiği hâlde iadesi başarısız olabilir. Bu durumda kartın ödeme yetkisini araştırmak yerine iade isteğinin sonucu ele alınır. Sipariş numarası ve hedeflenen tutar ilk kayıtta açıkça belirtilir.
Tutar Biçimi ve Kısmi İade
İade isteğinde merchant_oid ilgili siparişi, return_amount ise iade edilecek tutarı belirtir. PayTR dokümanı bu tutar için noktalı ondalık gösterimi kullanır. Başka ödeme uç noktalarında kullanılan miktar biçiminin buraya otomatik taşınması doğru değildir.
AdPix örneğinde siparişin yalnızca bir ürünü iade edilirken tüm ödeme tutarının gönderilmesi ticari kayıp oluşturabilir. Ekip önce hangi kalemin ve miktarın iade edildiğini belirler. İndirim veya kargo gibi bileşenlerin işletme kararındaki yeri netleşir. Teknik istekteki tutar bu kararla karşılaştırılır; hesaplama yalnızca ekrandaki ürün etiket fiyatına dayandırılmaz.
Hata Kodunu Açıklamasıyla Okuyun
PayTR iade hataları arasında siparişle başarılı ödeme eşleşmemesi, eksik veya geçersiz alanlar ve kullanılabilir tutarı aşan iade gibi durumlar bulunur. Örneğin 009 kodu kalan ödeme tutarını aşan iade isteğiyle, 010 ise mağaza bakiyesinin yetersizliğiyle ilişkilidir.
AdPix’in önerisi kodu tek başına saklamamaktır. err_msg açıklaması ve hangi tutarla deneme yapıldığı aynı kayıt içinde bulunur. Aynı hata numarası farklı serviste farklı anlam taşıyabileceğinden servis adı da yazılır. Eksik alan hatasıyla sonuçsuz kalan ağ isteği farklı biçimde ele alınır; ikisine aynı tekrar deneme kuralı uygulanmaz.
Yanıt Alınamadığında Tekrar İşlem
Bağlantı kesildiğinde veya uygulama yanıtı okuyamadığında iadenin kesin olarak yapılmadığı varsayılmamalıdır. PayTR durum sorgulama servisi ilgili siparişin iadelerini de döndürebilir. Yeni bir iade isteği başlatılmadan önce mevcut sonuç araştırılır.
AdPix örneğinde müşteri destek ekranında hata görülürken sağlayıcı tarafında işlem kabul edilmiş olabilir. Aynı tutarı tekrar göndermek kalan tutar üzerinden ikinci bir iade riski yaratabilir. İşletme kendi iade kaydını ve sağlayıcı sonucunu eşleştirir. Referans numarası izlenebilirlik için kullanılabilir; bunun tek başına her tekrar isteğini engelleyen garanti olduğu varsayılmaz.
Sonucun Müşteriye Aktarılması
API yanıtında iade talebinin başarılı olması, müşterinin banka hareketini aynı anda göreceği anlamına gelmez. İşletme doğruladığı işlem sonucunu aktarır ve belgelenmemiş kesin süre sözü vermez. Siparişin test işlem olup olmadığı da gerçek tahsilatla karıştırılmamalıdır.
AdPix’in kapanış kontrolünde iade edilen tutar, sipariş kimliği ve işlem referansı birbiriyle uyuşur. Birden fazla kısmi iade varsa toplamları takip edilir. İşlem yapılmış görünmesi için sipariş durumunun elle değiştirilmesi yeterli kabul edilmez. Destek kaydı teknik hata, kabul edilmiş talep ve müşterinin bildirdiği banka sonucu arasındaki ayrımı korur.
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.
PayTR