Ödeme Formu
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
- Ortak ödeme formu ile ödeme alma
- Ortak ödeme formu sonucu sorgulama
Adım 1. Ortak Ödeme Formu ile Ödeme Alma
Ödeme Formu Başlatma
Ü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.
Müşterinin ödemeyi form üzerinden tamamlaması
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 sonunda token bilgisinin iletilmesi
Ö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.
Adım 2. Ortak Ödeme Formu Sonucu Sorgulama
Ödeme detaylarının çekilmesi
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.
Ödeme sonucu için güvenlik kontrolünün yapılması
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.
Ödeme detaylarının üye işyerinde güncellenmesi
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.