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 callbackUrline 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.