BKM Express ile Ödeme Alma
Öncelikle Yapılması Gerekenler
BKM Express ile ödeme almak için şu adımları tamamlamış olmalısınız.
Üye İşyeri Paneli > Yönetim > Üye İşyeri Ayarları > Craftgate Özellikleri listesinde BKM Express
Açıkolmalıdır.
Üye İşyeri Paneli > Yönetim > Üye İşyeri Ayarları > BKM Express Ayarları bölümüne BKM Express tarafından size iletilmiş bilgileri giriniz.
Üye İşyeri Paneli > Yönetim > Üye İşyeri Ayarları >Webhook Ayarları bölümünden BKM_EXPRESS_PAYMENT_NOTIFICATION etkinleştirilmelidir.
Üye İşyeri Paneli > Yönetim > POS Yönetimi ekranından ödeme almak istediğiniz Sanal Posunuzda BKM_EXPESS etiketini ekleyiniz.
BKM Express Ödeme Başlatma
BKM Express Ödeme Başlatma için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir. Oluşturulan token değerlerini BKM tarafından sağlanan Client SDK'ya ileterek BKM Express uygulamasını başlatabilirsiniz.
İstek Parametreleri
Ödeme başlatmak için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.
İstekle beraber gönderilip, cevapla birlikte alınabilecek, "bumerang" değer. Farklı istekleri birbirleriyle ilişkilendirmek için kullanılabilir. Genellikle üye işyerinin ödemeye ilişkin sipariş numarası kullanılır. Sipariş numarası ile kullanmanız sonradan işlemleri incelemenize yardımcı olacaktır.
Toplam ödeme tutarı. Sepetteki ürün/hizmet tutarları toplamının bu tutara eşit olması gerekmektedir
Komisyon ve indirim gibi farklar dahil edilerek hesaplanan, karttan çekilecek nihai tutar. Tamamı ya da bir kısmı cüzdandan tahsil edilen ödemelerde cüzdandan tahsil edilecek tutar da bu tutara dahildir. İşlemde vade farkı var ise vade farkı eklenmiş tutar bu parametreye girilmelidir.
Ödemenin ilişkilendirildiği alıcı ID'si. Üye işyerinin kendi sistemlerindeki ID değerini değil, Craftgate sistemlerindeki ID değerini ifade eder
Eğer yollanırsa kullanıcıya bu değerlere ait taksit olanakları ödeme ekranında gösterilir. Eğer ilgili pos üzerinde bu taksit seçenekleri aktif değilse taksit seçenekleri gösterilmez. Tek taksit seçeneği her zaman varmış gibi kabul edilir. Yollanmadığı durumda tek taksit seçeneği geçerlidir.
Ödeme alınırken bankaya iletilecek orderId parametresi. Opsiyonel olduğu için gönderilmemesi ve orderId değerinin Craftgate tarafından üretilmesi önerilir.
Ödemeye ilişkin kırılım bilgileri. En az bir kırılım gönderilmesi ve gönderilen kırılımların tutarlarının toplamının price alanına eşit olması zorunludur
Dönüş Parametreleri
Ödeme başlatma sonucunda dönen parametreler de aşağıdaki gibidir:
Ticket id
BKM token değeri
BKM token path'i.
Ödeme Tamamlama
BKM Express uygulamasında kullanıcı OTP doğrulaması yaptıktan sonra Craftgate tarafından callbackUrl'e siparişe ait detaylar iletilir. Gerekli kontrolleri yaptıktan sonra tamamlama isteği gönderilerek sürecin tamamlanması beklenir.
İstek Parametreleri
Ödemeyi tamamlamak için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıda listelenmiştir.
Ödemenin başarılı olarak tamamlanmasını istiyorsanız true; aksi durumda false gönderilmelidir
Ödemeye ait gönderilmek istenen mesaj
Ödemeye ait ticket id değeri
Dönüş Parametreleri
Ödeme işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:
Ödemenin ID'si. Bu değer ödeme isteği için Craftgate tarafından belirlenen eşsiz değerdir. Veritabanınızda sipariş bilgileri ile eşleştirip saklamayı unutmayınız.
Ödemenin gerçekleştirildiği tarih
Ödemenin toplam sepet tutarı
Müşterinin ödediği toplam tahsilat tutarı. Tamamı ya da bir kısmı cüzdandan tahsil edilen ödemelerde cüzdandan tahsil edilecek tutar da bu tutara dahildir
Cüzdandan tahsil edilen tutar
Ödemeye ilişkin para birimi. bkz: Para Birimleri
Alıcı üyeyle ilişkilendirilmiş ödemelerde yer alan, ilgili üyenin ID'sini belirten değer
Ödemenin taksit sayısı
Üye işyeri tarafından ödeme isteği içerisinde gönderilen conversationId değeri
bkz: Ödeme Tipleri
bkz: Ödeme Durumu
Ödemenin 3D Secure ile gerçekleştirilip gerçekleştirilmediği
Son kullanıcıya yansıtılan vade farkı oranı
Son kullanıcıya yansıtılan vade farkı tutarı. paidPrice ile price arasındaki farka eşittir
Banka komisyon oranı
Banka komisyon tutarı
Ödemenin saklı kartla gerçekleştirilip gerçekleştirilmediğini belirtir
Kartın ilk 8 hanesini belirtir. Tamamı cüzdan ile ödenen ödemelerde boş gelir.
Kartın son 4 hanesini belirtir. Tamamı cüzdan ile ödenen ödemelerde boş gelir
Kart sahibinin adı/soyadı
Bankada kayıtlı olan kart sahibi adı/soyadı. Bazı durumlarda PF poslarında dönüş null olabilir
Ödemeye ilişkin banka tarafından verilen authCode değeri. Tamamı cüzdan ile ödenen ödemelerde boş gelir. Bazı durumlarda PF poslarında dönüş null olabilir
Ödemeye ilişkin banka tarafından verilen hostReference değeri. Tamamı cüzdan ile ödenen ödemelerde boş gelir
Ödemeye ilişkin banka tarafından verilen transId değeri. Tamamı cüzdan ile ödenen ödemelerde boş gelir. Bazı durumlarda PF poslarında dönüş null olabilir
Ödemeye ilişkin banka tarafından verilen orderId değeri
(bkz: Kart Tipleri) Kartın tipini ifade eder. Tamamı cüzdan ile ödenen ödemelerde boş gelir
Kartı sağlayan kart kuruluşuunu ifade eder. Tamamı cüzdan ile ödenen ödemelerde boş gelir
Ödemenin alındığı kartın ailesini belirtir. Tamamı cüzdan ile ödenen ödemelerde boş gelir
Ödemenin alındığı pos bilgileri
Ödeme isteği yapılırken gönderilen kırılım bilgileri ile, ödemenin bu kırılımlar bazındaki fiyatlama ve para gönderimi bilgilerini içerir