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.

   

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.

   

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ı

Ön Onaylı Kredi Sorgulama

Ön onaylı kredi süreci kullanılıyorsa, body requestinde additionalParams altında fingate başlığıyla isPreApproved parametresi ile kredi başvuru durumunu belirtebilirsiniz. Bu bilginin true olması durumunda, müşteri bilgilerinin iletilmesi zorunludur. Bu durumda tüm kredi seçenekleri (ön onaylı krediler dahil) listelenir. isPreApproved parametresi gönderilmezse veya false değeri alırsa, müşteri bilgileri gönderilmesi zorunlu değildir. Bu durumda sadece normal krediler sorgulanır.

Ön onaylı kredi seçenekleri sorgulandığında, eğer ön onaylı kredi durumunu karşılayan bankalar varsa her bir dönen veri içerisinde preApprovedApplicationId alanı bulunur. Bu ID, sonraki aşamalarda kredi başvurusu yapmak için kullanılır. Eğer ön onaylı kredi durumu karşılanmıyorsa, bu alan dönmez.

Request Parametreleri:

Parametre	Tip	Zorunlu	Açıklama
buyerBirthdate	String	Evet	Müşteri doğum tarihi. YYYY-MM-DD olmalıdır.
buyerPhoneNumber	String	Evet	Müşteri telefon numarası 5xxxxxxx şeklinde olmalıdır.
buyerIdentityNumber	String	Evet	Müşteri T.C kimlik numarası.
isPreApproved	Boolean	Hayır	Ön onaylı kredi sorgulama yapmak için kullanılır. Varsayılan değeri false'dir.

Örnek Request:

 "additionalParams": {
  "buyerBirthdate": "1990-01-01",
  "buyerPhoneNumber": "5555555555",
  "buyerIdentityNumber": "11111111110",
  "fingate": {
    "isPreApproved": true
  }
}

Yukarıdaki örnek request ile ön onaylı kredi sorgulaması yapılabilir. Eğer ön onaylı kredi karşılanan bankalar varsa aşağıdaki gibi preApprovedApplicationId alanı dönecektir. Bu alanın dönmediği bankalar ön onaylı kredi kullanımına uygun değildir.

Örnek Response:

{
  "data": {
  "bankOffers": [
    {
    ...
      "bankCode": "012",
      "preApprovedApplicationId": "12345678",
    ...
    }
  ]
}

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.

Ödeme Akışı Süreci ve init Servisi

init Servisi, kredi başvurusunu başlatan ana adımdır. Bu serviste aşağıdaki akışlar desteklenir:

1. Hosted Page Akışı:

   • Müşteri Craftgate tarafından yönlendirilir ve kredi başvurusu Fingate Hosted Page tarafında tamamlanır.
   • Bu akışta müşteri bilgileri (buyerBirthdate, buyerPhoneNumber, buyerIdentityNumber) gönderilmemelidir. Bu bilgiler Hosted Page tarafında alınır.

2. Doğrudan Başvuru Akışı:

   • Müşteri Craftgate tarafından yönlendirilir ve kredi başvurusu banka tarafında tamamlanır.
   • Müşteri bilgileri ve diğer zorunlu alanlar(bankCode, preApprovedApplicationId, totalTerm ) eksiksiz gönderilmelidir.

Request Parametreleri:

Parametre	Tip	Zorunlu	Açıklama
bankCode	String	Hayır	Banka kurum kodları (Offers servisinden ilerlenmek istenen bankanın serviste dönen kodu gönderilmelidir) isHostedPage parametresi true olarak gönderildiği durumda bu alan geçilmemelidir.
totalTerm	Integer	Hayır	Ekranda seçilen vade bilgisi (Doğrudan başvuru akışında zorunludur) isHostedPage parametresi true olarak gönderildiği durumda bu alan geçilmemelidir.
preApprovedApplicationId	String	Hayır	Offers servisinde ön onaylı krediler için sorgulama sonucu dönen ID. Hosted Page akışında gönderilmez.
isHostedPage	Boolean	Hayır	Hosted Page akışını belirtir. true ise Hosted Page kullanılır, false ise doğrudan başvuru yapılır. Varsayılan: false.

Hosted Page ve Doğrudan Başvuru Karşılaştırması:

Parametre	isHostedPage=true (Hosted Page)	isHostedPage=false (Doğrudan Başvuru)
bankCode	Gönderilmez	Gönderilmelidir
totalTerm	Gönderilmez	Gönderilmelidir
preApprovedApplicationId	Gönderilmez	Gönderilmelidir
buyerBirthdate	Gönderilmez	Gönderilmelidir
buyerPhoneNumber	Gönderilmez	Gönderilmelidir
buyerIdentityNumber	Gönderilmez	Gönderilmelidir

Örnek Hosted Page Request:

"additionalParams": {
  "fingate": {
    "isHostedPage": true
  }
}

Örnek Doğrudan Başvuru Request:

{
  "bankCode": "012",
  ...,
  "additionalParams": {
    "buyerBirthdate": "1990-01-01",
    "buyerPhoneNumber": "5555555555",
    "buyerIdentityNumber": "11111111110",
    "fingate": {
      "isHostedPage": false,
      "preApprovedApplicationId": "12345678",
      "totalTerm": 12
    }
  }
}

Callback ve additionalAction Değerleri

Ü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ğer	Açıklama
NONE	Otomatik onaylı kredi başvuru sürecinde kullanılır. Kredi müşteriye kullandırılmış ve üye işyeri ödemesini almıştır.
APPROVAL_REQUIRED	Otomatik 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_WEBHOOK	Otomatik 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_REQUIRED	Kredi 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