Puan Sorgulama (Point Inquiry)

Bu sayfada, kart sahibine ait kullanılabilir puan bilgisinin sorgulanmasına yönelik Point Inquiry API yapısı ve entegrasyon detayları açıklanmaktadır.

Kart Puan Bakiyesi Sorgulama Servisi

Bu servis, kart sahibinin mevcut puan bakiyesini sorgulamak amacıyla kullanılır. Genellikle sadakat programları (loyalty) kapsamında, üye işyerlerinin müşteriye anlık olarak puan bilgisini göstermesi veya puanla ödeme imkânı sunması senaryolarında tercih edilir.

Bilgi

Bu işlem finansal bir işlem değildir, yalnızca bilgi sorgulamasıdır. Kart puanı sorgulaması, kart sahibinin limitini veya bakiyesini etkilemez.

İşleyiş

1. İstek Oluşturma: Üye işyeri, müşterinin kart bilgilerini kullanarak puan sorgulama isteği gönderir.
2. Sorgulama Parametreleri: Sorgulama, PAN (tam kart numarası) ile yapılır. Kartın son kullanma tarihi (expiry) istekte zorunlu olarak gönderilmelidir.
3. Banka Sorgusu: HalkÖde sistemi, issuer (kartı çıkaran banka) ile iletişime geçerek güncel puan bakiyesini sorgular.
4. Yanıt: Yanıt içerisinde kart sahibinin kullanılabilir puan bakiyesi bilgisi döner.

Güvenlik Türü

Bu servis yalnızca Non-3DS (3D doğrulamasız) olarak çalışır. 3D Secure doğrulaması desteklenmemektedir.

Önemli Notlar

Geliştirici İçin Kritik Bilgiler

• Finansal Değil: Sorgulama tek başına puan düşümü/harcaması yapmaz.
• Satış Adımı: Yanıt yalnızca bilgi amaçlıdır; üye işyerinin puan kullanımına ilişkin bir işlem başlatması için ayrıca Satış (Sale) isteğini uygun puan parametreleriyle çağırması gerekir.
• Tutar Formatı: Yanıtta dönen puan tutarları da işlem tutarlarında olduğu gibi 100 ile çarpılarak gönderilir. (Örn: 123.00 TL karşılığı puan → 12300).