Reverse

Reversal endpoint’i, daha önce onaylanmış (provizyon alınmış) bir kart işleminin, tamamlanmadan önce iptal edilmesi amacıyla kullanılır. Bu endpoint, kart dünyasında sıklıkla void / reversal (iptal / ters işlem) olarak adlandırılan akışı temsil eder. Bir işlem başarıyla onaylanmış olsa bile; henüz mutabakat (clearing/settlement) aşamasına geçmeden önce, teknik veya kart hamilinin istediği ile iptal edilmek zorunda kalabilir. Bu durumda Payantis, Kurum’a Reversal endpoint’i üzerinden çağrı yaparak orijinal işlemin finansal etkisini geri almasını ister.

Bu endpoint, özellikle bakiye ve muhasebenin Kurum tarafında tutulduğu yapılarda, bakiye tutarlılığının bozulmaması için kritik öneme sahiptir.

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

Orijinal işlemi referans alır

Payantis, iptal edilmek istenen işleme ait bilgileri (ör. OriginalCorrelationId, TransactionId) Kurum’a ileterek hangi işlemin geri alınacağını netleştirir.

İşlemin durumunu değerlendirir

Kurum, kendi sistemlerinde:

Orijinal işlem mevcut mu?

Daha önce iptal edilmiş mi?

Zaten reddedilmiş mi?
gibi kontrolleri yapar..

Finansal etkiyi geri alır

Orijinal işlem onaylanmış ve bakiye düşümü yapılmışsa, Kurum bu düşümü ters kayıt ile geri alır. Böylece kart/hesap bakiyesi işlem öncesi durumuna getirilir.

Idempotent davranır

Reversal endpoint’i, tekrarlanan çağrılara karşı idempotent olacak şekilde tasarlanmalıdır. Aynı reversal talebi birden fazla kez gelse bile, Kurum tutarlı bir sonuç üretmelidir.

Sonuç kodu üretir

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

📌

Sonuç kodlarının şu şekilde olması beklenir:
00: Orjinal işlem bulundu ve iptal edildi
28: Orjinal işlem zaten reddedilmiş, bir aksiyon alınmadı.
29: Orjinal işlem bulunamadı, iptal edilecek işlem yok.
94: Orjinal işlem daha önce reverse edilmiş.

{ "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