Skip to main content
Türk bankalarının kart programları (Bonus, Maximum, Axess, World, Paraf, Cardfinans, Wings) müşteriye puan biriktirme sunar. Bu endpoint, kart bazında puan bakiyesi sorgulamak için kullanılır.
Tüm bankalar puan sorgu API’si sunmaz. Şu anda HalkBank VPOS üzerinde aktiftir. Diğer konnektörler için destek genişlemektedir — güncel matris için konsoldaki Konnektörler ekranına bakın.

Endpoint

Mevcut bir ödeme/3DS init kaydına bağlı kart için puan sorgular. Genellikle 3DS init sonrası, otorizasyon öncesi çağrılır — müşteriye “X puanınız var, kullanmak ister misiniz?” akışı için.

İstek

Yanıt

Yanıttaki status alanı mevcut Transaction durumunu yansıtır (PointInquiry handler’ı durumu değiştirmez). Tipik akışta bu sorgu 3DS init sonrası yapılır, dolayısıyla three_d_secure_init_processing görürsünüz. Direkt sorgu (3DS olmadan) yapıldıysa processing veya authorized olabilir.
Konnektöre göre alan isimleri değişebilir — point_balance her konnektörde garanti değildir. Yanıt schema’sını extra_properties altındaki gerçek anahtarlarla çalışın; gelmeyen alanları boş varsayın.

Puan kullanarak ödeme

Şu an puan kullanımı konnektöre özgü bir akıştır — CreatePaymentRequest.extra_properties ile aktarılır:
Banka talebi onaylarsa kalan tutar (10.000 kuruş) karttan çekilir, 5.000 puan düşülür. Top-level standart bir use_points alanı yol haritasındadır.

Hata response’ları

Hata yanıtı RFC 9457 problem+json formatındadır:

Konnektör desteği matrisi