Craftgate ödeme formu ile kolayca ödeme almaya başlayabilir ve taksit kontrolleri, önyüz ödeme kontrolleri, BIN sorgulama, 3D secure ile ödeme ve kart saklama gibi özellikleri herhangi bir ek geliştirme maliyeti olmadan kullanabilirsiniz. Ortak ödeme sayfası kullanımı iki adımda tamamlanır. Bkz: Ortak Ödeme Sayfası ile Ödeme Alma
Üye işyeri Craftgate API üzerinden ödeme formu başlatma isteğini yolladıktan sonra cevap olarak pageUrl
ve token
parametreleri üye işyerine döner. Bu adımdan sonra kullanıcı pageUrl
parametresindeki URL değerini tarayıcısı ile açtığı zaman ödeme formunu görecektir. İsteğe bağlı olarak bu URL'e iframe=true
parametresi eklenerek sayfa iframe olarak gösterilebilir. Aynı şekilde URL'e animatedCard=true
parametresi eklendiğinde ortak ödeme sayfasına kullanıcı input'u ile şekillenen bir kart görseli de eklenebilir.
Kullanıcı sayfada gerekli yerleri doldurup kart bilgilerini girdikten sonra ödemesini tamamlar. Ödeme formu kullanarak kullanıcı isteğe bağlı olarak kartını saklayabilir ya da ödeme formu isteği başlatılırken cardUserKey
parametresi üye işyeri tarafından doldurulursa saklı kartlarını kullanabilir.
Ödeme işlemi başarılı ya da başarısız olarak tamamlandıktan sonra üye işyerinin ödeme formu isteği oluşturulurken doldurduğu callbackUrl
alanındaki URL adresine ödeme formu isteğine istinaden oluşturulan token
bilgisi dönülür.
Craftgate API ödeme sonrası callbackUrl
alanındaki adrese token
bilgisi ilettikten sonra tekrar Craftgate API üzerinden ödeme formu sonucunu sorgulamalısınız.
Token bilgisini kullanarak yapılan bu sorgulama sonucu ödemeye dair detayları, hata alıp almadığını ve aldıysa hangi hatayı aldığını görebilirsiniz.
Kötü niyetli kişiler, daha önce tamamladığı düşük tutarlı bir ödemenin token bilgisini üye işyerinin callbackUrl
ine dönebilir. Burada üye işyeri, iletilen ödemenin detaylarını token
bilgisi ile Craftgate'ten çekmeli ve externalId
, conversationId
, paymentId
gibi bilgiler ile kendi siparişine ait ödemenin bilgilerini karşılaştırarak, iletlen isteğin Craftgate'ten geldiğinin doğruluğunu MUTLAKA teyit etmelidir.
Ortak Ödeme Formu ile yapılan ödemelerde cüzdan kullanımı, taksit seçme gibi işlemler son kullanıcı tarafından ödeme esnasında belirlenmektedir. Üye işyeri, ödeme formu sonucundaki bilgileri kullanarak kendi sistemindeki taksit sayısı (installment), tahsil edilen tutar (paidPrice) ve cüzdandan tahsil edilen tutar (walletPrice) bilgilerini güncellemelidir.
Ortak Ödeme Formu ile ilgili detaylara Ortak Ödeme Sayfası ile Ödeme Alma sayfasından ulaşabilirsiniz.