Kredi İşlem Sonucu Callback ve Webhook Dinlenmesi

Alışveriş Kredisi İşlem Sonucu ve Webhook Entegrasyonları

Alışveriş kredisi entegrasyonu dahilinde, kredi sonuçlarını dinlemek için, yeni bir callback endpointi geliştirmesi yapmalı ve Webhook bildirimleri almıyorsanız Webhook Bildirimleri kısmındaki yönlendirmelere göre geliştirmeleri yapmalısınız. Bu endpointlerden gelecek çağrıları/bildirimleri dinleyerek kendi tarafınızda ödeme işlemlerinizi ilerletebilirsiniz.

Alışveriş kredisi sonucunda finansman kuruluşları veya bankalar tarafında işlemler bittiğinde; init isteği sırasında Craftgate sistemine ilettiğiniz callbackUrl adresine aşağıdaki parametrelerle beraber dönüş yapılacaktır. Bu dönüşün Craftgate sisteminden yapıldığının kontrol edilmesi gerekmektedir. Bunun için Güvenlik Önerileri kısmındaki Hash Değerinin Oluşurulması ve Kontrolü adımına bakmanız gerekmektedir.

Callback URL'e İletilen Parametreler

Aşağıdaki parametreler form variable olarak HTTP POST metodu kullanılarak iletilir. Üye işyerinin callback adresine kullanıcı tarayıcısından ulaşılacağı için, bu adres internete açık olmalı ve application/x-www-form-urlencoded content-type'ını karşılayabilmelidir.

Doğrulama sonrası Craftgate tarafından callbackUrl'e yapılacak istekte yer alan parametreler aşağıdaki gibidir:

paymentId

number

BNPL Ödeme ID'si. Ödemeye ilişkin Craftgate API tarafından türetilen ID değeridir

paymentStatus

string

BNPL ödemesinin durumunu gösterir. Ödeme durumu başarılıysa SUCCESS, bekleme durumundaysa WAITING, başarısızsa FAILURE değerini alacaktır

additionalAction

string

Ödemenin devam etmesi için alınması gereken bir aksiyon varsa o değeri ifade eder

conversationId

string

Ödeme başlatma isteğinde gönderilen conversationId parametresinin değeri

callbackStatus

string

Bankanın veya son kullanıcının 3DS doğrulama adımını tekrar tetiklemesi durumunda, ödeme daha önceden doğrulanmış ise gönderilir. Status alanı FAILURE değerini alırken, callbackStatus değeri ALREADY_RETURNED olarak gönderilecektir. Bu alan ALREADY_RETURNED değeriyle geldiği durumda, sisteminizde ödemenin durumu kontrol edilmeli ve tamamlanmışsa bir aksiyon alınmamalıdır.

hashParams

string

Hash hesaplamasında kullanılan parametrelerin sıralı olarak gönderildiği alandır. : karakterine göre parametreler ayrıştırılarak, ilgili parametre değerleri ard arda eklenerek hash hesaplamasına dahil edilmelidir.

hash

string

Üye İşyeri Callback Key değerinin, hashParams alanında açıklandığı şekilde ilgili değerlerin oluşturularak birleştirilip Sha-256 Hex algoritması ile şifrelenmesi sonucu oluşan değerdir. Hash değerinin oluşturması için örnek kodlar aşağıda yer almaktadır.

Başarılı bir entegrasyon yapmak için Callback dönüşü haricinde Craftgate sisteminin sunduğu Webhook mekanizmasını da geliştirmeniz gerekmektedir. Kredi süreçleri farklı bankalar, entegratörler ve finansman kuruluşlarında farklı şekilde yürütülmektedir. Asenkron olarak yürütülmesi gereken süreçler bulunduğundan Webhook mekanisması takip edilmeli ve BNPL_NOTIFICATION bildirimi dinlenmelidir.

callbackUrl'e yapılan HTTP POST işlemi ve Webhook bildirimi içerisinde bulunan paymentStatus ve additionalAction parametrelerine göre aşağıdaki kurguları kendi sisteminizde geliştirmeniz gerekmektedir.

paymentStatus değerleri:

Değer	Açıklama
SUCCESS	Kredi sürecinin ve ödemenin başarılı bir şekilde tamamlandığını bildirir.
FAILURE	Kredi sürecinin başarısız sonuçlandığını bildirir.
WAITING	Kredi sürecinin devam etmekte olduğunu bildirir. additionalAction değerlerine göre aksiyon alınır.

additionalAction değerleri:

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ı Alışveriş Kredisi Onaylama ç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.