Bir Siparişten Birden Fazla Transfer
PayTR Platform Transfer API, satıcılara aktarılacak tutarların talimatlarla yönetildiği bir yapı sunar. Bir sipariş birden fazla satıcıyla ilişkili olabilir; bu durumda sipariş numarası ile transfer takip numarası aynı işlevi taşımaz. merchant_oid siparişe, trans_id ise belirli transfer işlemine bağlanır. İnceleme bu iki kimlik birlikte tutulduğunda anlamlıdır. Yalnızca müşteri sipariş numarasına bakmak, hangi satıcının aktarımının tamamlandığını göstermeyebilir. İşletmenin iç ekranında satıcı, sipariş, aktarılacak tutar ve transfer sonucu ayrı alanlar olarak bulunmalıdır. Bu yazı Platform Transfer kullanan hesapların operasyon takibini ele alır.
Talimatın Tutar Kapsamı
Transfer isteğinde toplam işlem tutarı ile alt satıcıya aktarılacak tutar ayrı tanımlanır. PayTR dokümanı bir sipariş için birden fazla transfer talimatı örneği içerir. Varsayımsal olarak iki satıcılı bir siparişte, her satıcı için hak edilen tutar işletmenin kendi kayıtlarında önceden açıklanabilir olmalıdır. Aynı toplamın iki satıcıya ayrı ayrı atanması, müşteriden alınan tutarla uyumsuz bir talimat doğurur. İşlem oluşturulmadan önce kalan dağıtılabilir tutar kontrol edilir. İstek alanlarının beklediği tutar biçimi servis belgesine göre hazırlanır; ekranda gösterilen para metni doğrudan API alanına taşınmaz.
Talebin Kabulü ve Sonuç Bildirimi
Transfer talimatına gelen yanıt ile transfer tamamlandı bildirimi ayrı izlenmelidir. PayTR, transfer işlemlerinin sonuçlanmasının ardından mağazanın belirlediği bildirim adresine bilgi gönderir. Bu bildirimde tamamlanan transfer kimlikleri üzerinden iç kayda ulaşılır. Örneğin talimat yanıtı alınmış fakat bildirim henüz işlenmemişse, satıcıya tamamlanmış aktarım mesajı göndermek erken olabilir. Uygulama durumları gerçekte alınan kanıta dayanır. Teknik ekip, bildirimin alındığı zamanı ve ilgili kayda işlenmesini takip eder. Destek ekranında “talep gönderildi” ile “tamamlandı” ifadeleri aynı anlama gelecek şekilde kullanılmamalıdır.
Belirsiz Yanıtta Tekrar Deneme
Bağlantı kesintisinden sonra uygulamanın yanıt görmemesi, PayTR tarafında talebin hiç alınmadığını kesinleştirmez. Bu nedenle yeni bir transfer numarası üreterek aynı tutarı yeniden göndermek güvenli bir varsayım değildir. Önce mevcut trans_id ve sağlayıcı kaydı araştırılır. Belirsiz durumlar otomatik olarak başarılı veya başarısız sayılmadan ayrı izlenebilir. Varsayımsal olarak görevli ekranı yenilediğinde sistem aynı talimatın durumunu göstermeli; ikinci bir para hareketi başlatmamalıdır. İşletmenin tekrar deneme politikası, sağlayıcının kabul ettiği işlem kurallarıyla uyumlu olmalıdır. Aynı satıcının aynı alacağı iki kez tamamlanmış olarak işaretlenmemelidir.
Bildirim Güvenliği ve Kabul Kontrolü
PayTR transfer sonucu bildiriminde hash doğrulaması tanımlar. Uygulama bu doğrulamayı yapmadan gelen transfer kimliklerini tamamlandı saymamalıdır. Doğrulanmış bildirim kalıcı olarak işlendiğinde gerekli yanıt verilir; aynı bildirim tekrar gelirse müşteri veya satıcıya yinelenen bildirim üretilmez. Kabul testinde tek satıcılı sipariş, birden fazla satıcı, belirsiz yanıt ve tekrar bildirim örnekleri yer alabilir. Her örnekte toplam dağıtım ve işlem geçmişi tutarlı kalmalıdır. Gizli anahtarlar hata mesajına yazılmaz. Sonuçta siparişten satıcıya kadar her para hareketinin hangi talimatla gerçekleştiği açıkça izlenebilir olmalıdır.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
PayTR