Authorization

Payantis Platform üzerinde gerçekleşen bir kart işleminin finansal olarak onaylanıp onaylanmayacağına karar verilmesi amacıyla kullanılır. Bu endpoint, bakiye ve hesap yönetiminin Kurum (Core Banking / Wallet / Ledger sistemi) tarafında tutulduğu durumda çağrılır.

Payantis, karttan gelen bir işlemi (POS, ATM, E-Commerce, QR vb.) değerlendirirken, işlemin nihai kararını verebilmek için Kurum’a bu endpoint üzerinden danışır. Kurum, kendi sistemlerindeki bakiye, limit, kısıt, ürün ve güvenlik kurallarını uygulayarak işlemi onaylar (approve) veya reddeder (decline).

Bu nedenle Authorization endpoint’i, Payantis ile Kurum arasındaki entegrasyonda en kritik karar noktasıdır.

Authorization endpoint’inden şu şekilde çalışması beklenir:

İşlem bağlamını alır

Payantis tarafından iletilen bilgiler sayesinde işlem;

hangi kart/token için üzerinden,

hangi tutarda ve para biriminde,

hangi kanal ve terminal türünde,

hangi ağ (BKM, Visa, Mastercard vb.)
gerçekleşiyor bilgileriyle Kurum’a iletilir.

Bakiye ve hesap uygunluğunu değerlendirir

Kurum, kartın bağlı olduğu hesapta:

yeterli bakiye olup olmadığını,

hesabın/kartın blokeli, kapalı veya kısıtlı olup olmadığını,

ürün bazlı kural ihlali bulunup bulunmadığını
kontrol eder.

Limit ve kural kontrollerini uygular (varsa)

İşlem tutarı, işlem sayısı, kanal bazlı limitler veya Kurum’un tanımladığı diğer kurallar değerlendirilir. Gerekirse işlem limit aşıldı gerekçesiyle reddedilebilir.

Ek tutarları hesaplayabilir

Kurum isterse;

işlem ücreti,

komisyon veya benzeri kalemleri
AdditionalAmounts üzerinden hesaplayarak Payantis’e geri dönebilir.

Sonuç üretir

Tüm değerlendirmeler sonucunda Kurum:

işlemi onaylar veya

belirli bir gerekçe ile reddeder
Bu karar, ResponseCode alanı ile Payantis’e iletilir. Payantis de bu koda göre işlemi kart ağına ve üst sistemlere yansıtır.

📌

Sonuç kodlarının şu şekilde olması beklenir:
00 veya 0: İşlem başarılı, onay.
05: Hesap uygun statüde değil, blokeli, kapalı vb, red.
51: Hesap bakiyesi yetersiz, red.
57: İşleme izin verilmiyor, red.
61: İşlem limitleri aşıldı, red.
62: Hesap bu işlem için kısıtlanmış, red.
96: Beklenmedik sistem hatası, red.

💡

Authorization endpoint’ine gönderilen parametreler, yalnızca teknik veri değil; iş kararını etkileyen bağlamsal bilgilerdir:

İşlem Anahtarları
CorrelationId ve TransactionId, işlemin izlenmesi ve sonradan mutabakat/audit yapılabilmesi için kullanılır.

Kart ve Hesap Bağlantısı
TokenId, işlemin hangi kart/hesap için yapıldığını belirtir ve Kurum’un kendi sistemindeki karşılığı bulmasını sağlar.

Finansal Alanlar
TransactionAmount, TransactionCurrency, BillingAmount, BillingCurrency gibi alanlar, bakiye ve muhasebe etkisini belirler.

İşlem Bağlamı
TerminalType, TransactionNetwork, PosEntryMode, TransactionDomain gibi alanlar, işlemin nerede ve nasıl gerçekleştiğini gösterir ve Kurum’un kural setlerini doğru uygulamasını sağlar.

Güvenlik ve Doğrulama
SecurityLevelIndicator ve CvmType, işlemin risk seviyesini belirlemede kullanılır.

QR ve Hesap Bazlı İşlemler
QrData, QrRefNo ve AccountDetail, özellikle QR veya hesap bazlı ödeme senaryolarında kullanılır.

💡

BKM regülasyonları kapsamında KYS (Karekod Yönetim Sistemi) bağlantısının kurulması ve yönetilmesi Kurumun sorumluluğundadır. QRData, Acquirer tarafından üretilen ve işlem öncesinde Kuruma iletilmiş olan bir QR verisidir.

Bu nedenle QR işlemlerinde, ilgili QR’ın kullanılabilirliğinin (geçerlilik, durum, süre vb.) kontrolü Kurum tarafından yapılmalıdır. İşlem başarıyla tamamlandıktan sonra QR “kullanılmış” olarak işaretlenmeli ve tekrar kullanımına izin verilmemelidir.

Ayrıca QR ile gerçekleştirilen bir işleme ilişkin Reversal mesajı gelmesi durumunda, QR’ın kullanım durumu Kurum tarafından uygun şekilde geri alınmalı ve statüsü güncellenmelidir.

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