Refund

Refund endpoint’i, tamamlanmış (takası gelmiş ve settle olmuş) bir kart işleminin, sonradan kısmen veya tamamen iade edilmesi amacıyla kullanılır. Reversal’dan temel farkı; refund işleminin, artık geri alınamaz noktaya gelmiş bir işlemin yeni ve ters yönlü bir finansal hareket olarak ele alınmasıdır.

Payantis Platform, kart ağı veya işyeri tarafından başlatılan bir iade talebini Kurum’a bu endpoint üzerinden iletir. Kurum, kendi muhasebe ve bakiye sistemlerinde iade işlemini işleyerek kart/hesap bakiyesine geri ödeme etkisini uygular.

Refund endpoint’i aşağıdaki fonksiyonları yerine getirir:

Orijinal işlemi referans alır

İade talebi, büyük çoğunlukla daha önce gerçekleşmiş bir işlemi referans alır (Referanslı İade). Bu amaçla Payantis, refund isteği içinde orijinal işleme ait bilgileri Kurum’a iletir. Request içindeki OriginalDetail nesnesindeki transactionId alanı orjinal işlemin numarasını belirtir. Eğer iade talebi bağımsız bir işlem ise (Referanssız İade) OriginalDetail nesnesi null olarak iletilir.

Finansal iade kaydı oluşturur

Refund işlemi, muhasebe açısından:

Orijinal işlemin iptali değil,

Ona bağlı yeni bir iade işlemi olarak değerlendirilir.
Bu nedenle Kurum, refund tutarı kadar bakiyeyi artıran bir finansal kayıt oluşturur.

Kısmi iade senaryolarını destekler

Kurum, refund isteğinde TransactionAmount alanı ile belirtilen tutara göre:

Tam iade

Kısmi iade
senaryolarını yönetebilir.

Sonuç kodu üretir

Kurum, iade talebinin sonucunu ResponseCode ile Payantis’e bildirir. Bu kod, Payantis’in kart ağına ve üst sistemlere doğru mesajı iletmesini sağlar.

İade işlemi de bir authorization işlemidir. Bu nedenle iade işleminin sonucunu belirten ResponseCode değerinin authorization işlemi ile aynı olması beklenir.

📌

İade (Refund) İşlemlerinde Bakiye Güncelleme Yaklaşımı

İade (refund) işlemlerinde, kart hamilinin hesabına anlık olarak alacak bakiyesi yansıtılması, operasyonel ve finansal riskler barındırabilir. Özellikle; mükerrer iade talepleri, takas öncesi iptaller, kart ağı kaynaklı geç bildirimler veya uyuşmazlık senaryolarında, anlık bakiye artışı gerçekleşmemiş fonun kart hamiline kullandırılması riskini doğurabilir.

Bu nedenle, iade işlemlerinin finansal etkisinin anlık bakiye güncellemesi yerine, gün sonunda Payantis tarafından Kurum’a iletilecek takas/mutabakat (clearing/settlement) dosyaları üzerinden muhasebeleştirilmesi tavsiye edilmektedir.

Bu yaklaşım ile:

İade tutarları, kart ağı ve Payantis kayıtları ile mutabık şekilde işlenir,

Mükerrer veya hatalı iade riskleri minimize edilir,

Kart hamiline henüz kesinleşmemiş bir alacak kullandırılmamış olur,

Kurum muhasebesi ile Payantis işlem kayıtları arasında tutarlılık sağlanır.

Özetle; refund işlemlerinde hesap bakiyesine doğrudan ve anlık alacak verilmesi yerine, iade tutarlarının takas/mutabakat süreci tamamlandıktan sonra hesaba yansıtılması, güvenli ve sürdürülebilir bir operasyon modeli olarak önerilmektedir.

{ "responseCode": "string", "responseDescription": "string", "tenantReferenceNo": "string", "balanceInformationList": [ { "type": "string", "previousBalance": 0, "currency": 0, "currentBalance": 0 } ], "additionalAmounts": [ { "id": "string", "additionalAmountType": "TransactionFee", "amount": 0, "currency": 0 } ], "qrData": "string", "qrRefNo": "string" }

Request

Responses