MOKA ÖDEME SERVİSİ ORTAK ÖDEME SAYFASI ENTEGRASYON DOKÜMANI V

Ebat: px

Şu sayfadan göstermeyi başlat:

Download "MOKA ÖDEME SERVİSİ ORTAK ÖDEME SAYFASI ENTEGRASYON DOKÜMANI V"

Asli Sökmen
5 yıl önce
İzleme sayısı:

1 MOKA ÖDEME SERVİSİ ORTAK ÖDEME SAYFASI ENTEGRASYON DOKÜMANI V 2.0 TEMMUZ 2017 Elif YETİMOĞLU Sayfa 1

2 Test Domain: Prod Domain: Servislerin Çağrılması: Moka ortak ödeme servisi JSON POST yöntemiyle çalışmaktadır. Aşağıda servis için verilen servis adresi test domain inin sonuna eklenerek oluşan URL e, yine aşağıdaki servis için detaylı bir şekilde örnekleriyle verilen parametreler JSON nesnesi olarak POST edilir. Örnek: Test domain için, URL şu şekilde olacak Servislerden Yanıt Alınması: Moka servisleri yanıt olarak ApiResponse nesnesi döner. Bu nesnenin ResultCode ve Data alanları okunarak akışlar yönetilebilir. ApiResponse Data ResultCode ResultMessage Exception Sayfa 2

3 Servis Adı Servis Adresi ORTAK ÖDEME SAYFASI - URL OLUŞTURMA İSTEĞİ /Api/WebPos/CreateWebPosRequest PaymentDealerAuthentication DealerCode Moka sistemi tarafından verilen bayi kodu Username Moka sistemi tarafından verilen kullanıcı adı Password Moka sistemi tarafından verilen şifre CheckKey Kontrol anahtarı (DealerCode + MK + Username + PD + Password) bilgileriyle elde edilen anahtar SHA-256 hash algoritmasından geçirilerek bu alanda gönderilecektir İstek Parametreleri WebPosRequest OtherTrxCode Mutabakat sağlamak için kendi Transaction (İşlem) Kodunuzu bu alanda gönderebilirsiniz. (Boş da gönderilebilir) Amount (decimal) Ödeme tutarı (Kuruş kısmı nokta ile yazılır. Örn: 27.50) Currency Para birimidir. Aşağıdaki değerlerden birini alır; InstallmentNumber (integer) IsThreeD (bool) RedirectUrl SubMerchantName Language ClientWebPosTypeId (integer) Description BuyerInformation (Array) (opsiyonel) TL, USD, EUR, GBP, JPY Taksit Sayısı. Opsiyonel alandır, hiç gönderilmezse, boş gönderilirse, 0 veya 1 gönderilirse Peşin satış demektir, Taksit için 2 ile 9 arasında bir değer gönderilmelidir. 0: Doğrudan ödeme için ortak ödeme sayfası oluşturulur. 1: 3D ödeme için ortak ödeme sayfası oluşturulur. Doğrudan satış yetkisi yok ise, 3D ödeme olarak kabul edilip ödeme oluşturulur. Ödeme işlemi sonucunda, başarılı ya da başarısız işlem sonucunun döndürüldüğü ve kullanıcının yönlendirildiği bayi web sayfası Ekstrede görünmesini istediğiniz isim Mokaya önceden bildirilmeli Kullanıcıya gösterilecek arayüzün dili. İngilizce dil seçeneği için "en", varsayılan olarak gelen dil seçeneği türkçe için "tr" yazılır veya alan boş gönderilir. Ortak ödeme olabilmesi için bu alanın değeri "1" olarak gönderilmelidir. Açıklama alanıdır(opsiyonel). Ödemeye ilişkin bir açıklama yazmak istenirse bu alana yazılabilir.(200 karaktere kadar yazılabilir.) BuyerFullName Opsiyonel alandır.alıcının adı ve soyadıdır. Buyer Opsiyonel alandır.alıcının e- posta adresidir. BuyerGsmNumber Opsiyonel alandır.alıcının cep telefonu numarasıdır. BuyerAddress Opsiyonel alandır.alıcının adresidir. Sayfa 3

4 Örnek İstek (JSON) Başarılı İstek Sonucu Başarılı Sonuç Örneği { "PaymentDealerAuthentication": { "DealerCode": "xxx", "Username": "xxx", "Password": "xxxx", "CheckKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }, "WebPosRequest": { "OtherTrxCode": "3D5ABC24-456", "Amount": 1, "Currency": "TL", "InstallmentNumber": 1, "IsThreeD": "true", "RedirectURL": " "ClientWebPosTypeId": 1, "Language":"", "SubMerchantName" : "", "Description":"test açıklama", "BuyerInformation": { "BuyerFullName": "Elif Yetimoğlu", "Buyer ": "elif@elif.com", "BuyerGsmNumber": " ", "BuyerAddress": "Cumhuriyet Mahallesi Taşdelen/Çekmeköy" } } } Başarılı bir istek sonucu olarak geri dönüş nesnesinin ResultCode alanında Success, Data alanında Ortak Ödeme Sayfasının URL si bulunur. Bu link yeni bir web sayfası olarak açıldığında ödeme sayfasına ulaşılmış olur. {"Data":" Sayfa 4

5 Başarısız İstek Sonucu ResultCode Açıklama ClientWebPos.CreateWebPosRequest.InvalidRequest Geçersiz istek ClientWebPos.CreateWebPosRequest.InvalidAccount Böyle bir bayi bulunamadı ClientWebPos.CreateWebPosRequest.RedirectURLNot Redirect url verilmemiş Given ClientWebPos.CreateWebPosRequest.ForeignCurrenc Yabancı para ile ödeme bayi ynotavailableforthisdealer için tanımlı değil PaymentDealer. Bayi için tanımlı günlük CheckDealerPaymentLimits.DailyDealerLimitExceed limitlerden herhangi biri ed aşıldı PaymentDealer.CheckDealerPaymentLimits.DailyCar Gün içinde bu kart dlimitexceeded kullanılarak daha fazla işlem yapılamaz Bayi için tanımlı aylık ClientWebPos.CreateWebPosRequest.MonthlyDealerL limitlerden herhangi biri imitexceeded aşıldı ClientWebPos.CreateWebPosRequest.ThreeDRequired 3d zorunlu ClientWebPos.CreateWebPosRequest.InstallmentNot Yabancı para ile taksit AvailableForForeignCurrencyTransaction yapılamaz ClientWebPos.CreateWebPosRequest.ThisInstallmen Bu taksit sayısı bu bayi için tnumbernotavailablefordealer yapılamaz ClientWebPos.CreateWebPosRequest.InvalidInstall Taksit sayısı 2 ile 9 arasıdır mentnumber ClientWebPos.CreateWebPosRequest. Sanal Pos bu taksit sayısına ThisInstallmentNumberNotAvailableForVirtualPos izin vermiyor PaymentDealer.DoDirectPayment3dRequest.InvalidS Bayiye tanımlanmış ubmerchantname submerchant var ve hatalıysa PaymentDealer.CheckCardInfo.InvalidCardInfo EX Kart bilgilerinde hata var Beklenmeyen bir hata oluştu. Başarısız Sonuç Örneği {"Data":null,"ResultCode":" ClientWebPos.CreateWebPosRequest.ForeignCurrencyNotAvailableForThisDealer", "ResultMessage":"","Exception":null} Sayfa 5

6 ÖDEME İŞLEMİ HATA KODLARI 000 Genel Hata 001 Kart Sahibi Onayı Alınamadı 002 Limit Yetersiz 003 Kredi Kartı Numarası Geçerli Formatta Değil 004 Genel Red 005 Kart Sahibine Açık Olmayan İşlem 006 Kartın Son Kullanma Tarihi Hatali 007 Geçersiz İşlem 008 Bankaya Bağlanılamadı 009 Tanımsız Hata Kodu 010 Banka SSL Hatası 011 Manual Onay İçin Bankayı Arayınız 012 Kart Bilgileri Hatalı - Kart No veya CVV2 013 Visa MC Dışındaki Kartlar 3D Secure Desteklemiyor 014 Geçersiz Hesap Numarası 015 Geçersiz CVV 016 Onay Mekanizması Mevcut Değil 017 Sistem Hatası 018 Çalıntı Kart 019 Kayıp Kart 020 Kısıtlı Kart 021 Zaman Aşımı 022 Geçersiz İşyeri 023 Sahte Onay Sayfa 6

Benzer belgeler

MOKA ÖDEME SERVİSİ IFRAME ENTEGRASYON DOKÜMANI

MOKA ÖDEME SERVİSİ IFRAME ENTEGRASYON DOKÜMANI V 2.0 TEMMUZ 2017 Elif YETİMOĞLU Sayfa 1 Servislerin Çağrılması: Moka iframe servisi JSON POST yöntemiyle çalışmaktadır. Aşağıda servis için verilen servis