Ö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:

  1. Bloke aşaması → Tutar kart üzerinde kilitlenir, tahsil edilmez.

  2. 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.