Appearance

Ön Provizyon (Pre-Sale) ​

Bu sayfada, 3D Secure doğrulaması ile gerçekleştirilen ön provizyon (pre-authorization) işleminin API kullanımı ve işlem akışı detaylandırılmaktadır.

🔹 Ön Provizyon (Pre-Sale) İşlemi Nedir? ​

Ön provizyon, bir kart sahibinin bakiyesini/limitini belirli bir süreliğine bloke eden bir provizyon (authorization) işlemidir.

  • Normal provizyon (authorization) işlemiyle aynı akışa sahiptir.
  • Farkı: Ödeme hemen tahsil edilmez, sadece tutar kadar bloke konulur.
  • Daha sonra işlem:
    • Tamamlama (PostSale / Capture) ile tahsil edilebilir,
    • İptal (Void / Cancel) ile serbest bırakılabilir.

Not: Ön provizyon işlemleri, özellikle otel, araç kiralama veya sigorta gibi sektörlerde sıkça kullanılır. Bloke süresi ve işlem geçerliliği, issuer bankanın politikalarına göre değişebilir.

🔹 Ön Provizyon İşlemi Desteklenen Kart Türleri ​

Ön provizyon (PreSale) işlemi, aşağıdaki kart türlerinde desteklenmektedir:

  • Kredi Kartları: Tüm bankalar tarafından ön provizyon işlemi genellikle desteklenir.
  • Banka Kartları (Debit Card): Bazı bankalar desteklemektedir; ancak işlem tipi ve kartın bağlı olduğu bankaya göre değişiklik gösterebilir.
  • Ön Ödemeli Kartlar (Prepaid Card): Genellikle desteklenmez; işlem bankanın politikalarına bağlıdır.

Not: Ön provizyon işleminin başarıyla gerçekleşip gerçekleşmeyeceği, kartın ait olduğu bankanın (issuer) işlem tipini desteklemesine bağlıdır. Özellikle debit ve prepaid kartlarda işlem öncesi test yapılması önerilir.

🔹 3DS ile Ön Provizyon Süreci (Presale) ​

1. Ön Provizyon İsteği Gönderimi ​

Üye işyeri, 3DS parametreleri ile ön provizyon (presale) isteğini VPOS sistemine gönderir.

2. Kart ve İşlem Kontrolleri ​

VPOS, kart bilgilerini ve işlem ön kontrollerini doğrular.

3. Kart Sahibi Doğrulaması ​

Eğer kart sahibinin doğrulaması gerekiyorsa:

  • VPOS, base64 formatında HTML içerik üretir (örnek: challenge, frictionless).
  • Üye işyeri, bu HTML içeriği kart sahibine gösterir.
  • Kart sahibi, OTP SMS veya mobil uygulama aracılığıyla kimliğini doğrular.

Finansal Yetkilendirme (Authorization) ​

4. Otomatik Provizyon (3DS-PAY) ​

Eğer işlem "requestType": "3DS-PAY" yöntemiyle başlatılmışsa:

  • Doğrulama tamamlandıktan sonra VPOS sistemi otomatik olarak issuer bankaya finansal yetkilendirme isteği gönderir.
  • Bu durumda işlem doğrudan ön provizyona geçer ve üye işyerinin ek bir çağrı yapmasına gerek kalmaz.

5. Manuel Provizyon (3DS) ​

Eğer işlem yalnızca "requestType": "3DS" parametresiyle başlatılmışsa:

  • Doğrulama tamamlandıktan sonra üye işyerinin ayrıca Complete3DSPayment isteğini çağırması gerekir.
  • Bu çağrı ile birlikte finansal yetkilendirme işlemi başlatılır ve ön provizyon alınır.

İşlem Sonrası Bildirim ​

6. Provizyon Yanıtı ​

Issuer banka, provizyon yanıtını arka planda VPOS sistemine iletir.

7. Bildirim Mekanizmaları ​

İşlem tamamlandığında, VPOS sistemi isteğe bağlı olarak tanımlanmış Return URL veya Callback URL üzerinden üye işyerine bildirim gönderebilir. Detaylar için ilgili entegrasyon dokümantasyonuna başvurulmalıdır.

8. Durum Sorgulama ​

Üye işyeri, gelen bildirim veya işlem token’ı ile işlemin onay durumunu kontrol eder ve gerekli aksiyonları alır.

🔹 Kimler Kullanabilir? ​

Ön provizyon işlemi, tutarın kesinleşmediği veya işlem riskinin yüksek olduğu durumlarda tercih edilir. Bu yöntem, ödeme almadan önce belirli bir tutarın geçici olarak bloke edilmesini sağlar.

Kullanım alanları:

  • Otel / Seyahat: Check-in sırasında konaklama ücretine karşılık bloke konulur, çıkışta net tutar tahsil edilir.
  • Araç Kiralama: Araç depozitosu blokelenir; kiralama sonunda yakıt, hasar veya ek ücretler eklenerek kesin tutar tahsil edilir.
  • Turizm / Online Rezervasyon: Rezervasyon garantisi için ödeme alınmadan önce tutar bloke edilir; işlem kesinleştiğinde tahsilat yapılır.

Bu sektörlerde ön provizyon, hem müşteri memnuniyetini korumak hem de işletme riskini azaltmak için yaygın olarak kullanılmaktadır.

🔹 Satış (Sale) İşleminden Farkı ​

  • Satış (Sale): Tek aşamalıdır → Karttan ödeme hemen tahsil edilir.
  • Ön Provizyon (PreSale): İki aşamalıdır:
    • Bloke aşaması → Tutar kart üzerinde kilitlenir, tahsil edilmez.
    • Tamamlama aşaması (PostSale / Capture) → İşlem kesinleştiğinde bloke edilen tutar tahsil edilir.

Eğer üye işyeri belirlenen süre içinde PostSale göndermezse:

  • Kartı çıkaran banka (issuer) blokeyi otomatik kaldırır.
  • Bu sürenin uzunluğu banka politikasına göre değişir (genellikle 7–14 gün).
  • Ön provizyon işlemlerinde puan kullanımı desteklenmemektedir.

🔹 Geliştirici Notları ​

  • Ön provizyon tek başına ödeme değildir, mutlaka bir PostSale (tamamlama) ya da Void (iptal) işlemi ile kapatılmalıdır.
  • Eğer PostSale yapılmazsa, banka bloke süresi bitince otomatik olarak kaldırır.
  • Aynı işlem için birden fazla kısmi tahsilat (PostSale) yapılabilir (banka destekliyorsa).
  • Ön provizyon işlemlerinde taksitli işlem yapılabilir, ancak puan kullanımı desteklenmez.
  • Üye işyerine risk yönetimi ve güvenlik avantajı sağlar.