Ana içeriğe geç

FinGate

Craftgate alışveriş kredisi yöntemlerinden FinGate ile entegredir. Craftgate API kullanarak, FinGate üzerinden ödeme planı sorgulayabilir, kredi başvurusunda bulunabilir ve kredi kullandırma ile ödeme alabilirsiniz.

Öncelikle Yapılması Gerekenler

FinGate entegrasyonunu kullanabilmek için aşağıdaki adımları tamamlamış olmalısınız:

  1. Üye İşyeri Paneli > Yönetim > Üye İşyeri Ayarları > Craftgate Özellikleri listesinde Alternatif Ödeme Yöntemleri Açık olmalıdır.

    Craftgate özellikleri listesinde Alternatif Ödeme Yöntemleri
  2. Üye İşyeri Paneli > Yönetim > APM Yönetimi > FinGate durumunu Aktif yapıp, Düzenle butonu ile FinGate tarafından size iletilmiş bilgileri giriniz.

    Maslak Entegrasyon Ayarları

Banka Ödeme Planı Sorgulama

Craftgate üzerinden alışveriş kredisi kullanılarak yapılacak ödemelerde ürüne ait bazı bilgileri göndererek alışveriş kredisi kullanılabilecek bankalar ve bu bankalara ait ödeme planı sorgulanabilir.

Ödeme planı sorgulaması banka bazında değişiklik göstermekte olup, bazı bankalar ödeme plan detaylarını dönmeyebilirler.

BDDK kısıtlamaları nedeniyle sorgulama yapılırken ürüne ait miktar, tutar ve kategori bilgisi gönderilmelidir. Craftgate tarafından tanımlanan kategori kodlarını inceleyebilirsiniz: bknz. Kategori Kodları

Bkz: Banka Ödeme Planı Sorgulama

FinGate Alışveriş Kredisi ile Ödeme Akışı

Ödeme planı sorgulandıktan sonra kredi kullanılacak banka seçilir ve ödeme akışına geçilir. Craftgate üzerinden alışveriş kredisi ödeme akışı tetiklenerek kredi başvuru süreci başlatılır. Müşteri, ödeme isteği cevabında alınan banka linkine yönlendirilerek banka üzerinde kredi başvurusu sürecinin başlaması sağlanır. Kredi başvurusu yapılan bankaya göre ödeme akışları farklılaşabilmektedir.

Otomatik onaylı kredi başvuru sürecine sahip bankalarda (İş bankası, Akbank, TEB) kredi başvurusu banka tarafından onaylandığında Craftgate sistemine çağrı yapılır ve müşterinin ödeme başlatma isteğinde gönderdiği callbackUrl adresine yönlendirilerek alışveriş kredisi ile ödeme alma işlemi sonlandırılır.

Otomatik onay gelmeyen bankalar (Fibabank, Denizbank) için yapılan başvurularda süreç müşteri anlaşmalarına göre değişkenlik gösterebilmekle beraber, banka tarafında kredi onaylandığı zaman "Kredi kullanılmaya hazır" durumuna geçilir ve üye işyeri tarafından kredi kullandırılmak için son bir kredi onay servis çağrısı yapılması beklenir.

Üye işyeri tarafında Craftgate tarafından yapılan callbackUrl içerisindeki additionalAction parametresine göre bu akışlar kurgulanmalıdır. callbackUrl adresine yapılacak çağrı parametreleri için Alışveriş Kredisi Dönüşü sayfası incelenmelidir. additionalAction değerleri aşağıdaki gibidir:

DeğerAçıklama
NONEOtomatik onaylı kredi başvuru sürecinde kullanılır. Kredi müşteriye kullandırılmış ve üye işyeri ödemesini almıştır.
APPROVAL_REQUIREDOtomatik onay ile çalışılmadığında kullanılır. Kredi kullanıma hazır durumundadır. Üye işyeri tarafından kontroller sonrası Kredi onay servis çağrısı yaparak kredi kullandırılır.
WAIT_FOR_WEBHOOKOtomatik onay ile çalışmayan ve başvuru süreci devam eden bankalar için kullanılır. Kredi başvurusu değerlendirme sürecindedir. Süreç tamamlandığında Craftgate sistemine bilgilendirme yapılacaktır. Craftgate de Webhook Bildirimi ile üye işyerine bilgilendirme geçecektir. Webhook mesajında additionalAction değeri kontrol edilerek Kredi onaylama servis çağrısı yapılarak kredi kullandırılabilir.
VERIFY_REQUIREDKredi kullanım durumu sorgulanamadı ya da belirsiz. Üye işyeri tarafından Alışveriş Kredisi Doğrulama servis çağrısı yapılarak tekrar sorgulanması gereklidir.

Bkz: Alışveriş Kredisi ile Ödeme

Alışveriş kredisinin kullandırılacağı kanalı belirtmek için additionalParams içerisindeki channel parametresini kullanabilirsiniz. Bu değer, WEB ve MOBILE olabilir.

"additionalParams": {
"channel": "WEB"
}

Alışveriş Kredi Onaylama

Kredi başvuru süreci sonucunda üye işyeri callbackUrl adresine ya da -çalışılan bankalara ve anlaşmaya göre WAIT_FOR_WEBHOOK gelmesi durumunda- webhook adresine additionalAction parametresi olarak APPROVAL_REQUIRED gelmesi sonrasında, üye işyeri kendi tarafında kontrolleri gerçekleştirip krediyi onaylamak için Craftgate tarafında kredi onaylama servisini çağırması gerekmektedir.

Bkz: Alışveriş Kredisi Onaylama