API Explorer
Destek

Hosted Ödeme Sayfası

Hosted ödeme sayfası

Lidio Hosted Ödeme Sayfası, işyerinize ait websitesi, mobil site veya uygulama sayfalarınız içerisine Iframe olarak yerleştirebileceğiniz ya da redirect akış ile kullanabileceğiniz, tamamen mobil uyumlu, PCI DSS Level 1 uyumlu güvenliğe sahip ve Lidio ile en hızlı ve kolay entegrasyonu sağlamanızı sağlayan çözümdür.

Lidio Hosted Ödeme Sayfası, kullanmak istediğiniz tüm ödeme yöntemlerine ve fonksiyonlara (ör. kayıtlı kart sorgu/gösterim/ödeme fonksiyonları, BIN yönetimi, taksit gösterim, puan sorgu/gösterim vb.) dair tüm özellikleri bünyesinde barındırır, ayrıca UI üzerinde kurgulamanıza ve entegre etmenize gerek kalmaz ve implementasyonda büyük kolaylığı sağlar.

Tercihinize göre, ödemede sunacağınız tüm ödeme yöntemleri Hosted Sayfada açılıp, kullanıcı tercihini bu sayfada belirleyerek işlemine devam edebilir ya da sizin işyeri UI akışında ödeme yöntemi seçilebilir ve Hosted Sayfa sadece sizin istekte belirteeceğiniz ödeme yöntem(ler)i için açılabilir.

Hosted Ödeme entegrasyonunda dikkat edilecek hususlar:


Hosted Ödeme sonuçlandığında, iframe işyeri ReturnURL'ine yönlendirilir ve işlem sonuçları ReturnURL'e eklenen query string parametreleri (gizlilik içermeyen bilgiler) ile işyerine bildirilir. Ancak bu sonuç bilgisi mutlaka GetHostedPaymentStatus servisi ile doğrulanmalıdır.
iframede hosted sayfa kullanan işyerlerinin, dönüş sağlanan ReturnURL’de “iframe içerisinden” herhangi bir cookie işlemi (erişim, set etme vb.) kurgulamaması gerekmektektedir. 3rd party cookie engelleyen tarayıcılarda, alternatif işleyişlerimiz devreye alınmakta, ancak bazı tarayıcılar tarafından bu akışlarda frame içerisinden cookie işlemleri tamamen engellenebilmektedir.
Hosted ödeme sonucunun işyerine bildirimi için, ReturnURL yoluyla bildirime ek olarak Ödeme Notifikasyonu gönderimi de sağlanabilir. Bu işyeri isteğine bağlı konfigüratif bir özelliktir, işyeri bildirimi karşılayacak servisi hazırlayarak NotificationURL alanında endpoint adresini işlemde iletmelidir.
Hosted Sayfa içerisindeki Eventleri (ör. HeightChanged) üst frame’e (işyeri sayfası) bildirmek için JavaScript Notificationlar (API Referansında ilgili metot altında detayları var) kullanılır. Kullanımı opsiyoneldir. Kullanılacaksa Event Listener ile bunlar üst frameden dinlenerek aksiyon alınır.

ReturnURL’e gelen ödeme sonucun teyidi (Lidio'dan geldiği) doğrulaması için mutlaka “GetHostedPaymentStatus” servisi kullanılmalıdır. İşlem sonucu bu servisten alınmalı, ReturnURL'deki temel alanlar (müşteri, tutar, taksit sayısı vb.) mukayese edilerek doğrulanmalıdır. Bu servisle ödemeye dair tüm detaylara ulaşılabilir.

Hosted ödeme akışı

  1. Kullanıcı ödeme sürecine gelir. Ödemeye ve siparişe dair bilgiler netleşmiş olur. Bu noktada işyeri isterse ödeme yöntemini kendi UI'ında seçtirir ve Lidio Hosted Sayfayı sadece seçili ödeme enstrüman(lar)ı için çağırabilir. Alternatif olarak ödeme yönteminin seçimi Hosted Sayfaya bırakılabilir, bu durumda servis isteğinde istenilen tüm yöntemlere yer verilmelidir.
  2. Sipariş ve ödeme bilgileri ile birlikte StartHostedPaymentProcess metodu çağrılır.
  3. StartHostedPaymentProcess responseta RedirectURL dönülür.
  4. Servisten edilinlen RedirectURL, client ekranında iframe içinde ya da redirect olarak açılır.
  5. Kullanıcı Lidio Hosted Ödeme ekranlarında gerekli ödeme bilgileri girişini/seçimini yapar ve Devam'a basar.
  6. Kullanıcı faslı tamamlandığında, işlem banka/kurum provizyonuna gönderilir ve işlem sonuçlanır.
  7. Ödeme işlem sonucu ile birlikte (query string parametreleri) işyeri ReturnURL'ine dönüş sağlanır. İşyeri işlem sonucunu doğrulamak ve daha fazla detay edinmek için GetHostedPaymentStatus servisini çağırır. (Not: Alternatif veya tamamlayıcı olarak işyeri tercihine bağlı olarak işlem sonucu işyerine Ödeme Notifikasyonu (server->server) yapıda da bildirilebilir.
  8. İşyeri işlem sonucunu doğrulamak ve daha fazla detay edinmek için GetHostedPaymentStatus servisini çağırır.
  9. GetHostedPaymentStatus sonucu işyerine döner. İşyeri mukayese ve kontrollerini yapar. Sonucu işler.
  10. İşyeri kullanıcıya sonucu gösterir. Kullanıcı sürecini, teyit ettiği başarılı/başarısız sonuca göre devam ettirir.
  11. Fraud kontrol (sahtecilik tespit) kullanılıyorsa, işleme dair FraudControlResult değeri de takip edilir. Asenkron sonuç söz konusu olacak ise (InProcess), ödeme sonucu başarılı da olsa, kesin sonuç için Ödeme Notifikasyonu gelene dek sipariş/teslimat beklemede tutulur.