Başlangıç Hedef Kitle Bu doküman; ödeme servisi deneyimi olan, e-ticaret sitelerinde ve/ya dahili ödeme platformunun entegrasyonunu yapacak olan teknik personel için hazırlanmıştır. ERP sistemlerinde online ödeme için Paratika kullanılmıştır. Üye İş Yeri / Müşteri Destek Birimine Ulaşım Ödeme işlemleri ya da bağlantınıza ilişkin sorunlar için 02123190625 numaralı telefondan ya da destek@paratika.com.tr adresinden Üye İş Yeri / Müşteri Desteği ile bağlantıya geçebilirsiniz. Telefon: 02123190625 e-Posta: destek@paratika.com.tr Paratika nedir? Paratika, Asseco SEE Türkiye tarafından geliştirilmiş olan bir online ödeme çözümüdür. Payten Turkey. Hem üye iş yerleri hem de üye iş yerlerinden işlem yapan müşteriler için güvenli, esnek, kolay ve kullanışlı bir ödeme deneyimi sunar. Müşteriler (Kart Hamilleri) ödeme sayfalarında bulunan güvenli e-cüzdan ve esnek ödeme özelliklerinden faydalanırken, üye iş yerleri ödemeleri kredi kartı verilerine dokunmaksızın yönetir ve PCI DSS uygunluklarını korur; bu sayede dolandırıcılık riskleri ortadan kaldırılır ve mali açıdan hassas olan verilerin güvenli şekilde depolanması sağlanır. Güvenlik Standartları Daha fazla bilgi edinmek için PCI DSS Veri Güvenliği Standartları Güvenlik Paratika sağlam ve güvenli bir iletişim protokolü üstüne inşa edilmiştir. Paratika API, standart HTTP(s) Post istekleri ile birlikte gönderilen bir talimatlar dizisidir, bakınız HTTPS Post istekleri. Sunucu tarafında, Verisign tarafından sağlanan sertifika kullanılmaktadır. SSL şifrelemesi sayesinde sunucularımızın sizinle iletişim kurması ve verilerinizin şifrelenmiş şekilde iletilmesi garanti edilmektedir. İstemci SSL sertifikasına ihtiyaç duyulmamaktadır. Bir istek alındığında şifreleme seviyesi kontrol edilir. Doğrudan TLSv1.1 ve üstü desteklenir. Desteklenen Diller API desteği, HTTP Post yöntemlerini uygulayan tüm platformları ve dilleri desteklemektedir. Cevap Mesajı Anlamlandırma Paratika cevaplarında varsayılan format JSON ’dur. Paratika cevaplarını işleyebilmek için JSON ayrıştırma araçları kullanılabilir. Test Ortamı API test ortamı kullanıma açıktır ve bu dokümanda yer alan tüm API işlem türleri yanda verilen link kullanılarak test edilebilir. Tüm API istekleri HTTP POST yöntemi kullanılarak bu URL adresine gönderilecektir. Paratika API Test Ortam URL Bilgisi https://test.paratika.com.tr/paratika/api/v2 Entegrasyon Ortamı API entegrasyon ortamı kullanıma açıktır ve bu dokümanda yer alan tüm API işlem türleri yanda verilen link kullanılarak test edilebilir. Tüm API istekleri HTTP POST yöntemi kullanılarak bu URL adresine gönderilecektir. Paratika API Entegrasyon Ortam URL Bilgisi https://entegrasyon.paratika.com.tr/paratika
İstek & Cevap (Request & Response) Paratika API İstekleri Paratika API ortamına bir istekte bulunmak için ilgili POST HTTP isteğinin Paratika API Endpoint URL adresine gönderilmesi gerekir. API URL’e gönderilen her bir HTTP POST isteği, isteğin tipine bağlı olarak ilgili “parametre-değer” ikilisi olarak kodlanmalıdır. Paratika API Cevapları Paratika API Cevabı JSON veri formatı kullanır ve destekler. Her bir api cevabı, RESPONSECODE ve RESPONSEMSG parametrelerini içermektedir. İlgili işlemin başarılı sonuçlanıp sonuçlanmadığına göre, bu parametreler belli değerler içerecektir. Eğer hata söz konusu ise; (RESPONSECODE 00 değilse), ERROR ve ERRORCODE parametreleri de cevaba eklenecektir. RESPONSECODE ve RESPONSEMESSAGE Alanları için Olası Değerler Cevap Kodu Cevap Mesajı Açıklama 00 Onaylı İşlem başarılı bir şekilde gerçekleşmiştir 98 Genel Hata Action failed due to general error. A general error can be a runtime error during action processing or a payment gateway error that is not yet mapped in our error set. 99 Reddedildi Bu cevap koduna (99) sahip hatalar, işlem sırasında kullanılan ödeme sistemi / sanal POS tarafında oluşan hatalardır. Bu durumlarda hata detaylarını da inceleyerek sanal pos sağlayıcı banka ya da ödeme sistemi sağlayıcısı ile iletişime geçmek gerekir. Pagination TO BE PROVIDED TO BE PROVIDED
Doğrulama API isteklerinde kullanıcı bilgilerinizi vererek kendinizi doğrulamanız beklenmektedir. API kullanıcı bilgilerinizi Paratika uygulamasındaki “Hesabım” linkinden güncelleyebileceğiniz gibi, gereken değişiklikleri Müşteri Destek ekibimize de iletebilirsiniz. Her bir API kullanıcısının kendi email adresi ve şifresi vardır. Paratika sistemine API üzerinden erişim ve işlem yapma yetkisi veren bu email adresi ve şifre bilgisinin kullanıcı tarafından gizli tutulması ve iyi saklanması gerekmektedir. Tüm API istekleri HTTPS üzerinden yapılmalıdır. Standard HTTP üzerinden yapılan istekler başarısızlıka sonuçlanacaktır. Doğrulama her bir API isteğinde yeniden yapılmaktadır. API İsteği Doğrulama (Authentication) Parametreleri MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT]
Entegrasyon Modelleri Barındırılan Ödeme Sayfası (HP) Bu model, ödeme akışı için Asseco SEE ortamlarında barındırılan Paratika ortak ödeme sayfalarını kullanır. Kart verisine dokunmadan yapılacak olan işlemde, işlem sonucu son adımda üye iş yeri sistemine aktarılır. Ortak ödeme sayfası kullanılarak gerçekleştirilen işlemler MO/TO ya da 3D Secure kullanımlı olarak yapılabilir. Adım 1: Üye iş yeri Web sitesi ortak ödeme sayfası modeli belirterek bir satış talebi yapar. Paratika ödeme sayfasında görüntülenecek ya da işlem aşamasında kullanılabilecek tüm Sipariş / Fatura / Üye iş yeri / Ürün / Kargo detayları da bu aşamada kabul edilir. Adım 2: Ödeme talebi sonucunda geçerli bir oturum anahtarı oluşturulur ve geri üye iş yeri sistemine gönderilir. Üye iş yeri Web Sitesi bu oturum anahtarını alır ve kart sahibi Paratika Ödeme Sayfaları'na yönlendirilir. Adım 3: Bu adımda üye iş yeri, kart sahibini Paratika ortak ödeme sayfalarına yönlendirir. Ortak ödeme sayfalarında açılan kart tanımlama, kayıtlı kart listesi, ürün detayları, taksit tablo panellerini kullanarak kart sahibi ödeme işlemini gerçekleştirme isteğini gönderir. Adım 4: Paratika finansal işlemi gerçekleştirerek işlem sonucunda kart sahibini üye iş yerinin ilk adımda belirttiği dönüş URL'ine gönderir. Bu son adımda kart sahibi tarafında oluşabilecek tarayıcı sorunları, işlemden vazgeçme, elektrik ya da internet kesintisi gibi durumlarda üye iş yeri işlem akıbetini API model sorgularını kullanarak öğrenebilir. İşlem başarılı olmuşsa üye iş yeri tarafında ilgili aksiyonlar alınır. Başarılı olmadığı durumlarda ise kart sahibi ilgili ödeme için tekrar ortak ödeme sayfalarına yönlendirilebilir. Barındırılan Ödeme Sayfası (HP) Akışı Direct POST - MOTO Bu entegrasyon modelinde ortak ödeme sayfalarında farklı olarak son kullanıcı görsel arabirim servisi Paratika tarafından yapılmaz. Tüm kullanıcı görsel arabirimlerini (user interfaces) kendi ortamlarında barındırmak, versiyonlamak ve yönetmek isteyen üye iş yerleri bu modeli kullanabilirler. %100 PCI DSS uyumluluğunu mümkün kılan bu modelde, aşağıda anlatıldığı şekilde üye iş yeri sisteminde / sayfasında sunulan form direkt olarak Paratika ortamlarına HTTP POST kullanılarak hassas veriye dokunmadan işlem desteği sağlanır. Üye iş yerleri müşterilerine kayıtlı kartlarla işlem yaptırabildiği gibi, yeni kartlarla da işlem imkanı sunar. Adım 1: Üye iş yeri sistemi gerekli tüm işlem / sipariş detaylarını vererek oturum anahtarı isteğini gönderir. Bu adımdaki verilerin hiçbiri hassas veri kapsamında bulunmaz. Adım 2: Oturum anahtarı isteği (Session token request) işlenerek tüm verilerin geçerli olması durumunda üye iş yeri kullanımına açılan oturum anahtarı paylaşılır. Adım 3: Elde edilen oturum anahtarı bilgisiyle üye iş yeri web sayfasında form gösterilir. Bu form kodu örneği için aşağıdaki bölümü inceleyebilirsiniz. Extra Puan Adimi: Üye is yeri Paratika Direct Post metodlarinda puan kullanimi için SESSIONTOKEN, CARDPAN,CARDEXPIRY ile puan sorgulama islemi yapmalidir. QUERYPOINTS dönüs degerine göre örnek form içindeki points alani doldurulmali. Puan ile satis örneklerine buradan ulasabilirsiniz. Ardindan puanli satis isteginin ilgili ödeme sistemine iletilmesi için SESSIONTOKEN ve BIN parametreleri ile QUERYPAYMENTSYSTEMS sorgusu yapilmali ve dönüs degerinde yer alan ödeme sistemi adi örnek form içinde paymentSystem alaninda gönderilmelidir. Adım 4: Kart sahibi, üye iş yeri sayfasında (ya da HTTP destekleyen herhangi bir mobil / masaüstü uygulama da olabilir) gösterilen formda gerekli alanları doldurarak işlem isteğini yapar. Üye iş yeri bu formdaki tüm alanları direkt olarak Paratika sistemine POST eder. Adım 5: Paratika tüm işlem detaylarını ve ödeme formundan gelen bilgileri kullanarak finansal işlemi gerçekleştirir. Bu süreçte kart sahibi Paratika tarafından servis edilen herhangi bir görsel arabirim görmeyecektir. Gerçekleştirilen bu işlem MOTO bir işlem niteliği taşır. Adım 6: Paratika bu işlem isteğini ilgili banka ya da ödeme sistemi terminaline taşıyarak işlemi gerçekleştirir. Daha sonra bu işlem sonucu ilk adımda belirtilen üye iş yeri dönüş URL adresine gönderilir. Aşağıdaki HTML Test formundaki TMX Javascript kısmının gönderilmesi zorunludur. Direct POST (MOTO) Test Formu Sample POST Form Pay with Card Token Card Owner Name Card Number (PAN) Expiration Date January February March April May June July August September October November December 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 Security Code (CVV) Save Card Card Name Installment Count >Card Token Installment Count Direkt POST MOTO Akışı Direct POST Cevap Parametreleri Parametre İsmi Get Value Açıklama merchantPaymentId request.getParameter('merchantPaymentId') Get from sessionToken apiMerchantId request.getParameter('apiMerchantId') Get from sessionToken paymentSystem request.getParameter('paymentSystem') Get from card Number PIN paymentSystemType request.getParameter('paymentSystemType') Payment System Type information paymentSystemEftCode request.getParameter('paymentSystemEftCode') Eft code of the payment system pgTranId request.getParameter('pgTranId') Transaction Id which come from bank side pgTranDate request.getParameter('pgTranDate') Transaction date at bank side pgTranRefId request.getParameter('pgTranRefId') Transaction Reference Id which is come from bank side pgTranApprCode request.getParameter('pgTranApprCode') Transaction Approval Code which is come from bank side pgOrderId request.getParameter('pgOrderId') PgOrderId which is the order id at bank side customerId request.getParameter('customerId') customerId which is the customer Id merchant side sessionToken request.getParameter('sessionToken') Return the session token which is created at sessionToken action cardToken request.getParameter('cardToken') Returned if transaction make with card Token random request.getParameter('random') Random value which is used at veriyfing the SD_SHA512 hash value sdSha512 request.getParameter('sdSha512') Used for hash verification secretKey is the private merchant key defined once for each merchant, formula :SHA512 encodeHexString((merchantPaymentId+'|'+customerId+'|'+sessionToken+'|'+responseCode+'|'+randomKey+'|'+secretKey)) SD_SHA512 request.getParameter('SD_SHA512') Deprecated / Legacy - Do not use! Used for hash verification. secretKey is the private merchant key defined once for each merchant, formula :SHA512(sessionToken + merchantPaymentId + responseCode + responseMsg + random + secretKey) pgTranErrorText request.getParameter('pgTranErrorText') Return only in error case; contains bank transaction error message pgTranErrorCode request.getParameter('pgTranErrorCode') Return only in error case; contains bank transaction error code pgTranErrorCode request.getParameter('pgTranErrorCode') Return only in error case; contains bank transaction error code errorCode request.getParameter('errorCode') Return only in error case; contains PF error code errorMsg request.getParameter('errorMsg') Return only in error case; contains PF error message responseCode request.getParameter('responseCode') Response code of the Paratika responseMsg request.getParameter('responseMsg') Response message of the Paratika Sample response for Direct Post Non 3D merchantPaymentId: PaymentId-FbnzDdx04fZu apiMerchantId: 700100000 paymentSystem: My Ä°Åbank VPOS Account (Test) paymentSystemType: ISBANK paymentSystemEftCode: 0064 pgTranDate: 20170113 12:20:35 pgTranId: 17013MUjC07014059 pgTranRefId: 701300002882 pgTranApprCode: 733185 pgOrderId: PaymentId-FbnzDdx04fZu sessionToken: FOEMQGVTVWOQCJRSS6DARRRV62RQK2FIKUY7ZMXKBNX6SOUJ random: -349886350 customerId: Customer-QjOnxH8Z SD_SHA512: bff497614a8767e3176fede4f3f8274225a8f619469a1c5eafe2e785fbc438aeb5345c51be30d976d53db5b73adf026347db1144c52cbc2133364aa13e933d45 sdSha512: 7f1485a24f1790e0791fe9de5ec33d4e98057578f77a4c39fdd4bd874079d6e3af9271da020c57ed8acd7642ec801ad80dae0c574462a58a6722fbfa361a0b65 responseCode: 00 responseMsg: Approved Direct POST - 3D Güvenli Bu entegrasyon modelinde ortak ödeme sayfalarında farklı olarak, son kullanıcı görsel arabirim servisi Paratika tarafından yapılmaz. Tüm kullanıcı görsel arabirimlerini (user interfaces) kendi ortamlarında barındırmak, versiyonlamak ve yönetmek isteyen üye iş yerleri bu modeli kullanabilirler. %100 PCI DSS uyumluluğunu mümkün kılan bu modelde, aşağıda anlatıldığı şekilde üye iş yeri sisteminde / sayfasında sunulan form direkt olarak Paratika ortamlarına HTTP POST kullanılarak hassas veriye dokunmadan işlem desteği sağlanır. Üye iş yerleri müşterilerine kayıtlı kartlarla işlem yaptırabildiği gibi, yeni kartlarla da işlem imkanı sunar. Buradan gerçekleştirilen işlemler 3D Güvenli olma özelliği taşır. Adım 1: Üye iş yeri sistemi gerekli tüm işlem / sipariş detaylarını vererek oturum anahtarı isteğini gönderir. Bu adımdaki verilerin hiçbiri hassas veri kapsamında bulunmaz. Adım 2: Oturum anahtarı isteği (Session token request) işlenerek tüm verilerin geçerli olması durumunda üye iş yeri kullanımına açılan oturum anahtarı paylaşılır. Adım 3: Elde edilen oturum anaharı bilgisiyle üye iş yeri web sayfasında form gösterilir. Bu form kodu örneği için aşağıdaki bölümü inceleyebilirsiniz. Extra Puan Adimi: Üye is yeri Paratika Direct Post metodlarinda puan kullanimi için SESSIONTOKEN, CARDPAN,CARDEXPIRY ile puan sorgulama islemi yapmalidir. QUERYPOINTS dönüs degerine göre örnek form içindeki points alani doldurulmali. Puan ile satis örneklerine buradan ulasabilirsiniz. Ardindan puanli satis isteginin ilgili ödeme sistemine iletilmesi için SESSIONTOKEN ve BIN parametreleri ile QUERYPAYMENTSYSTEMS sorgusu yapilmali ve dönüs degerinde yer alan ödeme sistemi adi örnek form içinde paymentSystem alaninda gönderilmelidir. Adım 4: Kart sahibi, üye iş yeri sayfasında (ya da HTTP destekleyen herhangi bir mobil / masaüstü uygulama da olabilir) gösterilen formda gerekli alanları doldurarak işlem isteğini yapar. Üye iş yeri bu formdaki tüm alanları direkt olarak Paratika sistemine POST eder. Adım 5: Paratika tüm işlem detaylarını ve ödeme formundan gelen bilgileri kullanarak finansal işlemi gerçekleştirir. Bu süreçte kart sahibi Paratika tarafından servis edilen herhangi bir görsel arabirim görmeyecektir. Gerçekleştirilen bu işlem 3D Secure güvenli bir işlem niteliği taşır. Adım 6: Paratika kart sahibini 3D Secure güvenlikli işlem için ACS (Access Control Server) sayfalarına yönlendirir. Adım 7: ACS (Access Control Server) birimi, 3D doğrulama servis sayfalarını gösterir ve bu adımda kart sahibinin mobil telefonuna bu işlem için oluşturulan güvenli otorizasyon kodu SMS olarak gönderilir. Adım 8: ACS sunucusu (Access Control Server) kullanıcıyı doğrulayarak ilgili Paratika arabirimlerine gönderir. Adım 9: Bu işlem sonucu, Paratika sistemi tarafından ilk adımda belirtilen üye iş yeri dönüş URL adresine gönderilir. Aşağıdaki HTML Test formundaki TMX Javascript kısmının gönderilmesi zorunludur. Direct POST (3D Güvenli) Test Formu Sample POST Form Pay with Card Token Card Owner Name Card Number (PAN) Expiration Date January February March April May June July August September October November December 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 Security Code (CVV) Save Card Card Name Installment Count Card Token Installment Count Kartsız Direct POST - 3D Güvenli Aşağıda belirtilen kartsız ödeme yöntemleri üzerinden entegrasyon sağlamak için "Kartsız DIRECT POST (3D Güvenli) Test Formu" örneğini baz alınız. Maximum Mobil Kartsız DIRECT POST (3D Güvenli) Test Formu Sample Cardless POST Form Direct POST (3D Güvenli) Akışı Sample response for Direct Post 3D merchantPaymentId: PaymentId-FVKAjOiFHeuE apiMerchantId: 700100000 paymentSystem: ISBANK TEST paymentSystemType: ISBANK paymentSystemEftCode: 0064 pgTranDate: 20170112 14:13:13 pgTranId: 17012ONNI07013454 pgTranRefId: 701200002832 pgTranApprCode: 733185 pgOrderId: PaymentId-FVKAjOiFHeuE customerId: Customer-u1Q4G1oG amount: 11.76 installment: 1 sessionToken: VYD7AXJ6C446GIN55V6KKOB677VRTOZHG5HTSMP3EJCMEQYF random: tpN2ynMYAn SD_SHA512: 0f2b4945aefc71f547107898c2002c40d9d4a1508f7f00ee894138f6bc247ebc1238ead5aa01b6ba09bc7932a5957235b7837cc0270781d0a45055fe31648b61 sdSha512: 099e32f8df3130457d2b1595b069794ef6ed08c85a679f72336c5371e91087b223536b317fc43643ae0da06ea29e985a3c8185ab611606308760b0c260aa412f responseCode: 00 responseMsg: Approved Direct Post 3D Kimlik Doğrulama Bu entegrasyon modeli, 3D kimlik doğrulama sürecinin SALE / Preauth API Çağrısından ayrı olarak tamamlandığı senaryoya dayanmaktadır. Üye İşyeri, kart sahibinin kart bilgilerini girdiği ve gönderdiği bir sayfa sunar, 3D kimlik doğrulama sürecinin başladığı yer burasıdır. Kimlik doğrulama sürecinden gelen cevaba göre üye işyeri API üzerinden yetkilendirme yapar. Adım 1: Üye iş yeri Web sitesi, oturum tanımlamak için geçerli bir anahtar değeri elde etmek amacı ile bir oturum anahtarı (Session Token) isteğinde bulunur. Adım 2: Ödeme oturumu isteği işlenir; bir oturum anahtarı (Session Token) oluşturulur ve API yanıtında satıcı sistemine geri gönderilir. Adım 3: Üye iş yeri sistemi, verilen güvenli oturum anahtarını (Session Token) kullanarak ödeme ve cüzdan sayfasını açar. Adım 4: Kart sahibi sayfayla etkileşime girer ve Gönder düğmesine tıklar. Üye iş yeri sistemi bu sayfadan aldığı tüm bilgileri MSU sistemine gönderir. Adım 5: MSU, işyeri sayfasından POST talebini alır ve 3D kimlik doğrulama akışına devam etmek için 3D ACS'ye (Erişim Kontrol Sunucusu) yönlendirir. Adım 6: ACS, kart sahibinin kimlik doğrulaması için cep telefonuna gönderilen doğru (dinamik) kodu girmesi gereken 3D Güvenlik Sayfasını açar. Adım 7: MSU, 3D Kimlik Doğrulamasının başarılı ya da başarısız yanıtını işler. Adım 8: 3D Kimlik Doğrulama işleminin son yanıtı, satıcının sayfasına iletilir. Üye iş yerinin daha sonra API aracılığıyla yetkilendirme (Sale / Preauth) verdiğinde, gönderilen formdaki sonucu dinlemesi ve ayrıştırması beklenir. 3D Kimlik Doğrulama Direct Post Test Formu Kart Bilgi Formu ile 3D Kimlik Doğrulama <form action="https://test.paratika.com.tr/paratika/api/v2/post/auth3d/[SECURE_SESSION_TOKEN]" method="post"> <input type="text" name="cardOwner" placeholder="Card Owner" maxlength="32" /> <input type="text" name="pan" placeholder="PAN" maxlength="19" /> <select name="expiryMonth"> <option value="01">January</option> <option value="02">February</option> </select> <select name="expiryYear"> <option value="2019">2019</option> <option value="2020">2020</option> <option value="2021">2021</option> </select> <input type="password" name="cvv" placeholder="CVV" maxlength="4" /> <input type="checkbox" name="saveCard" /> <input type="text" name="cardName" placeholder="Card Name"/> <input type="text" name="cardCutoffDay" placeholder="Card Cutoff Day"/> <input type="text" name="installmentCount" placeholder="Installment Count"/> <input type="hidden" name="points" /> <input type="submit" value="Submit" /> </form> Kart Token Form ile 3D Kimlik Doğrulama <form action="https://test.paratika.com.tr/paratika/api/v2/post/auth3d/[SECURE_SESSION_TOKEN]" method="POST"> <input name="pan" type="text" size="20" /> <input name="cardOwner" type="text" size="20" /> <input name="expiryMonth" type="text" size="2"/> <input name="expiryYear" type="text" size="4"/> <input name="cvv" type="text" size="4"/> <input name="cardCutoffDay" type="text" size="2"/> <input name="callbackUrl" value="[merchant-return-url-handler]" /> <input type="submit" value="Complete Payment"/> </form> veya ödeme mevcut bir token alınmış kartla yapılacaksa <form action="https://test.paratika.com.tr/paratika/api/v2/post/auth3d/[SECURE_SESSION_TOKEN]" method="POST"> <input name="cardToken" type="text" placeholder="Card Token"size="20" /> <input name="cvv" type="text" placeholder="CVV" size="4" /> <input type="submit" value="Complete Payment"/> </form> Direct Post 3D & 3D Kimlik Doğrulama benzer süreçlerdir. Aralarındaki tek fark, Direct Post 3D'nin hem 3D Kimlik Doğrulamayı hem de Sale/Preauth'u yalnızca bir adımda bitirmesidir. 3D Kimlik Doğrulama ise sadece 3D Kimlik Doğrulama yapar. İlk olarak, 3D doğrulama tamamlanır ve ardından satıcı, 3D doğrulamanın başlatıldığı SESSION TOKEN ile (Sale/Preauth) gerçekleştirir. Alışveriş kredi işlemleri için direct pos kullanılabilmesi için aşağıdaki linkteki parametrelere göre SESSIONTOKEN oluşturulmalıdır. SESSIONTOKEN Direct Post 3D Kimlik Doğrulama Akışı 3D Kimlik Doğrulama (Direct Post) için Örnek Cevap sessionToken: 3URSNNY5C6ZATI656WIPXZXDSTAN3PNGLTXLY75H7FNBA7UJ auth3DToken: AUTH3DTOKEN responseCode: 00 responseMsg: Approved mdStatus: 1 mdErrorMsg: Authenticated API & HPP URLs API URL: https://entegrasyon.paratika.com.tr/paratika/api/v2 Hosted Payment Page URL (HPP): https://entegrasyon.paratika.com.tr/payment/[SECURE_SESSION_TOKEN] DirectPost 3D URL: https://entegrasyon.paratika.com.tr/paratika/api/v2/post/sale3d/[SECURE_SESSION_TOKEN] DirectPost Non3D URL: https://entegrasyon.paratika.com.tr/merchant/post/sale/[SECURE_SESSION_TOKEN] Hata Yönetimi Bir isteğin hata ile sonuçlanması durumunda; dönüş cevabı içerisinde ERROR ve ERRORCODE parametreleri bulunacaktır. Genel olarak meydana gelebilecek iki tür hata bulunmaktadır: Sistem hatalar ve ödeme geçidinden kaynaklanan hatalar. Merkezi Hatalar Merkezi hatalar genellikle geçersiz ya da yanlış verilen parametre değerlerinden kaynaklanmaktadır. Bu hataların kodu ERR100xx formatındadır. Hata Kodu Açıklama ERR10010 İstekte zorunlu parametrelerden biri bulunamadı ERR10011 Aynı parametre bir defadan fazla olarak gönderilmiş ERR10012 Bu değer için azami büyüklük değeri aşıldı. ERR10013 Bu değer için geçersiz veri tipi belirtilmiş ERR10014 Geçersiz güvenlik algoritması belirtilmiş ERR10015 Geçersiz üye iş yeri bilgisi belirtilmiş ERR10016 Geçersiz tutar bilgisi belirtilmiş ERR10017 Geçersiz para birimi belirtilmiş ERR10018 Geçersiz dil seçimi ERR10019 Genel hata ERR10020 Geçersiz kullanıcı bilgileri ERR10021 Boş parametre belirtilmiş, tüm parametreleri kontrol edin ERR10022 Sipariş edilen ürünlerin toplam tutarı gerçek tutarla örtüşmüyor ERR10023 Ödeme tutarı hesaplanan tutarla örtüşmüyor ERR10024 Geçersiz vergi tutarı belirtilmiş ERR10025 Belirtilen durumda vergi tutarı sıfır olmalıdır ERR10026 Geçersiz entegrasyon modeli belirtilmiş ERR10027 Geçersiz kart bilgisi (TOKEN) belirtilmiş ERR10028 Belirtilen ödeme sistemi (sanal POS) bulunamadı ERR10029 Belirtilen ödeme tipi (kampanya) bulunamadı ERR10030 Belirtilen işlem bulunamadı ERR10031 Bu işlem iade edilemez ERR10032 Geçersiz iade tutarı belirtilmiş ya da bu işlem daha önce iade edilmiş ERR10033 Bu işlem iptal edilemez ERR10034 Belirtilen ödeme bulunamadı ERR10035 Bu işlem için ön otorizasyon kaydı bulunmamaktadır ERR10036 Geçersiz son otorizasyon (POSTAUTH) tutarı belirtilmiş ERR10037 Belirtilen Kart Sahibi (Müşteri) kayıtlı değil ERR10038 İlgili ödeme onay beklemektedir ERR10039 Geçersiz ödeme durumu belirtilmiş ERR10040 Geçersiz alt işlem (SUBACTION) belirtilmiş ERR10041 Belirtilen kart daha önce eklenmiş ERR10042 Kart daha önceden silinmiş ERR10043 Geçersiz zaman aralığı belirtilmiş ERR10044 Geçersiz tarih formatı belirtilmiş ERR10045 Belirtilen kart numarası geçersizdir ERR10046 Belirtilen kredi kartı geçerlilik tarihi geçersizdir ERR10047 Kullanıcının API servislerini kullanma yetkisi bulunmamaktadır ERR10048 Başarılı Bir İşlem zaten bu üye iş yeri sipariş numarası ile var ERR10049 Geçersiz üye iş yeri grup numarası ERR10050 Geçersiz HASH değeri ERR10051 Herhangi bir ödeme sistemi (sanal pos) tanımı yok. Lütfen, kontrol ediniz. ERR10052 Desteklenmeyen para birimi: ERR10053 Kullanıcının bu üye iş yeri üzerinde işlem yapma yetkisi yok ERR10054 Ödeme geçerlilik süresi maksimum limitin üstündedir. ERR10055 Ödeme geçerlilik süresi minimum limitin altındadır. ERR10056 Geçersiz API isteği belirtilmiş ERR10057 Kart BIN bilgisi geçersiz ERR10058 Kart daha önce etkinleştirilmiş ERR10059 Kart daha önce kullanım dışı bırakılmış ERR10060 Geçersiz IP Adresi ERR10062 Belirtilen kart henüz aktive edilmemiştir. ERR10063 Bu işlem sadece LetsBodrum kart ile yapılabilir. ERR10064 Lütfen LetsBodrum kart veya Türkiye İş Bankası kredi kartı kullanınız. ERR10065 Belirtilen kart numarası daha önceden tanımlanmış. ERR10066 Belirtilen zaman bilgisi geçersiz ya da tutarsızdır ERR10067 Belirtilen period değeri çok yüksek ERR10068 Geçersiz tekrar düzeni parametresi ERR10069 Zamanlayıcı (Quartz) hatası oluştu ERR10070 Başlangı tarihi gelecekteki bir tarih olmalıdır ERR10071 Geçersiz tekrarlı ödeme durum parametresi belirtilmiş ERR10072 Tekrarlı ödeme planı zaten etkin durumda ERR10073 ERR10073 ERR10074 Tekrarlı ödeme planının zaten süresi geçmiş ERR10075 Üye iş yeri görsel (logo) bilgisi hatalı ERR10076 Geçersiz tekrarlı ödeme durum parametresi ERR10078 İşlem kilitlidir ERR10079 Bu kart sistemde kayıtlıdır. ERR10080 Lütfen, Üye İş Yeri Sipariş numarasını veya Ödeme Oturumu(Token) veriniz ERR10081 Geçersiz işlem durumu ERR10082 Kullanıcının bu işlem için yetkisi yoktur. ERR10083 Geçersiz statü ERR10084 Faiz veya indirim oranı sıfır değeri olmalıdır ERR10085 Geçerli bitiş tarihi ,geçerli başlangıç tarihten daha büyük olamaz ERR10086 Geçerli bitiş tarihi şimdiki tarihten daha büyük olmalıdır ERR10087 Taksit sayı numarası zaten bu ödeme sistemi ile bir ödeme tipi var ERR10088 Taksit bilgisi 1-12 arasında bir değer olmalıdır. ERR10089 Tekrarlı ödemeye ait kart silinemez. ERR10090 İşlem başarısız ERR10091 Ödeme sistemi devre dışı bırakıldığı için işlem gerçekleştiremiyor. Lütfen Üye İş Yeri Süper Yöneticisiyle iletişime geçiniz. ERR10092 Geçersiz offset değeri ERR10093 Geçersiz limit değeri ERR10094 Tanımlı bir kart bulunamadı. ERR10095 Kayıtlı bulunan tekrarlayan ödeme planlarından dolayı kart silinemez. ERR10096 Geçersiz oturum (session) bilgisi. ERR10097 Sonlandırılmış oturum (session) bilgisi. ERR10098 Bu oturum anahtarının yapılmak istenen işleme yetkisi yoktur. ERR10099 Bu işlem başka bir üye iş yerine ait. ERR10100 Bu ödeme için birden fazla başarılı işlem vardır. Lütfen PGTRANID parametresini kullanınız. ERR10101 Geçersiz URL parametresi belirtilmiştir. ERR10102 Geçersiz BIN değeri belirtilmiştir. ERR10103 İşlem isteği Inact RT servisi tarafından raporlanan fraud olasılığı nedeniyle reddedilmiştir. ERR10104 Kullanılabilir komisyon şeması bulunmamaktadır. ERR10105 Kartın bu ödeme havuzunda taksit yetkisi bulunmamaktadır. ERR10106 İşlem tutarı üye iş yeri hesabına geçmemiştir, iade yapılamaz. ERR10107 Bu ödeme zaten yapılmıştır, verilen Üye İş Yeri Sipariş Numarası ile yeni ödeme oturumu oluşturulamaz. ERR10108 Üye iş yeri onaylanmamış ERR10109 Ödeme havuzu üye iş yeri için henüz onaylanmamıştır. ERR10110 Kullanilan ödeme sistemi kampanya kullanımını desteklememektedir. ERR10111 Puan sorgulama ödeme sistemi tarafından desteklenmemektedir. ERR10112 Hatali puan formatı lütfen API Dokümantasyonundan puan kullanım formatını kontrol ediniz. ERR10113 Kullanilan ödeme sistemi puan kullanımını desteklememektedir. ERR10115 Üye iş yeri tarafından desteklenmeyen taksit sayısı belirtilmiştir. ERR10116 Bu işlem kullanımda olmayan üye iş yeri bilgileriyle gerçekleştirilemez. ERR10117 Bu sipariş numarası sonlanan bir oturumda kullanılmıştır lütfen farklı bir sipariş numarası ile oturum anahtarı oluşturun. ERR10118 İstek ile mevcut sipariş numarasına ait oturumun tutar, kur, oturum tipi, url dönüş değeri ya da yapılmak istenen işlem değerlerinden biri uyuşmamaktadır. ERR10119 Tam ve ya noktalı kısımda limit aşımı ERR10120 Bu plan koduna ait bir tekrarlı ödeme bulunuyor ERR10121 Geçersiz tekrarlı ödeme kodu ERR10122 Sonlanmış durumdaki tekrarlı ödeme güncellenemez. ERR10123 Geçersiz işlem tipi ERR10125 Mutabakat sorgusu için en az bir parametre geçilmeli. ERR10126 Birden fazla işlem bulundu. ERR10127 Ödeme sistemi puan parametresi hatalı, işlemin gönderileceği ödeme sisteminde gönderilen puan parametresi tanımlı değildir. ERR10128 Geçersiz parametre değeri ERR10129 Parçalı puan kullanımı bu ödeme sistemi tarafından desteklenmemektedir ERR10130 İşlem fraud süphesiyle reddedilmiştir. Detaylı bilgi için destek ekibiyle iletişime geçebilirsiniz. (TMX rejected) ERR10131 Komisyon masrafları, satıcı komisyon tutarını aşamaz. ERR10132 Ödeme isteğinde pazaryeri parametrelerini kullanmaya yetkiniz bulunmamaktadır. Lütfen Paratika destek hattıyla iletişime geçiniz. ERR10133 İstenen işlem güncellenemez. ERR10134 Ödeme sistemi tipi ya da EFT kodu bulunamadı. ERR10135 EXTRA parametresi decode edilemiyor. ERR10136 Bu üye iş yeri için ortak ödeme sayfası (HPP) kullanılamaz. ERR10137 Query Campaign Not Supported By PaymentSystem ERR10138 3D işlem yaparken hata oluştu. ERR10139 Üye İşyeri Entegrasyon Modeli Hatalı ERR10140 İşlem tipi bu ödeme sistemi tarafından desteklenmiyor. ERR10141 Beklenemedik ödeme sistemi entegrasyonu hatası ERR10142 Geçersiz Yönlendirme Adresi ERR10143 ÖDENMİŞ veya İPTAL EDİLMİŞ ödeme ERR10144 Üye iş yerinin yabancı banka kartları ile işlem yapma yetkisi yoktur ERR10145 Tekrarlı ödeme bulunamadı. ERR10146 Tekrarlı ödeme kartı bulunamadı. ERR10147 3D doğrulama olmaksızın kart ekleme yetkiniz yoktur. Lütfen HPP entegrasyon modelini kullanarak kart ekleyiniz ya da Paratika destek ekibinden yardım alınız. ERR10148 Tekrarlı ödeme planı zaten bu kart daha önce eklenmiş. ERR10149 Bu işlem için desteklenmeyen para birimi ERR10150 İndirim tutarı sipariş tutarından yüksek olamaz. ERR10151 Satıcı bulunamadı ERR10152 Bu id ile satıcı mevcuttur. ERR10153 İade işlemi Paratika Finans ekibi tarafından red edilmiştir ERR10154 İşlem 3D kısıtlamasıyla başarısız olmuştur. ERR10155 Satıcı deaktive durumdadir. Bu işlem yapılamaz. ERR10156 Unsupported Currency Conversion ERR10157 Aktivasyon tarihi gelecek tarih olmalıdır ERR10158 Geçersiz varsayılan komisyon oranı ERR10159 Geçersiz ödeme sistemi bazlı komisyon oranı ERR10160 Eksik parametre ERR10161 Ödeme sistemi havuzda bulunamadı ERR10162 Sadece 2 ile 12 arasındaki tüm taksitler parametrede sağlanmalıdır ERR10163 Save card parametresi API entegrasyon modeli için kullanılamaz ERR10164 Bu isimde havuzda kartsız işlem destekleyen ödeme sistemi bulunamadı ERR10165 Komisyon şeması bulunamadı ERR10166 ERR10166 ERR10167 Invalid sellerId - do not use semicolon ERR10168 Bu kart markası desteklenmemektedir ERR10169 Taksit bu kart markası için uygun değildir ERR10170 Girilen değer geçerli aralığın dışında. Minimum değer 1 olmalı, maksimum değer için lütfen Paratika Operasyon Ekibi'yle iletişime geçiniz. ERR10171 Belirtilen MCC bulunamadı. ERR10172 Belirtilen MCC daha önce eklenmiş ERR10173 Ürün komisyon tutarları TOTALSELLERCOMMISSIONAMOUNT parametresinde belirtilen komisyon tutarıyla uyuşmamaktadır. ERR10174 Üye İşyeri Ürün Tipi ve Komisyon Yükümlülüğü satıcılı satışı kullanabilmek için doğru şekilde güncellenemedi. ERR10175 Wrong commission applier type. ERR10176 Invalid Seller Payment Amount ERR10177 Invalid Marketplace Integration Model ERR10178 Ödeme kalemlerinin satıcı ödeme tutarlarının toplamı TOTALSELLERPAYMENTAMOUNT parametresiyle örtüşmemektedir. ERR10179 Komisyon uygulama tipi, CA(komisyon miktari), komisyon değeri ile aynı anda gönderilemez. ERR10180 Yatırımcı tipiniz için kullanmak istediğiniz kart tipi için geçersiz ERR10181 Sipariş öğelerinde hatalı üye işyeri bilgisi. ERR10182 Sipariş kalemi bulunamadı ERR10183 Sipariş kalemleri, sadece session token ile oluşturulan birincil işlemler için desteklenmektedir ERR10184 Ürün adedini ya da tutarını belirtmeniz gerekmektedir ERR10185 Item quantity or amount exceeded ERR10186 Tutar, orijinal istek tutarından daha büyük olamaz. ERR10187 Ödeme isteğinde pazaryeri parametrelerini kullanmaya yetkiniz bulunmamaktadır. Lütfen Paratika destek hattıyla iletişime geçiniz. ERR10188 Ödeme tarihi, işlem tarihinden önce olamaz. Lütfen isteği kontrol ediniz. ERR10189 Invalid or Missing EXTRA parameter value ERR10190 Üretici kart şablonu, bu ödeme sistemi tarafından desteklenmemektedir. ERR10191 VKN ve TCKN deÄerleri birlikte kullanılamaz. Lütfen sadece birini kullanınız. ERR10192 Please send ACCOUNTOWNERNAME and ACCOUNTOWNERLASTNAME only or COMMERCIALTITLE only. ERR10193 Satıcı ödeme vadesi, Üye İş Yeri ödeme vadesine eşit veya daha yüksek olmalıdır. ERR10194 Lütfen Kuveyt Türk sanal posu için alt bayi tanımlarını yapınız. ERR10195 Satıcı işleminde ürün bulunamadı ERR10196 Ödeme tarihi işlem tarihinden önce olamaz. ERR10197 Bu email adresi ve isme ait başvuru bulunamadı. ERR10198 Bu isim ve email ile bir başvuru mevcut ERR10199 Hatalı telefon numarası ERR10200 Hatalı web adresi ERR10201 Yanlış Ortak Başvuru Formatı ERR10202 Hatalı üye iş yeri başvurusu sağlandı ERR10203 Hatalı Başvuru Finans Datası sağlandı ERR10204 Geçersiz başvuru döküman verisi tedarik edildi ERR10205 Hatalı Başvuru Satş Destek Datası sağlandı ERR10206 Geçersiz Uygulama Risk Yönetimi Verisi tedarik edildi ERR10207 OTP kodu bulunamadı ERR10208 Aynı isimde bir BIN Kuralı mevcut, lütfen farklı isimle bir BIN Kuralı tanımlayınız. ERR10209 Aynı konfigürasyon ile bir BIN Kuralı mevcut, lütfen farklı konfigürasyonlar içeren bir BIN Kuralı ekleyiniz. ERR10210 BIN Kuralı taksit sayısı rakamlardan oluşmalıdır ERR10211 Bin Kuralı taksit sayısı geçerli aralığın dışında ERR10212 BIN kuralı, verilen bin kuralı adıyla bulunamadı ERR10213 Bin Kural alt limiti, üst limitten büyük olamaz. ERR10214 Girilen değer minimum uzunluğu geçmiyor ERR10215 BKM hata ERR10216 Başvuru dökümanı kayıtlıdır, farklı isimli bir döküman giriniz. ERR10217 Başvuru dökümanı ismi bulunamadı. ERR10218 Maksimum Başvuru dökümanı sayısı aşıldı. ERR10219 Geçersiz VKN. ERR10220 Geçersiz IBAN TRY. ERR10221 Link ile ödeme oturumu sonlandırıldı ERR10222 Aynı konfigürasyon ile bir BIN Kuralı ve Ödeme Sistemi Havuz kaydı mevcut ERR10223 Konfigürasyon ile bir BIN Kuralı ve Ödeme Sistemi Havuz kaydı bulunamadı ERR10224 ERR10224 ERR10225 BIN aynı anda hem yabancı hem de ülkesi Türkiye olamaz ERR10226 ERR10226 ERR10227 CARDPANTYPE parametresini INSURANCE olarak kullanmaya yetkiniz yoktur ERR10228 Hatalı CARDPAN formatı. CARDPAN İlk8/Son4/TCKN-VKN-YKN formatında olmalıdır ERR10229 NAMEONCARD, CARDEXPIRY ve CARDPANCVV parametrelerini CARDPANTYPE parametresi ile aynı anda kullanamazsınız ERR10230 CARDTOKEN parametresini CARDPANTYPE parametresi ile aynı anda kullanamazsınız ERR10231 SAVECARD parametresini CARDPANTYPE parametresi ile aynı anda kullanamazsınız ERR10232 Yabancı kart numarası ile işlem yapılamaz ERR10233 Geçersiz e-posta ERR10234 Alışveriş kredisi hizmeti, ödeme sistemi tarafından desteklenmemektedir. ERR10235 Satıcı Ödeme Tarihi Uyumsuzluğu ERR10236 Vadeli Tarih Uyumsuz ERR10237 INSTALLMENTSUPPORT için yanlış giriş değeri ERR10238 İndirim tutarı için geçersiz veri ERR10239 PPOS işlemleri için geçersiz işlem ERR10240 Yanlış İmza Yetkilisi Formatı ERR10241 Alışveriş Kredisi için girilen parametre değerleri ile PAYMENTSYSTEMTYPE değeri örtüşmelidir ERR10242 Pazaryeri müşterilerine izin verilmeyen parametre ERR10243 IDENTIFIERNUMBER için yanlış giriş değeri ERR10244 CUSTOMERPHONE ve CUSTOMEREMAIL alanları zorunludur Ödeme Sistemleri (vPOS) Kaynaklı Hatalar Paratika API yapısı, banka tarafında kullanılmakta olan ödeme geçidinden kaynaklanan hatalar için farklı bir dizi hata kodu kullanmaktadır. Bu hata dizisi ISO-8583 ’e ait 39. alan cevap değerlerinden türetilmiştir. Bu hataların kod formatı ERR200xx şeklindedir. Hata Kodu Açıklama ERR20001 Manuel onay için bankanızla iletişime geçiniz ERR20002 Sahte onay, bankanızla iletişime geçiniz ERR20003 Geçersiz üye iş yeri ya da servis sağlayıcı ERR20004 Karta el koyunuz ERR20005 İşleme onay verilmedi ERR20006 Hata (Sanal POS ya da banka tarafında sadece kayıt güncelleme cevapları bulundu) ERR20007 Karta el koyunuz - Özel nedenler ERR20008 Sahte onay, bankanızla iletişime geçiniz ERR20009 İşlem yapılan banka kartına taksit uygulanmamaktadır. ERR20011 Sahte onay (VIP), bankanızla iletişime geçiniz ERR20012 Sanal POS ya da banka tarafında geçersiz işlem ERR20013 Sanal POS hatası: Geçersiz tutar bilgisi ERR20014 Geçersiz hesap ya da kart numarası belirtilmiş ERR20015 Böyle bir banka (issuer) bulunamadı ERR20019 Sanal POS hatası: Tekrar deneyiniz ERR20020 Sanal POS hatası: Geçersiz / Hatalı tutar ERR20021 Banka / Sanal POS tarafında işlem yapılamıyor ERR20025 Sanal POS hatası: Kayıt oluşturulamadı ERR20026 Sanal POS tarafında işlem bulunamadı ERR20027 Sanal POS hatası: Banka reddetti ERR20028 Sanal POS hatası: Original is denied ERR20029 Sanal POS hatası: Original not found ERR20030 Sanal POS tarafında switch bazlı format hatası ERR20032 Sanal POS tarafında genel yönlendirme hatası ERR20033 Belirtilen kredi kartının geçerlilik süresi bitmiştir ERR20034 İşlemde sahtecilik (fraud) şüphesi ERR20036 Sanal POS hatası: Kısıtlanmış kart ERR20037 Sanal POS hatası: Banka (Issuer) kartı geri çağrıyor ERR20038 Sanal POS hatası: İzin verilen PIN deneme sayısı aşıldı ERR20040 Sanal POS hatası: İade işlemi gün sonundan önce yapılamaz ERR20041 Sanal POS hatası: Kayıp kart, karta el koyunuz ERR20043 Sanal POS hatası: Çalıntı kart, karta el koyunuz ERR20045 Puan kullanılan işlemlerde iade desteklenmemektedir. Lütfen bankanızla iletişime geçiniz. ERR20051 Belirtilen kredi kartının limiti bu işlem için yeterli değildir ERR20052 Sanal POS hatası: Çek hesabı bulunamadı ERR20053 Sanal POS hatası: Tasarruf hesabı bulunamadı ERR20054 Kartın kullanım süresi geçmiş ERR20055 Sanal POS hatası: Hatalı / Geçersiz PIN değeri ERR20056 Sanal POS hatası: Kart bilgisi bulunamadı ERR20057 Kart sahibine bu işlem yetkisi verilmemiştir ERR20058 Terminale bu işlem izni verilmemiştir ERR20059 İşlemde sahtecilik (fraud) şüphesi vardır ERR20061 Sanal POS hatası: Beklenen işlem tutar sınırı aşıldı ERR20062 Belirtilen kredi kartı kısıtlanmıştır ERR20063 Sanal POS tarafında güvenlik ihlali durumu ERR20065 Sanal POS hatası: Beklenen işlem sınırı aşıldı ERR20075 Sanal POS hatası: İzin verilen PIN deneme sayısı aşıldı ERR20076 Sanal POS anahtar eşzamanlama hatası ERR20077 Sanal POS hatası: Geçersiz / Tutarsız bilgi gönderildi ERR20080 Geçersiz tarih bilgisi ERR20081 Sanal POS şifreleme hatası ERR20082 Geçersiz / Hatalı CVV değeri ERR20083 PIN değeri doğrulanamıyor ERR20084 Geçersiz / Hatalı CVV değeri ERR20085 Sanal POS tarafında reddedildi (Genel) ERR20086 Doğrulanamadı ERR20091 Banka / Sanal POS şu an işlem gerçekleştiremiyor ERR20092 Zaman aşımı nedeniyle teknik iptal gerçekleşitiriliyor ERR20093 Kartınız e-ticaret işlemlerine kapalıdır. Bankanızı arayınız. ERR20096 Sanal POS tarafında genel hata ERR20098 Çoklu iptal (Duplicate reversal) ERR20099 Lütfen yeniden deneyiniz, sorun devam ederse bankanızla iletişime geçiniz. ERR200YK Kart kara listede bulunuyor ERR200SF Detaylar için sanal POS cevabındaki HOSTMSG alanını kontrol ediniz. ERR200GK Sanal POS hatası: Bu terminalde yanabcı kartlar için yetki bulunmamaktadır. ERR30001 Bu işlem Threat Metrix (TMX) tarafından reddedilmiştir. İlgili detaylar için lütfen işlem loglarını ve TMX portal kayıtlarını inceleyiniz. ERR30002 3D işlemi başarılı şekilde sonlanmadı. ERR30004 Bu istek fraud (sahtecilik) kuralları tarafından reddedilmiştir. ERR30005 Banka tarafından yanıt alınmadı. Ek hata cevap parametreleri İşlemin gerçekleşmemesi durumunda gerçek hatayı açıklayıcı ya da detaylandırıcı nitelikte Sanal POS / Ödeme Sistemi tarafından iletilen mesajlar 2 tane ek cevap parametresi içinde iletilmektedir PGTRANERRORCODE ve PGTRANERRORTEXT . İletilen bu bilgiler özellikle banka tarafında az rastlanan ve genel hata durumlarını açıklayan cevap bilgileridir. Hatalı cevap örnekleri Hata durumu içeren bazı API cevap örnekleri yan tarafta bulunabilir. Örnek 1: Paratika hatası: Satış işlemi (SALE) sırasında geçersiz bir kart anahtarı (CARDTOKEN) kullanılması durumunda oluşan hata. { "errorCode" : "ERR10027", "responseCode" : "99", "errorMsg" : "Geçersiz kart bilgisi (TOKEN) belirtilmiş", "responseMsg" : "Declined", "violatorParam" : "" } Örnek 2: Sanal POS / Dış Ödeme Sistemi hatası: Kredi kartında yetersiz limit sebebiyle oluşan hata. { "errorCode":"ERR20051", "responseCode":"99", "errorMsg":"Belirtilen kredi kartının limiti bu işlem için yeterli değildir", "responseMsg":"Declined", "violatorParam":"" } Örnek 3: Genel Hata: Bu üye iş yerine tanımlı olan herhangi bir ödeme sisteminin bulunmaması durumunda gerçekleşen hata. { "errorCode":"ERR20099", "responseCode":"99", "errorMsg":"Lütfen yeniden deneyiniz, sorun devam ederse bankanızla iletişime geçiniz.", "responseMsg":"Declined", "violatorParam":"" } Örnek 4: Hatasız işlem. { "apiMerchantId" : "6008138000", "paymentSystem" : "Teb test ps", "pgTranDate" : "20141215 17:22:54", "merchantPaymentId" : "session-a7bAS3AddR5PApN", "pgTranId" : "14349RW4Q89120700", "pgTranRefId" : "4398417187960", "pgOrderId" : "session-a7bRkDJK091pN", "responseCode" : "00", "responseMsg" : "Approved" } Bildirimler Paratika, ilgili firmaya finansal işlemlerle ilgili olayları bildirmek için kullanılan yerleşik bir mekanizmaya sahiptir. Daha spesifik olarak Paratika, belirli bir olay hakkında bir firmaya aşağıdaki durumlarda bildirim mesajları gönderir: Onaylanmış bir işlem Gerçekleştirilen Bu bildirim hizmeti, Paratika, banka ödeme ağ geçidinden, bu işlemin onaylandığını onaylayan belirli bir işlem için başlatılan istek için bir yanıt aldığında onaylanan işlemler için tetiklenir. Tüccarın bitiş noktasında bildirim göndermeye çalışılırken 5 saniye bir zaman aşımına uğradığını unutmayın. Nasıl çalışır? Bir satıcı, bir dinleyici bitiş noktası oluşturmalı ve bu bitiş noktasına işaret eden URL, bu satıcının profiline eklenmelidir. Paratika, daha sonra yukarıdaki listeden bahsedilen belirli bir olay meydana geldiğinde firmaya bildirim gönderir. Böyle bir zaman olayı meydana geldiğinde, Paratika sağda gösterilen ilgili parametreleri içeren URL'ye güvenli bir FORM POST gönderir. Gönderilen örnek parametreler NOTIFICATIONTYPE: TRANSACTIONAPPROVED CHANNEL: [MERCHANTBUSINESSID] CUSTOMER: [CUSTOMERID] CUSTOMERNAME: [CUSTOMERNAME] AMOUNT: [AMOUNT] TRANSACTIONTYPE: [TRANSACTIONTYPE] CURRENCY: [CURRENCY] STATUS: [STATUS] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANSACTIONID: [PGTRANSACTIONID] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] EFTCODE: [INSTALLMENTCOUNT] Metadata Paratika sisteminde bazı önemli anahtar data alanları şunlardır: İşlem Her bir finansal istek Paratika sisteminde bir “işlem”e karşılık gelir. Mutabakat ise bu işlemlerin kaydı üzerinden yapılır. İşlemlerin belli tipleri ve durumları vardır. Lütfen yan tarafta verilen tanımlara göz atınız. İşlem Tipleri /* Sale */ SALE, /* Pre-authorization */ PREAUTH, /* Post-authorization */ POSTAUTH, /* Refund */ REFUND, /* Partial Refund */ PTREFUND, /* Credit, Free refund */ CREDIT, /* Void action */ VOID İşlem Durumları /* In Progress, Created */ IP, /* CAncelled by CardHolder during approval */ CA, /* FAiled / Declined (Response from the integrated vPOS) */ FA, /* APproved (Response from the integrated vPOS) */ AP, /* VoiDed (As secondary process) (Response from the integrated vPOS) */ VD, /* Needs manual review (Response from the integrated vPOS exists) */ MR Diğer Kullanım Özellikleri Paratika API'nin diğer kullanım alanlarını ve örneklerini aşağıda bulabilirsiniz. Ödeme Sayfası Bağlantısı (URL) Kullanımı Ödeme sayfası bağlantısı (URL) kullanımı SMS, mobil uygulama bildirimleri, push mesajlar , e-mail gibi kanallar ile ödemenin yapılacağı linkin müşteri ile paylaşıldığı bir ödeme opsiyonudur. Bu akışta üye iş yeri bir ödeme sayfası linki oluşturarak bu linki ilgili müşteri ile paylaşır. Müşteri kendisine ulaşan ödeme sayfası linkine tıklayarak ödeme sayfasına gider. Bu sayfada ödeme yapacağı tutarı, karşılığında alacağı ürünleri görür. Kart bilgilerini sayfadaki forma girer ve işlemini tamamlar.Ödeme sayfası bağlantısı oluşturmak isteyen üye iş yeri öncelikli olarak Paratika API üzerinden ilgili parametreler ile bir SESSIONTOKEN isteğinde bulunur. Üye iş yeri başarılı bir şekilde oluşturulan oturum anahtarı bilgisi ile satış ya da ön otorizasyon yapacağı ödeme sayfası linkini oluşturur ve ilgili müşteriyle bu linki paylaşır. Müşteri linkin geçerlilik süresi dolmadan linke tıklayıp işlemi tamamlamalıdır. Geçerlilik süresi dolan linkler "Sonlandırılmış oturum (session) bilgisi." hata sayfasına yönlendirilirken geçersiz bir oturum anahtarı ile oluşturulan linkler ise "Geçersiz oturum (session) bilgisi." sayfasına yönlendirilir. Linklerin geçerlilik süresi SESSIONTOKEN isteğindeki SESSIONEXPIRY parametresi ile belirlenir ve bu parametrenin varsayılan değeri 7gündür.Başarılı bir şekilde sonlanan işlemlerin cevabı ise SESSIONTOKEN isteğinde gönderilen RETURNURL parametresindeki adrese POST edilir. Adım 1: Paratika API üzerinden SESSIONTOKEN isteği ile bir session token oluşuturulur. ([SESSIONTOKEN]) Adım 2: Bu session token kullanılarak ödeme sayfası linki oluşturulur. (Örn. https://test.paratika.com.tr/merchant/payment/[SESSIONTOKEN]) Adım 3: Link ilgili müşteriye mail, SMS, bildirim vs. olarak gönderilir. Adım 4: Müşteri linke tıklayarak ödeme sayfasına gider ve ödeme işlemini gerçekleştirir. Adım 5: Ödeme işleminin sonucu SESSIONTOKEN isteğindeki RETURNURL parametresi ile belirtilen adrese POST edilir. Test Kartları Burada farklı bankalar için test kartları bulabilirsinizNestpay bankaları için 3D Secure şifresi "a" dır. Test Kartları Banka Kart Numarası S.K.T CVV 3D Güvenli Şifre Ziraat-VISA 4546711234567894 12/2026 000 a Ziraat-MASTER 5401341234567891 12/2026 000 a AKBANK-VISA 4355084355084358 12/2030 000 a AKBANK-MASTER 5571135571135575 12/2030 000 a TEB-VISA 4402934402934406 12/2030 000 a TEB-MASTER 5101385101385104 12/2030 000 a HALKBANK-VISA 4920244920244921 12/2030 001 a HALKBANK-MASTER 5404355404355405 12/2030 001 a FINANSBANK-VISA 4022774022774026 12/2030 000 a FINANSBANK-MASTER 5456165456165454 12/2030 000 a ISBANK-VISA 4508034508034509 12/2030 000 a ISBANK-MASTER 5406675406675403 12/2030 000 a ANADOLUBANK-VISA 4258464258464253 12/2030 000 a ANADOLUBANK-MASTER 5222405222405229 12/2030 000 a HSBC 5100051016005572 01/2020 742 a INGBANK-VISA 4555714555714556 12/2030 000 a INGBANK-MASTER 5400245400245409 12/2030 000 a QNBFINANS-TROY 9792350046201275 07/2027 993 GARANTI-TROY 9792052565200010 01/2027 327 YKB-TROY 6501617060023449 12/2026 000 YKB-TROY 6501617025774490 12/2026 000 YKB-TROY 6501617063597076 12/2026 000 TURKIYE FINANS-TROY 9792182023832743 10/2028 878 a SEKERBANK-TROY 6501750104751517 12/2027 516 a AKBANK-TROY 9792072000017956 12/2027 000 a ABANK-TROY 36577312700094 12/2027 000 a YKB-VISA 4506344103118942 12/2025 000 YKB-VISA 4506347023253988 12/2025 000 YKB-VISA 4506347028991897 12/2025 000 YKB-VISA 4506347026523718 12/2025 000 YKB-MASTER 5400617004770430 12/2025 000 YKB-MASTER 5400617020092306 12/2025 000 YKB-MASTER 5400617030400291 12/2025 000 GARANTI-VISA 4824892919057014 12/2025 067 GARANTI-MASTER 5378297758742014 05/2025 467 KUVEYTTURK-MASTER 5188961939192544 06/2025 929 123456 VAKIFBANK-VISA 4938460158754205 01/2024 715 123456 VAKIFBANK-VISA 4119790155203496 04/2024 579 123456 VAKIFBANK-MASTER 5400617020092306 12/2025 Yok 123456 Finansal İşlemler Paratika sisteminde yer alan tüm işlem tipleri aşağıdaki gibidir: Satış Satış işlemi, müşterinin kredi kartından ödemenin anında tahsil edildiği bir işlemdir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SALE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, conditional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. CUSTOMERBIRTHDAY: date, optional Max length: 16 Format: [dd-MM-yyyy] Müşteri Doğum Günü. TCKN: string, optional Max length: 16 TCKN / Müşteri Kimlik Numarası. AUTH3DTOKEN: string, optional Max length: 16 description CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPANTYPE: string, optional Max length: 32 Card Pan Type parametresi, yapacağımız işlemde kullanıcağımız kart tipini belirlemek için kullanırız Tüm geçerli değerleri görün (1) CARDPAN: string, conditional Max length: 26 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. SAVECARD: string, optional Max length: 3 Bu parametre değeri 'yes' olarak gönderildiğinde ödeme sayfasında kart otomatik olarak kaydedilecektir. Save Card parametresi API entegrasyon modeli için kullanılamaz CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. POINTS: string, optional Max length: 500 Sale by points can be used via points argument of sale action. This parameter gets its argument as a json format and parse it according to payment system.AKBANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"XCBCHIPPARA", "value":"10"}]MULTIPLE POINTS USAGE: [{"name":"XCBCHIPPARA", "value":"10"},{"name":"PCBCHIPPARA", "value":"10"},{"name":"CCBCHIPPARA", "value":"10"}]ISBANK SALE BY POINTS SAMPLEPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"MAXIPUAN","value":"1"}]FINANSBANK SALE BY POINTS SAMPLEYou can use points if and only if PARAPUAN equal to AMOUNTPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PARAPUAN","value":"10"}] TEB BANK SALE BY POINTS SAMPLEYou can use points if and only if KULLANBONUS equal to AMOUNTPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"KULLANBONUS","value":"10"}]HALKBANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"ODUL", "value":"10"}]AKTIFBANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"KULLANPUAN","value":"10"}]GARANTI BANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"FBB","value":"5160.02"},{"name":"BNS","value":"91462.68"}] YAPI KREDI BANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PUAN","value":"10.00"}]HSBC BANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"ODUL","value":"10.00"}]VAKIFBANK SALE BY POINTS SAMPLEPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PUAN","value":"283567.72"}]SEKERBANK SALE BY POINTS SAMPLEPOINTS must be JSON String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"KULLANBONUS","value":"10"}]DENIZBANK SALE BY POINTS SAMPLEPOINTS must be JSON String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"BONUSAMOUNT","value":"10.00"}]ZIRAATBANK SALE BY POINTS SAMPLEPOINTS must be JSON String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PUANSORGU","value":"PUANSORGU"},{"name":"KULLANPUAN","value":"10"}] BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 16 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. FASTSHIPPING: string, optional Max length: 3 Bu parametre teslimat / kargolama işleminin hızlı / acil seçeneğiyle yapılıp yapılmadığını gösterir. Hızlı teslimat seçeneği kullanılmışsa üye iş yeri tarafından "yes" olarak gönderilmelidir. Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası BUYERTYPE: string, optional Max length: 1 Default value: 'A' Üye / Anonim kullanıcı bayrağı Tüm geçerli değerleri görün () SELLERID: string, optional Max length: 1024 Satıcı başına benzersiz değer. COMMISSIONAMOUNT: string, optional Max length: 512 description DISCOUNTAMOUNT: decimal, optional Max length: 30 ORDERITEMS içerisinde belirtilen toplam tutardan düşülecek indirim tutarını belirtir. Eğer bu alanda bir değer yollanırsa, AMOUNT alanı ORDERITEMS toplamı ile DISCOUNTAMOUNT indirim tutarı farkına eşit olmalıdır. (AMOUNT = ORDERITEMS - DISCOUNTAMOUNT) FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description NOTIFICATIONURL: string, optional Max length: 255 description SELLERPAYMENTAMOUNT: string, optional Max length: 512 description THREATMETRIXSESSIONID: string, optional Max length: 128 description TMXSESSIONQUERYINPUT: string, optional Max length: 100000 Session query input that can be retrieved from Threat Metrix. A request needs to be sent at https://h-api.online-metrix.net/api/session-query, with those parameters: org_id (provided by Paratika), api_key (provided by Paratika), session_id (unique identifier, stored in the session, can be retrieved from QUERYSESSION), service_type (value should be 'session-policy'), event_type (value should be 'payment'), policy (provided by Paratika). e.g. https://h-api.online-metrix.net/api/session-query?org_id=[org_id]&api_key=[api_key]&session_id=[session_id]&service_type=session-policy&event_type=payment&policy=[policy] CUSTOMERTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (5) CAMPAIGNS: string, optional Max length: 1024 It represents the campaigns which is provided encoded JSON object. Example: [{"campaignCode": "taks3","campaignName": "2","campaignExtra": "ArtiTaksit"}] - while sending the request it must be encoded MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. Örnek İstek ACTION: SALE AMOUNT: 18.75 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-3gMvdMzXMj2q MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: Customer-Lsw7mJAm CUSTOMERNAME: Name Lsw7mJAm CUSTOMEREMAIL: Lsw7mJAm@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name Lsw7mJAm CUSTOMERPHONE: +901638874658 CUSTOMERBIRTHDAY: 01-01-2001 BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 CARDPAN: 5456165456165454 CARDEXPIRY: 12.2020 CARDCVV: 000 Örnek Cevap { "action" : "SALE", "merchant" : "10000000", "amount" : 18.75, "currency" : "TRY", "apiMerchantId" : "600600000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "paymentSystemType" : "FINANS", "paymentSystemEftCode" : "0111", "pgTranDate" : "20160729 12:18:53", "merchantPaymentId" : "PaymentId-3gMvdMzXMj2q", "pgTranId" : "16211MS3D00124776", "pgTranRefId" : "621112352883", "pgOrderId" : "PaymentId-3gMvdMzXMj2q", "responseCode" : "00", "responseMsg" : "Approved", "tmxSessionQueryOutput" : "" } Preauth Ön Otorizasyon işlemi müşterinin kredi kartında söz konusu tutara bloke koyan bir işlemdir. Bu şekilde bloke edilen tutar, Son Otorizasyon işlemi yapılana kadar karttan tahsilat yapmaz. Ön otorizasyon işlemi ile konulan blokenin süresi bankaya göre değişebilmektedir . Bu süre üç gün kadar kısa olabileceği gibi birkaç ay kadar uzun da olabilir. Üye iş yeri olarak kendi finansal güvenliğiniz için, ön otorizasyonu onay alan siparişlerin teslimatında hızlı davranmanızı ve bu işlemleri en kısa zamanda son otorizasyonla kapatmanızı öneririz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PREAUTH, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPANTYPE: string, optional Max length: 32 Card Pan Type parametresi, yapacağımız işlemde kullanıcağımız kart tipini belirlemek için kullanırız Tüm geçerli değerleri görün (1) CARDPAN: string, conditional Max length: 26 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, conditional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. CUSTOMERBIRTHDAY: date, optional Max length: 16 Format: [dd-MM-yyyy] Müşteri Doğum Günü. TCKN: string, optional Max length: 16 TCKN / Müşteri Kimlik Numarası. AUTH3DTOKEN: string, optional Max length: 16 description INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. SAVECARD: string, optional Max length: 3 Bu parametre değeri 'yes' olarak gönderildiğinde ödeme sayfasında kart otomatik olarak kaydedilecektir. Save Card parametresi API entegrasyon modeli için kullanılamaz CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 16 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. FASTSHIPPING: string, optional Max length: 3 Bu parametre teslimat / kargolama işleminin hızlı / acil seçeneğiyle yapılıp yapılmadığını gösterir. Hızlı teslimat seçeneği kullanılmışsa üye iş yeri tarafından "yes" olarak gönderilmelidir. Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası BUYERTYPE: string, optional Max length: 1 Default value: 'A' Üye / Anonim kullanıcı bayrağı Tüm geçerli değerleri görün () SELLERID: string, optional Max length: 1024 Satıcı başına benzersiz değer. COMMISSIONAMOUNT: string, optional Max length: 512 description SELLERPAYMENTAMOUNT: string, optional Max length: 512 description DISCOUNTAMOUNT: decimal, optional Max length: 30 ORDERITEMS içerisinde belirtilen toplam tutardan düşülecek indirim tutarını belirtir. Eğer bu alanda bir değer yollanırsa, AMOUNT alanı ORDERITEMS toplamı ile DISCOUNTAMOUNT indirim tutarı farkına eşit olmalıdır. (AMOUNT = ORDERITEMS - DISCOUNTAMOUNT) FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. NOTIFICATIONURL: string, optional Max length: 255 description THREATMETRIXSESSIONID: string, optional Max length: 128 description TMXSESSIONQUERYINPUT: string, optional Max length: 100000 Session query input that can be retrieved from Threat Metrix. A request needs to be sent at https://h-api.online-metrix.net/api/session-query, with those parameters: org_id (provided by Paratika), api_key (provided by Paratika), session_id (unique identifier, stored in the session, can be retrieved from QUERYSESSION), service_type (value should be 'session-policy'), event_type (value should be 'payment'), policy (provided by Paratika). e.g. https://h-api.online-metrix.net/api/session-query?org_id=[org_id]&api_key=[api_key]&session_id=[session_id]&service_type=session-policy&event_type=payment&policy=[policy] CUSTOMERTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (5) MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. Örnek İstek ACTION: PREAUTH AMOUNT: 18.73 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-a1aJk7isjUFa MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD MERCHANT: [MERCHANT] CUSTOMER: Customer-8UtUjDuF CUSTOMERNAME: Name 8UtUjDuF CUSTOMEREMAIL: 8UtUjDuF@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name 8UtUjDuF CUSTOMERPHONE: +903150474176 CUSTOMERBIRTHDAY: 01-01-2001 BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 CARDPAN: 4022774022774026 CARDEXPIRY: 12.2020 CARDCVV: 000 SELLERID: seller01; seller02 COMMISSIONAMOUNT: 50,55;35,62 Örnek Cevap { "action" : "PREAUTH", "merchant" : "10000000", "amount" : 18.73, "currency" : "TRY", "apiMerchantId" : "600600000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "paymentSystemType" : "FINANS", "paymentSystemEftCode" : "0111", "pgTranDate" : "20160729 12:28:16", "merchantPaymentId" : "PaymentId-a1aJk7isjUFa", "pgTranId" : "16211McQE00102144", "pgTranRefId" : "621112352885", "pgOrderId" : "PaymentId-a1aJk7isjUFa", "responseCode" : "00", "responseMsg" : "Approved", "tmxSessionQueryOutput" : "" } Postauth Son Otorizasyon(Post Otorizasyon), Ön Otorizasyon işlemi kullanılarak daha önceden rezerve edilen belirli bir tutarın müşterinin kredi kartından tahsil edildiği bir işlemdir. Son Otorizasyon (Post Otorizasyon) işlemine, Ön Otorizasyon işlemi için belirtilenden daha yüksek bir tutar girdiğiniz takdirde Son Otorizasyon(Post Otorizasyon) işlemi reddedilebilir. Ön Otorizasyon yapılandan daha küçük bir tutar girilmesi halinde otorizasyonda yalnızca müşterinin kartında işlem için bulunan daha düşük miktarlardaki bakiyeleri yakalamak üzere ayarlama yapılır. Son Otorizasyon(Post Otorizasyon) işlemleri ön otorizasyon alındıktan sonra belirli bir süre içerisinde tamamlanmalıdır. Bu süre, kart düzenleyenin politikasına göre 3 gün ile 75 gün arasında değişiklik gösterir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: POSTAUTH, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, optional Max length: 30 Default value: '0' İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. Örnek İstek ACTION: POSTAUTH MERCHANT: [MERCHANT] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTUSER: [MERCHANTUSER] MERCHANTPAYMENTID: pf-1352728431091 ORDERITEMS: [ { "productCode": "T00D3AITCC", "quantity": 2 }, { "productCode": "B00D9AVYBM", "amount": 150 } Parçalı son otorizasyon yapmak istiyorsanız, ORDERITEMS parametresini POSTAUTH isteğinde gönderebilirsiniz. Tutar girilen sipariş kalemleri üzerinden hesaplanacaktır. Ya ürün adedi ya da tutarını belirtmeniz gerekmektedir. Örnek Cevap { "action" : "POSTAUTH", "merchant" : "testmerchant", "amount" : "17.22", "currency" : "TRY", "pgTranId": "12317QR6A12524", "merchantPaymentId": "pf-1352728431091", "responseMsg": "Approved", "responseCode": "00", "pgTranRefId": "231700000252", "pgOrderId": "ORDER-12317QQDG12490", "apiMerchantId":"700100000", "paymentSystem":"ISBANK TEST", "pgTranDate":"20140927 14:51:27" } İptal İptal işlemi kendisinden başka her işlemi iptal etmek için kullanılır. İptal işleminin başarılı olması için, bu işlemin, kartı düzenleyen banka (Issuer) tarafındaki “gün sonu mutabakat” sürecinde yer almamış olması gerekmektedir. Gün Sonu Mutabakatı, tüm işlemlerin mutabakatı için iş gününün sonunda gerçekleştirilen süreçtir. Bu işlem tam olarak, söz konusu ödeme tutarının, kredi kartı hamilinin hesabından üye iş yerinin banka hesabına aktarıldığında gerçekleşir. Bu nedenle, “gün sonu mutabakatının” bir parçası olarak halihazırda işlem görmüş bir satış ya da son otorizasyon işlemini iptal etmek istemeniz gibi bir durumda, iptal edilen istek için bir başarısız hata kodu alırsınız. Bu durumda, “iptal” işlemi yerine “ücret iadesi” seçeneğini kullanmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VOID, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} Örnek İstek ACTION: VOID MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] PGTRANID: 14339MfqD01014997 REFLECTCOMMISSION : Örnek Cevap { "merchantPaymentId":"session-QKFRg437iRrg", "pgTranId":"14339MfqD01014997", "pgTranRefId":"433912398111", "pgOrderId":"session-QKFRg437iRrg", "responseCode":"00", "responseMsg":"Approved" } İade Bir Ücret İadesi işlemi, sistemdeki mevcut bir siparişe yönelik bakiyelerin müşterinin kredi kartına iadesini sağlar. Tamamlanmış bir ödeme işlemini iade etmek için, o işlemin numarasına ihtiyaç duyulur. Bu numara rapor ekranlarından temin edilebilir. Bir Tüm ödeme tutarının iadesini gerçekleştirdiğinizde ödeme tutarı asıl tutara sıfırlanacaktır.İade işlemi günsonuna girmiş işlemler için yapılabilmektedir, eğer işlem günsonuna girmediyse işlem iptal edilmelidir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: REFUND, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. NOTIFICATIONURL: string, optional Max length: 255 description ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. REFLECTCOMMISSION: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} Örnek İstek ACTION: REFUND MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY AMOUNT: 17.17 PGTRANID: 14339MjuG01015018 REFLECTCOMMISSION: No Örnek Cevap { "merchantPaymentId":"session-deQdckAmzHK4", "pgTranId":"14339MkiG01015022", "pgTranRefId":"433912398115", "pgOrderId":"session-deQdckAmzHK4", "responseCode":"00", "responseMsg":"Approved", "refundType":"FULL" } Session Session Token Oturum anahtarı tarayıcı ve ya API bazlı entegrasyon modellerinde kullanılabilir. Sistem geçerli oturum anahtarı isteğine API'ye sınırlı zaman aralığında(tanımlı olarak 7 gün. İstek içerisinde değiştirebilir) erişim hakkı tanımaktadır. Oturum anahtarı isteği her oturum için tekil bir üye iş yeri sipariş numarası beklemektedir. Aşağadaki kurallara uygun şekilde oturum anahtarı aynı üye iş yeri sipariş numarası ile kullanılabilir: Üye iş yeri bu sipariş numarası ile sonlandırılmış(basarılı veya iptal edilmiş) bir işleme sahip degil ise. Oturum anahtarının geçerlilik süresi dolmamış ise. Aynı sipariş numarası ile yeni oluşturulacak oturum anahtarında ana oturum degişkenleri(amount, customer,currency,sessionType and returnUrl) değişmedi ise üye iş yeri aynı sipariş numarası ile yukaridaki maddelere göre oturum anahtarı isteği gönderebilir. Threat Metrix Fraud Tool In order to integrate ThreatMetrix device intelligence with your website, you need to insert profiling tags on web pages where you will profile visitor devices and check page integrity. To do that, you will need: UNIQUE_SESSION_ID, you can get it from making a QUERYSESSION, in response you will have this value stored in threatMetrixSessionId, ORG_ID, contact PF to get this information <!-- NOTE * Replace UNIQUE_SESSION_ID with a uniquely generated handle * PAGEID is only needed for TDCloud, replace PAGEID with an unique ID for that page, if omitted, default is 1 for production * For production replace h.online-metrix.net with a local URL and configure your web server to redirect to h.online-metrix.net. When using whitewolf, if a web server is configured, HOST should be the host of your web server, if not configured the HOST should be h.online-metrix.net * Replace PF_HOST with the appropriate host Test: https://test.paratika.com.tr/paratika Production: https://vpos.paratika.com.tr/paratika --> <script type="text/javascript" src="https://PF_HOST/paratika/static/external/whitewolf-v3.js"></script> <script type="text/javascript"> whitewolf.run(HOST, ORG_ID, UNIQUE_SESSION_ID); </script> <noscript> <iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://h.online-metrix.net/tags?org_id=ORG_ID&session_id=UNIQUE_SESSION_ID&pageid=PAGEID"> </iframe> </noscript> İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SESSIONTOKEN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SESSIONTYPE: string, required Max length: 30 Ödeme ve Cüzdan için oturum tipi (PAYMENTSESSION or WALLETSESSION) Tüm geçerli değerleri görün (3) RETURNURL: string, required Max length: 256 Başarılı veya başarısız ödeme ardından dönüş URL değeri. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, conditional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERBIRTHDAY: date, optional Max length: 16 Format: [dd-MM-yyyy] Müşteri Doğum Günü. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. ORDERITEMS: string, conditional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. TCKN: string, optional Max length: 16 TCKN / Müşteri Kimlik Numarası. SESSIONEXPIRY: string, optional Max length: 5 Default value: '168h' Tanımlı oturum geçerlilik süresi, varsayılan geçerlilik süresi 7 gündür ( 7x24 saat ). LANGUAGE: string, optional Max length: 2 Default value: 'tr' Ödeme süresince kullanılacak sayfa dili. BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 32 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. FASTSHIPPING: string, optional Max length: 3 Default value: 'NO' Bu parametre teslimat / kargolama işleminin hızlı / acil seçeneğiyle yapılıp yapılmadığını gösterir. Hızlı teslimat seçeneği kullanılmışsa üye iş yeri tarafından "yes" olarak gönderilmelidir. Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası DISCOUNTAMOUNT: decimal, optional Max length: 30 ORDERITEMS içerisinde belirtilen toplam tutardan düşülecek indirim tutarını belirtir. Eğer bu alanda bir değer yollanırsa, AMOUNT alanı ORDERITEMS toplamı ile DISCOUNTAMOUNT indirim tutarı farkına eşit olmalıdır. (AMOUNT = ORDERITEMS - DISCOUNTAMOUNT) SELLERID: string, optional Max length: 1024 Satıcı başına benzersiz değer. COMMISSIONAMOUNT: string, optional Max length: 512 description SELLERPAYMENTAMOUNT: string, optional Max length: 512 description TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description TOTALSELLERPAYMENTAMOUNT: decimal, optional Max length: 30 description THREATMETRIXSESSIONID: string, optional Max length: 128 description TMXSESSIONQUERYINPUT: string, optional Max length: 100000 Session query input that can be retrieved from Threat Metrix. A request needs to be sent at https://h-api.online-metrix.net/api/session-query, with those parameters: org_id (provided by Paratika), api_key (provided by Paratika), session_id (unique identifier, stored in the session, can be retrieved from QUERYSESSION), service_type (value should be 'session-policy'), event_type (value should be 'payment'), policy (provided by Paratika). e.g. https://h-api.online-metrix.net/api/session-query?org_id=[org_id]&api_key=[api_key]&session_id=[session_id]&service_type=session-policy&event_type=payment&policy=[policy] CUSTOMERTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (5) CHECKOUTPAGEURL: string, optional Max length: 512 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. CARDPANTYPE: string, optional Max length: 32 Card Pan Type parametresi, yapacağımız işlemde kullanıcağımız kart tipini belirlemek için kullanırız Tüm geçerli değerleri görün (1) ISSPLITPAYMENTTRANSACTION: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) PAYMENTSESSION için İstek Örneği ACTION: SESSIONTOKEN MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] AMOUNT: 11.21 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-FuldmrwwiOpb RETURNURL: https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp CUSTOMER: Customer-jNPz2qSI CUSTOMERNAME: Name jNPz2qSI CUSTOMEREMAIL: jNPz2qSI@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name jNPz2qSI CUSTOMERPHONE: 6381053412 ORDERITEMS: [ { "productCode": "T00D3AITCC", "name": "Galaxy Note 3", "description": "Description of Galaxy Note 3", "quantity": 2, "amount": 449.99 }, { "productCode": "B00D9AVYBM", "name": "Samsung Galaxy S III", "description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)", "quantity": 1, "amount": 149.95 }, { "productCode": "B00NQGP5M8", "name": "Apple iPhone 6", "description": "Apple iPhone 6, Gold, 64 GB (Unlocked) by Apple", "quantity": 1, "amount": 139.95 }, { "productCode": "B00U8KSUIG", "name": "Samsung Galaxy S6", "description": "Samsung Galaxy S6 SM-G920F 32GB (FACTORY UNLOCKED) 5.1 QHDBlack-InternationalVersion", "quantity": 1, "amount": 129.95 } ] DISCOUNTAMOUNT: 2.50 BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 SESSIONTYPE: PAYMENTSESSION SELLERID: seller01; seller02 COMMISSIONAMOUNT: 50.55;35.62 If "productCode" ORDERITEMS is not sent, it will be generated. If sent, it must be unique. PAYMENTSESSION için Örnek Cevap { "sessionToken" : "HCZVQH5FIR5QBHBQCT6AMUJLVHEHXCMSQ2HA5I6WCGQKQNQX", "responseCode" : "00", "responseMsg" : "Approved" } WALLETSESSION için İstek Örneği ACTION: SESSIONTOKEN AMOUNT: 17.82 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-DkOxtbUcP7gF MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] RETURNURL: https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp CUSTOMER: Customer-PJYbATmL CUSTOMERNAME: Name PJYbATmL CUSTOMEREMAIL: PJYbATmL@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name PJYbATmL CUSTOMERPHONE: 8487817375 ORDERITEMS: [ { "productCode": "T00D3AITCC", "name": "Galaxy Note 3", "description": "Description of Galaxy Note 3", "quantity": 2, "amount": 449.99 }, { "productCode": "B00D9AVYBM", "name": "Samsung Galaxy S III", "description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)", "quantity": 1, "amount": 149.95 }, { "productCode": "B00NQGP5M8", "name": "Apple iPhone 6", "description": "Apple iPhone 6, Gold, 64 GB (Unlocked) by Apple", "quantity": 1, "amount": 139.95 }, { "productCode": "B00U8KSUIG", "name": "Samsung Galaxy S6", "description": "Samsung Galaxy S6 SM-G920F 32GB (FACTORY UNLOCKED) 5.1 QHDBlack-InternationalVersion", "quantity": 1, "amount": 129.95 } ] BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 SESSIONTYPE: WALLETSESSION WALLETSESSION için Örnek Cevap { "sessionToken" : "HZ3JBAFJ72AJTWRR75JOKWTFHMVHG7Y6UH6VTAGABLMV7LID", "responseCode" : "00", "responseMsg" : "Approved" } Pay by Link Payment İşlemleri Ödeme Linki Ekleme Bakınız Açıklama Not: Link ile ödeme mevcut müşteri ile yapılacaksa istekte CUSTOMER gönderilmelidir, aksi taktirde yeni müşteri parametreleri CUSTOMERNAME, CUSTOMERPHONE ve CUSTOMEREMAIL zorunludur. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONEXPIRY: string, required Max length: 10 Default value: '168h' Tanımlı oturum geçerlilik süresi, varsayılan geçerlilik süresi 7 gündür ( 7x24 saat ). MERCHANTPAYMENTID: string, required Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, required Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, required Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. RETURNURL: string, optional Max length: 512 Başarılı veya başarısız ödeme ardından dönüş URL değeri. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. TCKN: string, optional Max length: 11 TCKN / Müşteri Kimlik Numarası. LANGUAGE: string, optional Max length: 2 Default value: 'tr' Ödeme süresince kullanılacak sayfa dili. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. NOTIFICATIONCHANNELS: string, optional Max length: 16 NOTIFICATIONCHANNELS parametresi bildirim kanallarının belirtilmesi için kullanılır. Birden fazla kanal ile bildirim yapılacaksa kanallar , (virgül ile) birleştirilmelidir. Örn: EMAIL,SMS BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 32 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. INSTALLMENTSUPPORT: string, optional Max length: 10000 description PAYBYLINKPAYMENT için İstek Örneği ACTION: PAYBYLINKPAYMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: Customer-UCUoumJV SESSIONTYPE: PAYMENTSESSION MERCHANTPAYMENTID: Payment-UCUoumJV AMOUNT: 10.00 CURRENCY: TRY CUSTOMEREMAIL: customerEmail-UCUoumJV CUSTOMERNAME: CustomerNameUCUoumJV CUSTOMERPHONE: 123456789 RETURNURL: http://merchantReturnUrl SESSIONTYPE: PAYMENTSESSION SESSIONEXPIRY: 168h EXTRA:[ { "IsbankBolumKodu": 1 } ] ORDERITEMS:[ { "code": "T00D3AITCC", "name": "Galaxy Note 3", "description": "Description of Galaxy Note 3", "quantity": 2, "amount": 449.99 }, { "code": "B00D9AVYBM", "name": "Samsung Galaxy S III", "description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)", "quantity": 1, "amount": 149.95 }, { "code": "B00NQGP5M8", "name": "Apple iPhone 6", "description": "Apple iPhone 6, Gold, 64 GB (Unlocked) by Apple", "quantity": 1, "amount": 139.95 }, { "code": "B00U8KSUIG", "name": "Samsung Galaxy S6", "description": "Samsung Galaxy S6 SM-G920F 32GB (FACTORY UNLOCKED) 5.1 QHDBlack-InternationalVersion", "quantity": 1, "amount": 129.95 } ] PAYBYLINKPAYMENT için Örnek Cevap { "sessionToken" : "HZ3JBAFJ72AJTWRR75JOKWTFHMVHG7Y6UH6VTAGABLMV7LID", "responseCode" : "00", "responseMsg" : "Approved" } Ödeme Linki İptal Etme PAYBYLINKPAYMENTCANCEL Link ile ödeme işlemini iptal etmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PAYBYLINKPAYMENTCANCEL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYBYLINKTOKEN: string, required Max length: 48 description ACTION: PAYBYLINKPAYMENTCANCEL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] PAYBYLINKTOKEN: [PAYBYLINKTOKEN] PAYBYLINKPAYMENTCANCEL için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } Ödeme Linkini Yeniden Gönderme PAYBYLINKPAYMENTRESEND işlemi Kart Sahibine yeniden bir hatırlatma maili göndermek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PAYBYLINKPAYMENTRESEND, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYBYLINKTOKEN: string, required Max length: 48 description NOTIFICATIONCHANNELS: string, optional Max length: 16 NOTIFICATIONCHANNELS parametresi bildirim kanallarının belirtilmesi için kullanılır. Birden fazla kanal ile bildirim yapılacaksa kanallar , (virgül ile) birleştirilmelidir. Örn: EMAIL,SMS PAYBYLINKPAYMENTRESEND için İstek Örneği ACTION: PAYBYLINKPAYMENTRESEND MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] PAYBYLINKTOKEN: [PAYBYLINKTOKEN] PAYBYLINKPAYMENTRESEND için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } Tekrarlı Ödeme Planı Aksiyonları Tekrarlı Ödeme Planı Ekleme RECURRINGPLAN aksiyonu, belli bir tutar için ayrı ayrı ayarlanmış zamanlarda planlanmış ödemeler grubuna dair olan aksiyonları içerir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTANTPAYMENT: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMEREMAIL: string, required Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. FIRSTAMOUNT: decimal, optional Max length: 30 İlk tekrarlı ödeme tutarı. RECURRINGAMOUNT: decimal, required Max length: 30 Tekrarlı ödeme tutarları. RECURRENCECOUNT: decimal, required Max length: 2 Default value: '1' Tekrarlı ödeme planındaki tekrar sayısı. FREQUENCY: string, required Max length: 4 Tekrarlı ödeme sıklığı. Gün için D, ay için M, yıl için Y kullanılmalıdır. (Örn.: 5D, 3M, 1Y). STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description TOTALSELLERPAYMENTAMOUNT: decimal, optional Max length: 30 description RECURRINGPLAN için İstek Örneği ACTION: RECURRINGPLANADD INSTANTPAYMENT: YES MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: merchant-2yQZyloV CUSTOMERNAME: CustomerName 2yQZyloV CUSTOMEREMAIL: 2yQZyloV@email.com CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User RECURRINGPLANCODE: Code-JSjAuDXf FIRSTAMOUNT: 1.00 RECURRINGAMOUNT: 100.00 RECURRENCECOUNT: 5 FREQUENCY: 5D CURRENCY: TRY STARTDATE: 01-10-2015 PAYMENTSYSTEM: GarantiPOS RECURRINGPLAN için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "recurringPlanCode" : "Code-JSjAuDXf" } Tekrarlı Ödeme Planı Güncelleme Tekrarlı Ödeme Planı Güncelleme RECURRINGPLANEDIT isteği bir tekrarlı ödeme planı veya bir tekrarlı ödemenin belirli özelliklerini güncellemek için kullanılır.Bu istek ile tekrarlı ödeme planının,DurumuKart BilgileriTekrarlı ödeme tutarıÖeme sistemive bir tekrarlı ödemenin,DurumuBaşlangıç tarihiTutarıgüncellenebilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. RECURRINGSTATUS: string, optional Max length: 16 Tekrarlı ödeme durum bilgisi. RECURRINGAMOUNT: decimal, optional Max length: 30 Tekrarlı ödeme tutarları. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. RECURRENCE: decimal, optional Max length: 2 Düzenlenecek tekrarlı ödeme. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. RECURRINGPLAN için İstek Örneği ACTION: RECURRINGPLANEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CARDPAN: CARDEXPIRY: NAMEONCARD: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGAMOUNT: 50.00 RECURRINGSTATUS: INACTIVE RECURRENCECOUNT: STARTDATE: AMOUNT: PAYMENTSYSTEM: RECURRINGPLAN için Örnek Cevap { "action" : "RECURRINGPLANEDIT", "responseCode" : "00", "responseMsg" : "Approved" } Tekrarlı Ödeme Kartı Planı Aksiyonları Tekrarlı Ödeme Planı Kartı Ekleme RECURRINGPLANCARDADD action lets you to add card and relate it to recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. RECURRINGPLANCARDADD için İstek Örneği ACTION: RECURRINGPLANCARDADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User CARDSAVENAME: Test Name CARDTOKEN: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGPLANCARDADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6" } Tekrarlı Ödeme Planı Kartı Sil RECURRINGPLANCARDDELETE action lets you to remove relation between card and recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. RECURRINGPLANCARDDELETE için İstek Örneği ACTION: RECURRINGPLANCARDDELETE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: [CARDTOKEN] RECURRINGPLANCODE: [RECURRINGPLANCODE] RECURRINGPLANCARDDELETE için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } e-Cüzdan Aksiyonları Kart Güncelleme EWALLETEDITCARD aksiyonu, mevcut bir kart anahtarı vererek bu kartı düzenleyebilmenizi sağlar. Değiştirilmesine izin verilen tek alanlar kartın son kullanma tarihi ve kaydetme adımıdır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETEDITCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDEXPIRY: string, optional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, optional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. Örnek İstek MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] ACTION: EWALLETEDITCARD CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN CARDSAVENAME: My Card Name (New) CARDEXPIRY: 12.2020 Örnek Cevap { "cardToken":"ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN", "responseCode":"00", "responseMsg":"Approved" } Kart Silme EWALLETDELETECARD aksiyonu ile kayıtlı müşteri kartlarınızı silebilirsiniz. Bir kart sistemden silindikten sonra sorgulanamaz, güncellenemez ya da bununla herhangi bir şekilde ödeme yapılamaz. Kart silmek için, aşağıdaki alanların Paratika’ya gönderilmesi gerekmektedir: İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETDELETECARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: EWALLETDELETECARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN SampleRespons { "responseCode":"00", "responseMsg":"Approved" } Satıcı Aksiyonları Satıcı Ekle The SELLERADD action lets you add a seller. You should give the required parameters also optional parameters like TCKN. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLERADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, required Max length: 512 İsim LASTNAME: string, required Max length: 512 description EMAIL: string, required Max length: 512 description MOBILENUMBER: string, required Max length: 64 description TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLERADD için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [SELLER NAME] LASTNAME: [SELLER LASTNAME] EMAIL: [seller@email.com] MOBILENUMBER: [1234567890] TCKN: [012345678911] SELLERPAYMENTDUEDAY: [2] SELLERADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "WA", "sellerpaymentdueday" : "2", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLEREDIT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLERPAYMENTDUEDAY: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "sellerpaymentdueday" : "2" "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcı Ödeme Tarihi Güncellemesi Satıcı işleminin ödeme tarihini günceller İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: UPDATEPAYMENTDATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. ORDERITEMS: string, required Max length: 4096 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. UPDATESELLERPAYMENTDATE için İstek Örneği ACTION: UPDATEPAYMENTDATE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANID: [21127PnXF19482] SELLER: [ URLEncoded [{"sellerId": "seller-id", "sellerPaymentDate": "25.06.2025"}] ] UPDATESELLERPAYMENTDATE için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved" } Başvuru İşlemleri Başvuru ekle APPLICATIONADD işlemi başvuru eklemenizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, required Max length: 256 description APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONPHONE: string, required Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, required Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: APPLICATIONADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationStatus": "PA", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Düzenle BAŞVURUDÜZENLE seçeneği başvuruyu düzenlemenizi sağlar. Zorunlu parametreler olan isim ve email adresini, ayrıca opsiyonel parametreleri de düzenleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, conditional Max length: 256 description APPLICATIONEMAIL: string, conditional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONPHONE: string, optional Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, optional Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSTATUS: string, optional Max length: 16 description Tüm geçerli değerleri görün (24) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONSIGNAUTHORITIES: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONDOCUMENTDATA: string, optional Max length: 10000000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SALESSUPPORTOPINION: string, optional Max length: 256 description RequestSample ACTION: APPLICATIONEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSTATUS:[APPLICATIONSTATUS] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONDOCUMENTDATA:[APPLICATIONDOCUMENTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationDocumentData": [ { "fileType": "JPEG", "fileContent": "iLe+8q38tU8zEAOSimLdxx8ZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "fileName" } ], "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Sorgulama QUERYAPPLICATION başvuru işlemi sorgulamanizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, optional Max length: 256 description APPLICATIONEMAIL: string, optional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: QUERYAPPLICATION MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "applications": [{ "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB" "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } }] } Başvuru onayla APPLICATIONAPPROVE işlemi başvuru onaylamanızı sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONAPPROVE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONNAME: string, required Max length: 256 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONSTATUS: string, required Max length: 4 description Tüm geçerli değerleri görün (24) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. APPLICATIONREJECTMSG: string, optional Max length: 256 description SampleResponse ACTION: APPLICATIONAPPROVE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type" } } Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Hata Yönetimi Bir isteğin hata ile sonuçlanması durumunda; dönüş cevabı içerisinde ERROR ve ERRORCODE parametreleri bulunacaktır. Genel olarak meydana gelebilecek iki tür hata bulunmaktadır: Sistem hatalar ve ödeme geçidinden kaynaklanan hatalar. Merkezi Hatalar Merkezi hatalar genellikle geçersiz ya da yanlış verilen parametre değerlerinden kaynaklanmaktadır. Bu hataların kodu ERR100xx formatındadır. Hata Kodu Açıklama ERR10010 İstekte zorunlu parametrelerden biri bulunamadı ERR10011 Aynı parametre bir defadan fazla olarak gönderilmiş ERR10012 Bu değer için azami büyüklük değeri aşıldı. ERR10013 Bu değer için geçersiz veri tipi belirtilmiş ERR10014 Geçersiz güvenlik algoritması belirtilmiş ERR10015 Geçersiz üye iş yeri bilgisi belirtilmiş ERR10016 Geçersiz tutar bilgisi belirtilmiş ERR10017 Geçersiz para birimi belirtilmiş ERR10018 Geçersiz dil seçimi ERR10019 Genel hata ERR10020 Geçersiz kullanıcı bilgileri ERR10021 Boş parametre belirtilmiş, tüm parametreleri kontrol edin ERR10022 Sipariş edilen ürünlerin toplam tutarı gerçek tutarla örtüşmüyor ERR10023 Ödeme tutarı hesaplanan tutarla örtüşmüyor ERR10024 Geçersiz vergi tutarı belirtilmiş ERR10025 Belirtilen durumda vergi tutarı sıfır olmalıdır ERR10026 Geçersiz entegrasyon modeli belirtilmiş ERR10027 Geçersiz kart bilgisi (TOKEN) belirtilmiş ERR10028 Belirtilen ödeme sistemi (sanal POS) bulunamadı ERR10029 Belirtilen ödeme tipi (kampanya) bulunamadı ERR10030 Belirtilen işlem bulunamadı ERR10031 Bu işlem iade edilemez ERR10032 Geçersiz iade tutarı belirtilmiş ya da bu işlem daha önce iade edilmiş ERR10033 Bu işlem iptal edilemez ERR10034 Belirtilen ödeme bulunamadı ERR10035 Bu işlem için ön otorizasyon kaydı bulunmamaktadır ERR10036 Geçersiz son otorizasyon (POSTAUTH) tutarı belirtilmiş ERR10037 Belirtilen Kart Sahibi (Müşteri) kayıtlı değil ERR10038 İlgili ödeme onay beklemektedir ERR10039 Geçersiz ödeme durumu belirtilmiş ERR10040 Geçersiz alt işlem (SUBACTION) belirtilmiş ERR10041 Belirtilen kart daha önce eklenmiş ERR10042 Kart daha önceden silinmiş ERR10043 Geçersiz zaman aralığı belirtilmiş ERR10044 Geçersiz tarih formatı belirtilmiş ERR10045 Belirtilen kart numarası geçersizdir ERR10046 Belirtilen kredi kartı geçerlilik tarihi geçersizdir ERR10047 Kullanıcının API servislerini kullanma yetkisi bulunmamaktadır ERR10048 Başarılı Bir İşlem zaten bu üye iş yeri sipariş numarası ile var ERR10049 Geçersiz üye iş yeri grup numarası ERR10050 Geçersiz HASH değeri ERR10051 Herhangi bir ödeme sistemi (sanal pos) tanımı yok. Lütfen, kontrol ediniz. ERR10052 Desteklenmeyen para birimi: ERR10053 Kullanıcının bu üye iş yeri üzerinde işlem yapma yetkisi yok ERR10054 Ödeme geçerlilik süresi maksimum limitin üstündedir. ERR10055 Ödeme geçerlilik süresi minimum limitin altındadır. ERR10056 Geçersiz API isteği belirtilmiş ERR10057 Kart BIN bilgisi geçersiz ERR10058 Kart daha önce etkinleştirilmiş ERR10059 Kart daha önce kullanım dışı bırakılmış ERR10060 Geçersiz IP Adresi ERR10062 Belirtilen kart henüz aktive edilmemiştir. ERR10063 Bu işlem sadece LetsBodrum kart ile yapılabilir. ERR10064 Lütfen LetsBodrum kart veya Türkiye İş Bankası kredi kartı kullanınız. ERR10065 Belirtilen kart numarası daha önceden tanımlanmış. ERR10066 Belirtilen zaman bilgisi geçersiz ya da tutarsızdır ERR10067 Belirtilen period değeri çok yüksek ERR10068 Geçersiz tekrar düzeni parametresi ERR10069 Zamanlayıcı (Quartz) hatası oluştu ERR10070 Başlangı tarihi gelecekteki bir tarih olmalıdır ERR10071 Geçersiz tekrarlı ödeme durum parametresi belirtilmiş ERR10072 Tekrarlı ödeme planı zaten etkin durumda ERR10073 ERR10073 ERR10074 Tekrarlı ödeme planının zaten süresi geçmiş ERR10075 Üye iş yeri görsel (logo) bilgisi hatalı ERR10076 Geçersiz tekrarlı ödeme durum parametresi ERR10078 İşlem kilitlidir ERR10079 Bu kart sistemde kayıtlıdır. ERR10080 Lütfen, Üye İş Yeri Sipariş numarasını veya Ödeme Oturumu(Token) veriniz ERR10081 Geçersiz işlem durumu ERR10082 Kullanıcının bu işlem için yetkisi yoktur. ERR10083 Geçersiz statü ERR10084 Faiz veya indirim oranı sıfır değeri olmalıdır ERR10085 Geçerli bitiş tarihi ,geçerli başlangıç tarihten daha büyük olamaz ERR10086 Geçerli bitiş tarihi şimdiki tarihten daha büyük olmalıdır ERR10087 Taksit sayı numarası zaten bu ödeme sistemi ile bir ödeme tipi var ERR10088 Taksit bilgisi 1-12 arasında bir değer olmalıdır. ERR10089 Tekrarlı ödemeye ait kart silinemez. ERR10090 İşlem başarısız ERR10091 Ödeme sistemi devre dışı bırakıldığı için işlem gerçekleştiremiyor. Lütfen Üye İş Yeri Süper Yöneticisiyle iletişime geçiniz. ERR10092 Geçersiz offset değeri ERR10093 Geçersiz limit değeri ERR10094 Tanımlı bir kart bulunamadı. ERR10095 Kayıtlı bulunan tekrarlayan ödeme planlarından dolayı kart silinemez. ERR10096 Geçersiz oturum (session) bilgisi. ERR10097 Sonlandırılmış oturum (session) bilgisi. ERR10098 Bu oturum anahtarının yapılmak istenen işleme yetkisi yoktur. ERR10099 Bu işlem başka bir üye iş yerine ait. ERR10100 Bu ödeme için birden fazla başarılı işlem vardır. Lütfen PGTRANID parametresini kullanınız. ERR10101 Geçersiz URL parametresi belirtilmiştir. ERR10102 Geçersiz BIN değeri belirtilmiştir. ERR10103 İşlem isteği Inact RT servisi tarafından raporlanan fraud olasılığı nedeniyle reddedilmiştir. ERR10104 Kullanılabilir komisyon şeması bulunmamaktadır. ERR10105 Kartın bu ödeme havuzunda taksit yetkisi bulunmamaktadır. ERR10106 İşlem tutarı üye iş yeri hesabına geçmemiştir, iade yapılamaz. ERR10107 Bu ödeme zaten yapılmıştır, verilen Üye İş Yeri Sipariş Numarası ile yeni ödeme oturumu oluşturulamaz. ERR10108 Üye iş yeri onaylanmamış ERR10109 Ödeme havuzu üye iş yeri için henüz onaylanmamıştır. ERR10110 Kullanilan ödeme sistemi kampanya kullanımını desteklememektedir. ERR10111 Puan sorgulama ödeme sistemi tarafından desteklenmemektedir. ERR10112 Hatali puan formatı lütfen API Dokümantasyonundan puan kullanım formatını kontrol ediniz. ERR10113 Kullanilan ödeme sistemi puan kullanımını desteklememektedir. ERR10115 Üye iş yeri tarafından desteklenmeyen taksit sayısı belirtilmiştir. ERR10116 Bu işlem kullanımda olmayan üye iş yeri bilgileriyle gerçekleştirilemez. ERR10117 Bu sipariş numarası sonlanan bir oturumda kullanılmıştır lütfen farklı bir sipariş numarası ile oturum anahtarı oluşturun. ERR10118 İstek ile mevcut sipariş numarasına ait oturumun tutar, kur, oturum tipi, url dönüş değeri ya da yapılmak istenen işlem değerlerinden biri uyuşmamaktadır. ERR10119 Tam ve ya noktalı kısımda limit aşımı ERR10120 Bu plan koduna ait bir tekrarlı ödeme bulunuyor ERR10121 Geçersiz tekrarlı ödeme kodu ERR10122 Sonlanmış durumdaki tekrarlı ödeme güncellenemez. ERR10123 Geçersiz işlem tipi ERR10125 Mutabakat sorgusu için en az bir parametre geçilmeli. ERR10126 Birden fazla işlem bulundu. ERR10127 Ödeme sistemi puan parametresi hatalı, işlemin gönderileceği ödeme sisteminde gönderilen puan parametresi tanımlı değildir. ERR10128 Geçersiz parametre değeri ERR10129 Parçalı puan kullanımı bu ödeme sistemi tarafından desteklenmemektedir ERR10130 İşlem fraud süphesiyle reddedilmiştir. Detaylı bilgi için destek ekibiyle iletişime geçebilirsiniz. (TMX rejected) ERR10131 Komisyon masrafları, satıcı komisyon tutarını aşamaz. ERR10132 Ödeme isteğinde pazaryeri parametrelerini kullanmaya yetkiniz bulunmamaktadır. Lütfen Paratika destek hattıyla iletişime geçiniz. ERR10133 İstenen işlem güncellenemez. ERR10134 Ödeme sistemi tipi ya da EFT kodu bulunamadı. ERR10135 EXTRA parametresi decode edilemiyor. ERR10136 Bu üye iş yeri için ortak ödeme sayfası (HPP) kullanılamaz. ERR10137 Query Campaign Not Supported By PaymentSystem ERR10138 3D işlem yaparken hata oluştu. ERR10139 Üye İşyeri Entegrasyon Modeli Hatalı ERR10140 İşlem tipi bu ödeme sistemi tarafından desteklenmiyor. ERR10141 Beklenemedik ödeme sistemi entegrasyonu hatası ERR10142 Geçersiz Yönlendirme Adresi ERR10143 ÖDENMİŞ veya İPTAL EDİLMİŞ ödeme ERR10144 Üye iş yerinin yabancı banka kartları ile işlem yapma yetkisi yoktur ERR10145 Tekrarlı ödeme bulunamadı. ERR10146 Tekrarlı ödeme kartı bulunamadı. ERR10147 3D doğrulama olmaksızın kart ekleme yetkiniz yoktur. Lütfen HPP entegrasyon modelini kullanarak kart ekleyiniz ya da Paratika destek ekibinden yardım alınız. ERR10148 Tekrarlı ödeme planı zaten bu kart daha önce eklenmiş. ERR10149 Bu işlem için desteklenmeyen para birimi ERR10150 İndirim tutarı sipariş tutarından yüksek olamaz. ERR10151 Satıcı bulunamadı ERR10152 Bu id ile satıcı mevcuttur. ERR10153 İade işlemi Paratika Finans ekibi tarafından red edilmiştir ERR10154 İşlem 3D kısıtlamasıyla başarısız olmuştur. ERR10155 Satıcı deaktive durumdadir. Bu işlem yapılamaz. ERR10156 Unsupported Currency Conversion ERR10157 Aktivasyon tarihi gelecek tarih olmalıdır ERR10158 Geçersiz varsayılan komisyon oranı ERR10159 Geçersiz ödeme sistemi bazlı komisyon oranı ERR10160 Eksik parametre ERR10161 Ödeme sistemi havuzda bulunamadı ERR10162 Sadece 2 ile 12 arasındaki tüm taksitler parametrede sağlanmalıdır ERR10163 Save card parametresi API entegrasyon modeli için kullanılamaz ERR10164 Bu isimde havuzda kartsız işlem destekleyen ödeme sistemi bulunamadı ERR10165 Komisyon şeması bulunamadı ERR10166 ERR10166 ERR10167 Invalid sellerId - do not use semicolon ERR10168 Bu kart markası desteklenmemektedir ERR10169 Taksit bu kart markası için uygun değildir ERR10170 Girilen değer geçerli aralığın dışında. Minimum değer 1 olmalı, maksimum değer için lütfen Paratika Operasyon Ekibi'yle iletişime geçiniz. ERR10171 Belirtilen MCC bulunamadı. ERR10172 Belirtilen MCC daha önce eklenmiş ERR10173 Ürün komisyon tutarları TOTALSELLERCOMMISSIONAMOUNT parametresinde belirtilen komisyon tutarıyla uyuşmamaktadır. ERR10174 Üye İşyeri Ürün Tipi ve Komisyon Yükümlülüğü satıcılı satışı kullanabilmek için doğru şekilde güncellenemedi. ERR10175 Wrong commission applier type. ERR10176 Invalid Seller Payment Amount ERR10177 Invalid Marketplace Integration Model ERR10178 Ödeme kalemlerinin satıcı ödeme tutarlarının toplamı TOTALSELLERPAYMENTAMOUNT parametresiyle örtüşmemektedir. ERR10179 Komisyon uygulama tipi, CA(komisyon miktari), komisyon değeri ile aynı anda gönderilemez. ERR10180 Yatırımcı tipiniz için kullanmak istediğiniz kart tipi için geçersiz ERR10181 Sipariş öğelerinde hatalı üye işyeri bilgisi. ERR10182 Sipariş kalemi bulunamadı ERR10183 Sipariş kalemleri, sadece session token ile oluşturulan birincil işlemler için desteklenmektedir ERR10184 Ürün adedini ya da tutarını belirtmeniz gerekmektedir ERR10185 Item quantity or amount exceeded ERR10186 Tutar, orijinal istek tutarından daha büyük olamaz. ERR10187 Ödeme isteğinde pazaryeri parametrelerini kullanmaya yetkiniz bulunmamaktadır. Lütfen Paratika destek hattıyla iletişime geçiniz. ERR10188 Ödeme tarihi, işlem tarihinden önce olamaz. Lütfen isteği kontrol ediniz. ERR10189 Invalid or Missing EXTRA parameter value ERR10190 Üretici kart şablonu, bu ödeme sistemi tarafından desteklenmemektedir. ERR10191 VKN ve TCKN deÄerleri birlikte kullanılamaz. Lütfen sadece birini kullanınız. ERR10192 Please send ACCOUNTOWNERNAME and ACCOUNTOWNERLASTNAME only or COMMERCIALTITLE only. ERR10193 Satıcı ödeme vadesi, Üye İş Yeri ödeme vadesine eşit veya daha yüksek olmalıdır. ERR10194 Lütfen Kuveyt Türk sanal posu için alt bayi tanımlarını yapınız. ERR10195 Satıcı işleminde ürün bulunamadı ERR10196 Ödeme tarihi işlem tarihinden önce olamaz. ERR10197 Bu email adresi ve isme ait başvuru bulunamadı. ERR10198 Bu isim ve email ile bir başvuru mevcut ERR10199 Hatalı telefon numarası ERR10200 Hatalı web adresi ERR10201 Yanlış Ortak Başvuru Formatı ERR10202 Hatalı üye iş yeri başvurusu sağlandı ERR10203 Hatalı Başvuru Finans Datası sağlandı ERR10204 Geçersiz başvuru döküman verisi tedarik edildi ERR10205 Hatalı Başvuru Satş Destek Datası sağlandı ERR10206 Geçersiz Uygulama Risk Yönetimi Verisi tedarik edildi ERR10207 OTP kodu bulunamadı ERR10208 Aynı isimde bir BIN Kuralı mevcut, lütfen farklı isimle bir BIN Kuralı tanımlayınız. ERR10209 Aynı konfigürasyon ile bir BIN Kuralı mevcut, lütfen farklı konfigürasyonlar içeren bir BIN Kuralı ekleyiniz. ERR10210 BIN Kuralı taksit sayısı rakamlardan oluşmalıdır ERR10211 Bin Kuralı taksit sayısı geçerli aralığın dışında ERR10212 BIN kuralı, verilen bin kuralı adıyla bulunamadı ERR10213 Bin Kural alt limiti, üst limitten büyük olamaz. ERR10214 Girilen değer minimum uzunluğu geçmiyor ERR10215 BKM hata ERR10216 Başvuru dökümanı kayıtlıdır, farklı isimli bir döküman giriniz. ERR10217 Başvuru dökümanı ismi bulunamadı. ERR10218 Maksimum Başvuru dökümanı sayısı aşıldı. ERR10219 Geçersiz VKN. ERR10220 Geçersiz IBAN TRY. ERR10221 Link ile ödeme oturumu sonlandırıldı ERR10222 Aynı konfigürasyon ile bir BIN Kuralı ve Ödeme Sistemi Havuz kaydı mevcut ERR10223 Konfigürasyon ile bir BIN Kuralı ve Ödeme Sistemi Havuz kaydı bulunamadı ERR10224 ERR10224 ERR10225 BIN aynı anda hem yabancı hem de ülkesi Türkiye olamaz ERR10226 ERR10226 ERR10227 CARDPANTYPE parametresini INSURANCE olarak kullanmaya yetkiniz yoktur ERR10228 Hatalı CARDPAN formatı. CARDPAN İlk8/Son4/TCKN-VKN-YKN formatında olmalıdır ERR10229 NAMEONCARD, CARDEXPIRY ve CARDPANCVV parametrelerini CARDPANTYPE parametresi ile aynı anda kullanamazsınız ERR10230 CARDTOKEN parametresini CARDPANTYPE parametresi ile aynı anda kullanamazsınız ERR10231 SAVECARD parametresini CARDPANTYPE parametresi ile aynı anda kullanamazsınız ERR10232 Yabancı kart numarası ile işlem yapılamaz ERR10233 Geçersiz e-posta ERR10234 Alışveriş kredisi hizmeti, ödeme sistemi tarafından desteklenmemektedir. ERR10235 Satıcı Ödeme Tarihi Uyumsuzluğu ERR10236 Vadeli Tarih Uyumsuz ERR10237 INSTALLMENTSUPPORT için yanlış giriş değeri ERR10238 İndirim tutarı için geçersiz veri ERR10239 PPOS işlemleri için geçersiz işlem ERR10240 Yanlış İmza Yetkilisi Formatı ERR10241 Alışveriş Kredisi için girilen parametre değerleri ile PAYMENTSYSTEMTYPE değeri örtüşmelidir ERR10242 Pazaryeri müşterilerine izin verilmeyen parametre ERR10243 IDENTIFIERNUMBER için yanlış giriş değeri ERR10244 CUSTOMERPHONE ve CUSTOMEREMAIL alanları zorunludur Ödeme Sistemleri (vPOS) Kaynaklı Hatalar Paratika API yapısı, banka tarafında kullanılmakta olan ödeme geçidinden kaynaklanan hatalar için farklı bir dizi hata kodu kullanmaktadır. Bu hata dizisi ISO-8583 ’e ait 39. alan cevap değerlerinden türetilmiştir. Bu hataların kod formatı ERR200xx şeklindedir. Hata Kodu Açıklama ERR20001 Manuel onay için bankanızla iletişime geçiniz ERR20002 Sahte onay, bankanızla iletişime geçiniz ERR20003 Geçersiz üye iş yeri ya da servis sağlayıcı ERR20004 Karta el koyunuz ERR20005 İşleme onay verilmedi ERR20006 Hata (Sanal POS ya da banka tarafında sadece kayıt güncelleme cevapları bulundu) ERR20007 Karta el koyunuz - Özel nedenler ERR20008 Sahte onay, bankanızla iletişime geçiniz ERR20009 İşlem yapılan banka kartına taksit uygulanmamaktadır. ERR20011 Sahte onay (VIP), bankanızla iletişime geçiniz ERR20012 Sanal POS ya da banka tarafında geçersiz işlem ERR20013 Sanal POS hatası: Geçersiz tutar bilgisi ERR20014 Geçersiz hesap ya da kart numarası belirtilmiş ERR20015 Böyle bir banka (issuer) bulunamadı ERR20019 Sanal POS hatası: Tekrar deneyiniz ERR20020 Sanal POS hatası: Geçersiz / Hatalı tutar ERR20021 Banka / Sanal POS tarafında işlem yapılamıyor ERR20025 Sanal POS hatası: Kayıt oluşturulamadı ERR20026 Sanal POS tarafında işlem bulunamadı ERR20027 Sanal POS hatası: Banka reddetti ERR20028 Sanal POS hatası: Original is denied ERR20029 Sanal POS hatası: Original not found ERR20030 Sanal POS tarafında switch bazlı format hatası ERR20032 Sanal POS tarafında genel yönlendirme hatası ERR20033 Belirtilen kredi kartının geçerlilik süresi bitmiştir ERR20034 İşlemde sahtecilik (fraud) şüphesi ERR20036 Sanal POS hatası: Kısıtlanmış kart ERR20037 Sanal POS hatası: Banka (Issuer) kartı geri çağrıyor ERR20038 Sanal POS hatası: İzin verilen PIN deneme sayısı aşıldı ERR20040 Sanal POS hatası: İade işlemi gün sonundan önce yapılamaz ERR20041 Sanal POS hatası: Kayıp kart, karta el koyunuz ERR20043 Sanal POS hatası: Çalıntı kart, karta el koyunuz ERR20045 Puan kullanılan işlemlerde iade desteklenmemektedir. Lütfen bankanızla iletişime geçiniz. ERR20051 Belirtilen kredi kartının limiti bu işlem için yeterli değildir ERR20052 Sanal POS hatası: Çek hesabı bulunamadı ERR20053 Sanal POS hatası: Tasarruf hesabı bulunamadı ERR20054 Kartın kullanım süresi geçmiş ERR20055 Sanal POS hatası: Hatalı / Geçersiz PIN değeri ERR20056 Sanal POS hatası: Kart bilgisi bulunamadı ERR20057 Kart sahibine bu işlem yetkisi verilmemiştir ERR20058 Terminale bu işlem izni verilmemiştir ERR20059 İşlemde sahtecilik (fraud) şüphesi vardır ERR20061 Sanal POS hatası: Beklenen işlem tutar sınırı aşıldı ERR20062 Belirtilen kredi kartı kısıtlanmıştır ERR20063 Sanal POS tarafında güvenlik ihlali durumu ERR20065 Sanal POS hatası: Beklenen işlem sınırı aşıldı ERR20075 Sanal POS hatası: İzin verilen PIN deneme sayısı aşıldı ERR20076 Sanal POS anahtar eşzamanlama hatası ERR20077 Sanal POS hatası: Geçersiz / Tutarsız bilgi gönderildi ERR20080 Geçersiz tarih bilgisi ERR20081 Sanal POS şifreleme hatası ERR20082 Geçersiz / Hatalı CVV değeri ERR20083 PIN değeri doğrulanamıyor ERR20084 Geçersiz / Hatalı CVV değeri ERR20085 Sanal POS tarafında reddedildi (Genel) ERR20086 Doğrulanamadı ERR20091 Banka / Sanal POS şu an işlem gerçekleştiremiyor ERR20092 Zaman aşımı nedeniyle teknik iptal gerçekleşitiriliyor ERR20093 Kartınız e-ticaret işlemlerine kapalıdır. Bankanızı arayınız. ERR20096 Sanal POS tarafında genel hata ERR20098 Çoklu iptal (Duplicate reversal) ERR20099 Lütfen yeniden deneyiniz, sorun devam ederse bankanızla iletişime geçiniz. ERR200YK Kart kara listede bulunuyor ERR200SF Detaylar için sanal POS cevabındaki HOSTMSG alanını kontrol ediniz. ERR200GK Sanal POS hatası: Bu terminalde yanabcı kartlar için yetki bulunmamaktadır. ERR30001 Bu işlem Threat Metrix (TMX) tarafından reddedilmiştir. İlgili detaylar için lütfen işlem loglarını ve TMX portal kayıtlarını inceleyiniz. ERR30002 3D işlemi başarılı şekilde sonlanmadı. ERR30004 Bu istek fraud (sahtecilik) kuralları tarafından reddedilmiştir. ERR30005 Banka tarafından yanıt alınmadı. Ek hata cevap parametreleri İşlemin gerçekleşmemesi durumunda gerçek hatayı açıklayıcı ya da detaylandırıcı nitelikte Sanal POS / Ödeme Sistemi tarafından iletilen mesajlar 2 tane ek cevap parametresi içinde iletilmektedir PGTRANERRORCODE ve PGTRANERRORTEXT . İletilen bu bilgiler özellikle banka tarafında az rastlanan ve genel hata durumlarını açıklayan cevap bilgileridir. Hatalı cevap örnekleri Hata durumu içeren bazı API cevap örnekleri yan tarafta bulunabilir. Örnek 1: Paratika hatası: Satış işlemi (SALE) sırasında geçersiz bir kart anahtarı (CARDTOKEN) kullanılması durumunda oluşan hata. { "errorCode" : "ERR10027", "responseCode" : "99", "errorMsg" : "Geçersiz kart bilgisi (TOKEN) belirtilmiş", "responseMsg" : "Declined", "violatorParam" : "" } Örnek 2: Sanal POS / Dış Ödeme Sistemi hatası: Kredi kartında yetersiz limit sebebiyle oluşan hata. { "errorCode":"ERR20051", "responseCode":"99", "errorMsg":"Belirtilen kredi kartının limiti bu işlem için yeterli değildir", "responseMsg":"Declined", "violatorParam":"" } Örnek 3: Genel Hata: Bu üye iş yerine tanımlı olan herhangi bir ödeme sisteminin bulunmaması durumunda gerçekleşen hata. { "errorCode":"ERR20099", "responseCode":"99", "errorMsg":"Lütfen yeniden deneyiniz, sorun devam ederse bankanızla iletişime geçiniz.", "responseMsg":"Declined", "violatorParam":"" } Örnek 4: Hatasız işlem. { "apiMerchantId" : "6008138000", "paymentSystem" : "Teb test ps", "pgTranDate" : "20141215 17:22:54", "merchantPaymentId" : "session-a7bAS3AddR5PApN", "pgTranId" : "14349RW4Q89120700", "pgTranRefId" : "4398417187960", "pgOrderId" : "session-a7bRkDJK091pN", "responseCode" : "00", "responseMsg" : "Approved" }
Bildirimler Paratika, ilgili firmaya finansal işlemlerle ilgili olayları bildirmek için kullanılan yerleşik bir mekanizmaya sahiptir. Daha spesifik olarak Paratika, belirli bir olay hakkında bir firmaya aşağıdaki durumlarda bildirim mesajları gönderir: Onaylanmış bir işlem Gerçekleştirilen Bu bildirim hizmeti, Paratika, banka ödeme ağ geçidinden, bu işlemin onaylandığını onaylayan belirli bir işlem için başlatılan istek için bir yanıt aldığında onaylanan işlemler için tetiklenir. Tüccarın bitiş noktasında bildirim göndermeye çalışılırken 5 saniye bir zaman aşımına uğradığını unutmayın. Nasıl çalışır? Bir satıcı, bir dinleyici bitiş noktası oluşturmalı ve bu bitiş noktasına işaret eden URL, bu satıcının profiline eklenmelidir. Paratika, daha sonra yukarıdaki listeden bahsedilen belirli bir olay meydana geldiğinde firmaya bildirim gönderir. Böyle bir zaman olayı meydana geldiğinde, Paratika sağda gösterilen ilgili parametreleri içeren URL'ye güvenli bir FORM POST gönderir. Gönderilen örnek parametreler NOTIFICATIONTYPE: TRANSACTIONAPPROVED CHANNEL: [MERCHANTBUSINESSID] CUSTOMER: [CUSTOMERID] CUSTOMERNAME: [CUSTOMERNAME] AMOUNT: [AMOUNT] TRANSACTIONTYPE: [TRANSACTIONTYPE] CURRENCY: [CURRENCY] STATUS: [STATUS] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANSACTIONID: [PGTRANSACTIONID] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] EFTCODE: [INSTALLMENTCOUNT]
Metadata Paratika sisteminde bazı önemli anahtar data alanları şunlardır: İşlem Her bir finansal istek Paratika sisteminde bir “işlem”e karşılık gelir. Mutabakat ise bu işlemlerin kaydı üzerinden yapılır. İşlemlerin belli tipleri ve durumları vardır. Lütfen yan tarafta verilen tanımlara göz atınız. İşlem Tipleri /* Sale */ SALE, /* Pre-authorization */ PREAUTH, /* Post-authorization */ POSTAUTH, /* Refund */ REFUND, /* Partial Refund */ PTREFUND, /* Credit, Free refund */ CREDIT, /* Void action */ VOID İşlem Durumları /* In Progress, Created */ IP, /* CAncelled by CardHolder during approval */ CA, /* FAiled / Declined (Response from the integrated vPOS) */ FA, /* APproved (Response from the integrated vPOS) */ AP, /* VoiDed (As secondary process) (Response from the integrated vPOS) */ VD, /* Needs manual review (Response from the integrated vPOS exists) */ MR
Diğer Kullanım Özellikleri Paratika API'nin diğer kullanım alanlarını ve örneklerini aşağıda bulabilirsiniz. Ödeme Sayfası Bağlantısı (URL) Kullanımı Ödeme sayfası bağlantısı (URL) kullanımı SMS, mobil uygulama bildirimleri, push mesajlar , e-mail gibi kanallar ile ödemenin yapılacağı linkin müşteri ile paylaşıldığı bir ödeme opsiyonudur. Bu akışta üye iş yeri bir ödeme sayfası linki oluşturarak bu linki ilgili müşteri ile paylaşır. Müşteri kendisine ulaşan ödeme sayfası linkine tıklayarak ödeme sayfasına gider. Bu sayfada ödeme yapacağı tutarı, karşılığında alacağı ürünleri görür. Kart bilgilerini sayfadaki forma girer ve işlemini tamamlar.Ödeme sayfası bağlantısı oluşturmak isteyen üye iş yeri öncelikli olarak Paratika API üzerinden ilgili parametreler ile bir SESSIONTOKEN isteğinde bulunur. Üye iş yeri başarılı bir şekilde oluşturulan oturum anahtarı bilgisi ile satış ya da ön otorizasyon yapacağı ödeme sayfası linkini oluşturur ve ilgili müşteriyle bu linki paylaşır. Müşteri linkin geçerlilik süresi dolmadan linke tıklayıp işlemi tamamlamalıdır. Geçerlilik süresi dolan linkler "Sonlandırılmış oturum (session) bilgisi." hata sayfasına yönlendirilirken geçersiz bir oturum anahtarı ile oluşturulan linkler ise "Geçersiz oturum (session) bilgisi." sayfasına yönlendirilir. Linklerin geçerlilik süresi SESSIONTOKEN isteğindeki SESSIONEXPIRY parametresi ile belirlenir ve bu parametrenin varsayılan değeri 7gündür.Başarılı bir şekilde sonlanan işlemlerin cevabı ise SESSIONTOKEN isteğinde gönderilen RETURNURL parametresindeki adrese POST edilir. Adım 1: Paratika API üzerinden SESSIONTOKEN isteği ile bir session token oluşuturulur. ([SESSIONTOKEN]) Adım 2: Bu session token kullanılarak ödeme sayfası linki oluşturulur. (Örn. https://test.paratika.com.tr/merchant/payment/[SESSIONTOKEN]) Adım 3: Link ilgili müşteriye mail, SMS, bildirim vs. olarak gönderilir. Adım 4: Müşteri linke tıklayarak ödeme sayfasına gider ve ödeme işlemini gerçekleştirir. Adım 5: Ödeme işleminin sonucu SESSIONTOKEN isteğindeki RETURNURL parametresi ile belirtilen adrese POST edilir.
Test Kartları Burada farklı bankalar için test kartları bulabilirsinizNestpay bankaları için 3D Secure şifresi "a" dır. Test Kartları Banka Kart Numarası S.K.T CVV 3D Güvenli Şifre Ziraat-VISA 4546711234567894 12/2026 000 a Ziraat-MASTER 5401341234567891 12/2026 000 a AKBANK-VISA 4355084355084358 12/2030 000 a AKBANK-MASTER 5571135571135575 12/2030 000 a TEB-VISA 4402934402934406 12/2030 000 a TEB-MASTER 5101385101385104 12/2030 000 a HALKBANK-VISA 4920244920244921 12/2030 001 a HALKBANK-MASTER 5404355404355405 12/2030 001 a FINANSBANK-VISA 4022774022774026 12/2030 000 a FINANSBANK-MASTER 5456165456165454 12/2030 000 a ISBANK-VISA 4508034508034509 12/2030 000 a ISBANK-MASTER 5406675406675403 12/2030 000 a ANADOLUBANK-VISA 4258464258464253 12/2030 000 a ANADOLUBANK-MASTER 5222405222405229 12/2030 000 a HSBC 5100051016005572 01/2020 742 a INGBANK-VISA 4555714555714556 12/2030 000 a INGBANK-MASTER 5400245400245409 12/2030 000 a QNBFINANS-TROY 9792350046201275 07/2027 993 GARANTI-TROY 9792052565200010 01/2027 327 YKB-TROY 6501617060023449 12/2026 000 YKB-TROY 6501617025774490 12/2026 000 YKB-TROY 6501617063597076 12/2026 000 TURKIYE FINANS-TROY 9792182023832743 10/2028 878 a SEKERBANK-TROY 6501750104751517 12/2027 516 a AKBANK-TROY 9792072000017956 12/2027 000 a ABANK-TROY 36577312700094 12/2027 000 a YKB-VISA 4506344103118942 12/2025 000 YKB-VISA 4506347023253988 12/2025 000 YKB-VISA 4506347028991897 12/2025 000 YKB-VISA 4506347026523718 12/2025 000 YKB-MASTER 5400617004770430 12/2025 000 YKB-MASTER 5400617020092306 12/2025 000 YKB-MASTER 5400617030400291 12/2025 000 GARANTI-VISA 4824892919057014 12/2025 067 GARANTI-MASTER 5378297758742014 05/2025 467 KUVEYTTURK-MASTER 5188961939192544 06/2025 929 123456 VAKIFBANK-VISA 4938460158754205 01/2024 715 123456 VAKIFBANK-VISA 4119790155203496 04/2024 579 123456 VAKIFBANK-MASTER 5400617020092306 12/2025 Yok 123456
Finansal İşlemler Paratika sisteminde yer alan tüm işlem tipleri aşağıdaki gibidir: Satış Satış işlemi, müşterinin kredi kartından ödemenin anında tahsil edildiği bir işlemdir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SALE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, conditional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. CUSTOMERBIRTHDAY: date, optional Max length: 16 Format: [dd-MM-yyyy] Müşteri Doğum Günü. TCKN: string, optional Max length: 16 TCKN / Müşteri Kimlik Numarası. AUTH3DTOKEN: string, optional Max length: 16 description CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPANTYPE: string, optional Max length: 32 Card Pan Type parametresi, yapacağımız işlemde kullanıcağımız kart tipini belirlemek için kullanırız Tüm geçerli değerleri görün (1) CARDPAN: string, conditional Max length: 26 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. SAVECARD: string, optional Max length: 3 Bu parametre değeri 'yes' olarak gönderildiğinde ödeme sayfasında kart otomatik olarak kaydedilecektir. Save Card parametresi API entegrasyon modeli için kullanılamaz CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. POINTS: string, optional Max length: 500 Sale by points can be used via points argument of sale action. This parameter gets its argument as a json format and parse it according to payment system.AKBANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"XCBCHIPPARA", "value":"10"}]MULTIPLE POINTS USAGE: [{"name":"XCBCHIPPARA", "value":"10"},{"name":"PCBCHIPPARA", "value":"10"},{"name":"CCBCHIPPARA", "value":"10"}]ISBANK SALE BY POINTS SAMPLEPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"MAXIPUAN","value":"1"}]FINANSBANK SALE BY POINTS SAMPLEYou can use points if and only if PARAPUAN equal to AMOUNTPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PARAPUAN","value":"10"}] TEB BANK SALE BY POINTS SAMPLEYou can use points if and only if KULLANBONUS equal to AMOUNTPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"KULLANBONUS","value":"10"}]HALKBANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"ODUL", "value":"10"}]AKTIFBANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"KULLANPUAN","value":"10"}]GARANTI BANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"FBB","value":"5160.02"},{"name":"BNS","value":"91462.68"}] YAPI KREDI BANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PUAN","value":"10.00"}]HSBC BANK SALE BY POINTS SAMPLEPOINTS must be json String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"ODUL","value":"10.00"}]VAKIFBANK SALE BY POINTS SAMPLEPOINTS must be JSOn String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PUAN","value":"283567.72"}]SEKERBANK SALE BY POINTS SAMPLEPOINTS must be JSON String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"KULLANBONUS","value":"10"}]DENIZBANK SALE BY POINTS SAMPLEPOINTS must be JSON String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"BONUSAMOUNT","value":"10.00"}]ZIRAATBANK SALE BY POINTS SAMPLEPOINTS must be JSON String, you can use POINTS argument in SALE method like belowPOINTS : [{"name":"PUANSORGU","value":"PUANSORGU"},{"name":"KULLANPUAN","value":"10"}] BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 16 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. FASTSHIPPING: string, optional Max length: 3 Bu parametre teslimat / kargolama işleminin hızlı / acil seçeneğiyle yapılıp yapılmadığını gösterir. Hızlı teslimat seçeneği kullanılmışsa üye iş yeri tarafından "yes" olarak gönderilmelidir. Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası BUYERTYPE: string, optional Max length: 1 Default value: 'A' Üye / Anonim kullanıcı bayrağı Tüm geçerli değerleri görün () SELLERID: string, optional Max length: 1024 Satıcı başına benzersiz değer. COMMISSIONAMOUNT: string, optional Max length: 512 description DISCOUNTAMOUNT: decimal, optional Max length: 30 ORDERITEMS içerisinde belirtilen toplam tutardan düşülecek indirim tutarını belirtir. Eğer bu alanda bir değer yollanırsa, AMOUNT alanı ORDERITEMS toplamı ile DISCOUNTAMOUNT indirim tutarı farkına eşit olmalıdır. (AMOUNT = ORDERITEMS - DISCOUNTAMOUNT) FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description NOTIFICATIONURL: string, optional Max length: 255 description SELLERPAYMENTAMOUNT: string, optional Max length: 512 description THREATMETRIXSESSIONID: string, optional Max length: 128 description TMXSESSIONQUERYINPUT: string, optional Max length: 100000 Session query input that can be retrieved from Threat Metrix. A request needs to be sent at https://h-api.online-metrix.net/api/session-query, with those parameters: org_id (provided by Paratika), api_key (provided by Paratika), session_id (unique identifier, stored in the session, can be retrieved from QUERYSESSION), service_type (value should be 'session-policy'), event_type (value should be 'payment'), policy (provided by Paratika). e.g. https://h-api.online-metrix.net/api/session-query?org_id=[org_id]&api_key=[api_key]&session_id=[session_id]&service_type=session-policy&event_type=payment&policy=[policy] CUSTOMERTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (5) CAMPAIGNS: string, optional Max length: 1024 It represents the campaigns which is provided encoded JSON object. Example: [{"campaignCode": "taks3","campaignName": "2","campaignExtra": "ArtiTaksit"}] - while sending the request it must be encoded MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. Örnek İstek ACTION: SALE AMOUNT: 18.75 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-3gMvdMzXMj2q MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: Customer-Lsw7mJAm CUSTOMERNAME: Name Lsw7mJAm CUSTOMEREMAIL: Lsw7mJAm@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name Lsw7mJAm CUSTOMERPHONE: +901638874658 CUSTOMERBIRTHDAY: 01-01-2001 BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 CARDPAN: 5456165456165454 CARDEXPIRY: 12.2020 CARDCVV: 000 Örnek Cevap { "action" : "SALE", "merchant" : "10000000", "amount" : 18.75, "currency" : "TRY", "apiMerchantId" : "600600000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "paymentSystemType" : "FINANS", "paymentSystemEftCode" : "0111", "pgTranDate" : "20160729 12:18:53", "merchantPaymentId" : "PaymentId-3gMvdMzXMj2q", "pgTranId" : "16211MS3D00124776", "pgTranRefId" : "621112352883", "pgOrderId" : "PaymentId-3gMvdMzXMj2q", "responseCode" : "00", "responseMsg" : "Approved", "tmxSessionQueryOutput" : "" } Preauth Ön Otorizasyon işlemi müşterinin kredi kartında söz konusu tutara bloke koyan bir işlemdir. Bu şekilde bloke edilen tutar, Son Otorizasyon işlemi yapılana kadar karttan tahsilat yapmaz. Ön otorizasyon işlemi ile konulan blokenin süresi bankaya göre değişebilmektedir . Bu süre üç gün kadar kısa olabileceği gibi birkaç ay kadar uzun da olabilir. Üye iş yeri olarak kendi finansal güvenliğiniz için, ön otorizasyonu onay alan siparişlerin teslimatında hızlı davranmanızı ve bu işlemleri en kısa zamanda son otorizasyonla kapatmanızı öneririz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PREAUTH, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPANTYPE: string, optional Max length: 32 Card Pan Type parametresi, yapacağımız işlemde kullanıcağımız kart tipini belirlemek için kullanırız Tüm geçerli değerleri görün (1) CARDPAN: string, conditional Max length: 26 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, conditional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. CUSTOMERBIRTHDAY: date, optional Max length: 16 Format: [dd-MM-yyyy] Müşteri Doğum Günü. TCKN: string, optional Max length: 16 TCKN / Müşteri Kimlik Numarası. AUTH3DTOKEN: string, optional Max length: 16 description INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. SAVECARD: string, optional Max length: 3 Bu parametre değeri 'yes' olarak gönderildiğinde ödeme sayfasında kart otomatik olarak kaydedilecektir. Save Card parametresi API entegrasyon modeli için kullanılamaz CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 16 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. FASTSHIPPING: string, optional Max length: 3 Bu parametre teslimat / kargolama işleminin hızlı / acil seçeneğiyle yapılıp yapılmadığını gösterir. Hızlı teslimat seçeneği kullanılmışsa üye iş yeri tarafından "yes" olarak gönderilmelidir. Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası BUYERTYPE: string, optional Max length: 1 Default value: 'A' Üye / Anonim kullanıcı bayrağı Tüm geçerli değerleri görün () SELLERID: string, optional Max length: 1024 Satıcı başına benzersiz değer. COMMISSIONAMOUNT: string, optional Max length: 512 description SELLERPAYMENTAMOUNT: string, optional Max length: 512 description DISCOUNTAMOUNT: decimal, optional Max length: 30 ORDERITEMS içerisinde belirtilen toplam tutardan düşülecek indirim tutarını belirtir. Eğer bu alanda bir değer yollanırsa, AMOUNT alanı ORDERITEMS toplamı ile DISCOUNTAMOUNT indirim tutarı farkına eşit olmalıdır. (AMOUNT = ORDERITEMS - DISCOUNTAMOUNT) FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. NOTIFICATIONURL: string, optional Max length: 255 description THREATMETRIXSESSIONID: string, optional Max length: 128 description TMXSESSIONQUERYINPUT: string, optional Max length: 100000 Session query input that can be retrieved from Threat Metrix. A request needs to be sent at https://h-api.online-metrix.net/api/session-query, with those parameters: org_id (provided by Paratika), api_key (provided by Paratika), session_id (unique identifier, stored in the session, can be retrieved from QUERYSESSION), service_type (value should be 'session-policy'), event_type (value should be 'payment'), policy (provided by Paratika). e.g. https://h-api.online-metrix.net/api/session-query?org_id=[org_id]&api_key=[api_key]&session_id=[session_id]&service_type=session-policy&event_type=payment&policy=[policy] CUSTOMERTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (5) MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. Örnek İstek ACTION: PREAUTH AMOUNT: 18.73 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-a1aJk7isjUFa MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD MERCHANT: [MERCHANT] CUSTOMER: Customer-8UtUjDuF CUSTOMERNAME: Name 8UtUjDuF CUSTOMEREMAIL: 8UtUjDuF@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name 8UtUjDuF CUSTOMERPHONE: +903150474176 CUSTOMERBIRTHDAY: 01-01-2001 BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 CARDPAN: 4022774022774026 CARDEXPIRY: 12.2020 CARDCVV: 000 SELLERID: seller01; seller02 COMMISSIONAMOUNT: 50,55;35,62 Örnek Cevap { "action" : "PREAUTH", "merchant" : "10000000", "amount" : 18.73, "currency" : "TRY", "apiMerchantId" : "600600000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "paymentSystemType" : "FINANS", "paymentSystemEftCode" : "0111", "pgTranDate" : "20160729 12:28:16", "merchantPaymentId" : "PaymentId-a1aJk7isjUFa", "pgTranId" : "16211McQE00102144", "pgTranRefId" : "621112352885", "pgOrderId" : "PaymentId-a1aJk7isjUFa", "responseCode" : "00", "responseMsg" : "Approved", "tmxSessionQueryOutput" : "" } Postauth Son Otorizasyon(Post Otorizasyon), Ön Otorizasyon işlemi kullanılarak daha önceden rezerve edilen belirli bir tutarın müşterinin kredi kartından tahsil edildiği bir işlemdir. Son Otorizasyon (Post Otorizasyon) işlemine, Ön Otorizasyon işlemi için belirtilenden daha yüksek bir tutar girdiğiniz takdirde Son Otorizasyon(Post Otorizasyon) işlemi reddedilebilir. Ön Otorizasyon yapılandan daha küçük bir tutar girilmesi halinde otorizasyonda yalnızca müşterinin kartında işlem için bulunan daha düşük miktarlardaki bakiyeleri yakalamak üzere ayarlama yapılır. Son Otorizasyon(Post Otorizasyon) işlemleri ön otorizasyon alındıktan sonra belirli bir süre içerisinde tamamlanmalıdır. Bu süre, kart düzenleyenin politikasına göre 3 gün ile 75 gün arasında değişiklik gösterir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: POSTAUTH, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, optional Max length: 30 Default value: '0' İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. Örnek İstek ACTION: POSTAUTH MERCHANT: [MERCHANT] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTUSER: [MERCHANTUSER] MERCHANTPAYMENTID: pf-1352728431091 ORDERITEMS: [ { "productCode": "T00D3AITCC", "quantity": 2 }, { "productCode": "B00D9AVYBM", "amount": 150 } Parçalı son otorizasyon yapmak istiyorsanız, ORDERITEMS parametresini POSTAUTH isteğinde gönderebilirsiniz. Tutar girilen sipariş kalemleri üzerinden hesaplanacaktır. Ya ürün adedi ya da tutarını belirtmeniz gerekmektedir. Örnek Cevap { "action" : "POSTAUTH", "merchant" : "testmerchant", "amount" : "17.22", "currency" : "TRY", "pgTranId": "12317QR6A12524", "merchantPaymentId": "pf-1352728431091", "responseMsg": "Approved", "responseCode": "00", "pgTranRefId": "231700000252", "pgOrderId": "ORDER-12317QQDG12490", "apiMerchantId":"700100000", "paymentSystem":"ISBANK TEST", "pgTranDate":"20140927 14:51:27" } İptal İptal işlemi kendisinden başka her işlemi iptal etmek için kullanılır. İptal işleminin başarılı olması için, bu işlemin, kartı düzenleyen banka (Issuer) tarafındaki “gün sonu mutabakat” sürecinde yer almamış olması gerekmektedir. Gün Sonu Mutabakatı, tüm işlemlerin mutabakatı için iş gününün sonunda gerçekleştirilen süreçtir. Bu işlem tam olarak, söz konusu ödeme tutarının, kredi kartı hamilinin hesabından üye iş yerinin banka hesabına aktarıldığında gerçekleşir. Bu nedenle, “gün sonu mutabakatının” bir parçası olarak halihazırda işlem görmüş bir satış ya da son otorizasyon işlemini iptal etmek istemeniz gibi bir durumda, iptal edilen istek için bir başarısız hata kodu alırsınız. Bu durumda, “iptal” işlemi yerine “ücret iadesi” seçeneğini kullanmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VOID, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} Örnek İstek ACTION: VOID MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] PGTRANID: 14339MfqD01014997 REFLECTCOMMISSION : Örnek Cevap { "merchantPaymentId":"session-QKFRg437iRrg", "pgTranId":"14339MfqD01014997", "pgTranRefId":"433912398111", "pgOrderId":"session-QKFRg437iRrg", "responseCode":"00", "responseMsg":"Approved" } İade Bir Ücret İadesi işlemi, sistemdeki mevcut bir siparişe yönelik bakiyelerin müşterinin kredi kartına iadesini sağlar. Tamamlanmış bir ödeme işlemini iade etmek için, o işlemin numarasına ihtiyaç duyulur. Bu numara rapor ekranlarından temin edilebilir. Bir Tüm ödeme tutarının iadesini gerçekleştirdiğinizde ödeme tutarı asıl tutara sıfırlanacaktır.İade işlemi günsonuna girmiş işlemler için yapılabilmektedir, eğer işlem günsonuna girmediyse işlem iptal edilmelidir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: REFUND, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. NOTIFICATIONURL: string, optional Max length: 255 description ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. REFLECTCOMMISSION: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} Örnek İstek ACTION: REFUND MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY AMOUNT: 17.17 PGTRANID: 14339MjuG01015018 REFLECTCOMMISSION: No Örnek Cevap { "merchantPaymentId":"session-deQdckAmzHK4", "pgTranId":"14339MkiG01015022", "pgTranRefId":"433912398115", "pgOrderId":"session-deQdckAmzHK4", "responseCode":"00", "responseMsg":"Approved", "refundType":"FULL" }
Session Session Token Oturum anahtarı tarayıcı ve ya API bazlı entegrasyon modellerinde kullanılabilir. Sistem geçerli oturum anahtarı isteğine API'ye sınırlı zaman aralığında(tanımlı olarak 7 gün. İstek içerisinde değiştirebilir) erişim hakkı tanımaktadır. Oturum anahtarı isteği her oturum için tekil bir üye iş yeri sipariş numarası beklemektedir. Aşağadaki kurallara uygun şekilde oturum anahtarı aynı üye iş yeri sipariş numarası ile kullanılabilir: Üye iş yeri bu sipariş numarası ile sonlandırılmış(basarılı veya iptal edilmiş) bir işleme sahip degil ise. Oturum anahtarının geçerlilik süresi dolmamış ise. Aynı sipariş numarası ile yeni oluşturulacak oturum anahtarında ana oturum degişkenleri(amount, customer,currency,sessionType and returnUrl) değişmedi ise üye iş yeri aynı sipariş numarası ile yukaridaki maddelere göre oturum anahtarı isteği gönderebilir. Threat Metrix Fraud Tool In order to integrate ThreatMetrix device intelligence with your website, you need to insert profiling tags on web pages where you will profile visitor devices and check page integrity. To do that, you will need: UNIQUE_SESSION_ID, you can get it from making a QUERYSESSION, in response you will have this value stored in threatMetrixSessionId, ORG_ID, contact PF to get this information <!-- NOTE * Replace UNIQUE_SESSION_ID with a uniquely generated handle * PAGEID is only needed for TDCloud, replace PAGEID with an unique ID for that page, if omitted, default is 1 for production * For production replace h.online-metrix.net with a local URL and configure your web server to redirect to h.online-metrix.net. When using whitewolf, if a web server is configured, HOST should be the host of your web server, if not configured the HOST should be h.online-metrix.net * Replace PF_HOST with the appropriate host Test: https://test.paratika.com.tr/paratika Production: https://vpos.paratika.com.tr/paratika --> <script type="text/javascript" src="https://PF_HOST/paratika/static/external/whitewolf-v3.js"></script> <script type="text/javascript"> whitewolf.run(HOST, ORG_ID, UNIQUE_SESSION_ID); </script> <noscript> <iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://h.online-metrix.net/tags?org_id=ORG_ID&session_id=UNIQUE_SESSION_ID&pageid=PAGEID"> </iframe> </noscript> İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SESSIONTOKEN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SESSIONTYPE: string, required Max length: 30 Ödeme ve Cüzdan için oturum tipi (PAYMENTSESSION or WALLETSESSION) Tüm geçerli değerleri görün (3) RETURNURL: string, required Max length: 256 Başarılı veya başarısız ödeme ardından dönüş URL değeri. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, conditional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERBIRTHDAY: date, optional Max length: 16 Format: [dd-MM-yyyy] Müşteri Doğum Günü. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. ORDERITEMS: string, conditional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. TCKN: string, optional Max length: 16 TCKN / Müşteri Kimlik Numarası. SESSIONEXPIRY: string, optional Max length: 5 Default value: '168h' Tanımlı oturum geçerlilik süresi, varsayılan geçerlilik süresi 7 gündür ( 7x24 saat ). LANGUAGE: string, optional Max length: 2 Default value: 'tr' Ödeme süresince kullanılacak sayfa dili. BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 32 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. FASTSHIPPING: string, optional Max length: 3 Default value: 'NO' Bu parametre teslimat / kargolama işleminin hızlı / acil seçeneğiyle yapılıp yapılmadığını gösterir. Hızlı teslimat seçeneği kullanılmışsa üye iş yeri tarafından "yes" olarak gönderilmelidir. Tüm geçerli değerleri görün (2) EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası DISCOUNTAMOUNT: decimal, optional Max length: 30 ORDERITEMS içerisinde belirtilen toplam tutardan düşülecek indirim tutarını belirtir. Eğer bu alanda bir değer yollanırsa, AMOUNT alanı ORDERITEMS toplamı ile DISCOUNTAMOUNT indirim tutarı farkına eşit olmalıdır. (AMOUNT = ORDERITEMS - DISCOUNTAMOUNT) SELLERID: string, optional Max length: 1024 Satıcı başına benzersiz değer. COMMISSIONAMOUNT: string, optional Max length: 512 description SELLERPAYMENTAMOUNT: string, optional Max length: 512 description TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description TOTALSELLERPAYMENTAMOUNT: decimal, optional Max length: 30 description THREATMETRIXSESSIONID: string, optional Max length: 128 description TMXSESSIONQUERYINPUT: string, optional Max length: 100000 Session query input that can be retrieved from Threat Metrix. A request needs to be sent at https://h-api.online-metrix.net/api/session-query, with those parameters: org_id (provided by Paratika), api_key (provided by Paratika), session_id (unique identifier, stored in the session, can be retrieved from QUERYSESSION), service_type (value should be 'session-policy'), event_type (value should be 'payment'), policy (provided by Paratika). e.g. https://h-api.online-metrix.net/api/session-query?org_id=[org_id]&api_key=[api_key]&session_id=[session_id]&service_type=session-policy&event_type=payment&policy=[policy] CUSTOMERTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (5) CHECKOUTPAGEURL: string, optional Max length: 512 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. CARDPANTYPE: string, optional Max length: 32 Card Pan Type parametresi, yapacağımız işlemde kullanıcağımız kart tipini belirlemek için kullanırız Tüm geçerli değerleri görün (1) ISSPLITPAYMENTTRANSACTION: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) PAYMENTSESSION için İstek Örneği ACTION: SESSIONTOKEN MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] AMOUNT: 11.21 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-FuldmrwwiOpb RETURNURL: https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp CUSTOMER: Customer-jNPz2qSI CUSTOMERNAME: Name jNPz2qSI CUSTOMEREMAIL: jNPz2qSI@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name jNPz2qSI CUSTOMERPHONE: 6381053412 ORDERITEMS: [ { "productCode": "T00D3AITCC", "name": "Galaxy Note 3", "description": "Description of Galaxy Note 3", "quantity": 2, "amount": 449.99 }, { "productCode": "B00D9AVYBM", "name": "Samsung Galaxy S III", "description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)", "quantity": 1, "amount": 149.95 }, { "productCode": "B00NQGP5M8", "name": "Apple iPhone 6", "description": "Apple iPhone 6, Gold, 64 GB (Unlocked) by Apple", "quantity": 1, "amount": 139.95 }, { "productCode": "B00U8KSUIG", "name": "Samsung Galaxy S6", "description": "Samsung Galaxy S6 SM-G920F 32GB (FACTORY UNLOCKED) 5.1 QHDBlack-InternationalVersion", "quantity": 1, "amount": 129.95 } ] DISCOUNTAMOUNT: 2.50 BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 SESSIONTYPE: PAYMENTSESSION SELLERID: seller01; seller02 COMMISSIONAMOUNT: 50.55;35.62 If "productCode" ORDERITEMS is not sent, it will be generated. If sent, it must be unique. PAYMENTSESSION için Örnek Cevap { "sessionToken" : "HCZVQH5FIR5QBHBQCT6AMUJLVHEHXCMSQ2HA5I6WCGQKQNQX", "responseCode" : "00", "responseMsg" : "Approved" } WALLETSESSION için İstek Örneği ACTION: SESSIONTOKEN AMOUNT: 17.82 CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-DkOxtbUcP7gF MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] RETURNURL: https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp CUSTOMER: Customer-PJYbATmL CUSTOMERNAME: Name PJYbATmL CUSTOMEREMAIL: PJYbATmL@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name PJYbATmL CUSTOMERPHONE: 8487817375 ORDERITEMS: [ { "productCode": "T00D3AITCC", "name": "Galaxy Note 3", "description": "Description of Galaxy Note 3", "quantity": 2, "amount": 449.99 }, { "productCode": "B00D9AVYBM", "name": "Samsung Galaxy S III", "description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)", "quantity": 1, "amount": 149.95 }, { "productCode": "B00NQGP5M8", "name": "Apple iPhone 6", "description": "Apple iPhone 6, Gold, 64 GB (Unlocked) by Apple", "quantity": 1, "amount": 139.95 }, { "productCode": "B00U8KSUIG", "name": "Samsung Galaxy S6", "description": "Samsung Galaxy S6 SM-G920F 32GB (FACTORY UNLOCKED) 5.1 QHDBlack-InternationalVersion", "quantity": 1, "amount": 129.95 } ] BILLTOADDRESSLINE: Road BILLTOCITY: Istanbul BILLTOCOUNTRY: Turkey BILLTOPOSTALCODE: 1103 BILLTOPHONE: 123456789 SHIPTOADDRESSLINE: Road SHIPTOCITY: Ankara SHIPTOCOUNTRY: Turkey SHIPTOPOSTALCODE: 1105 SHIPTOPHONE: 987654321 SESSIONTYPE: WALLETSESSION WALLETSESSION için Örnek Cevap { "sessionToken" : "HZ3JBAFJ72AJTWRR75JOKWTFHMVHG7Y6UH6VTAGABLMV7LID", "responseCode" : "00", "responseMsg" : "Approved" }
Pay by Link Payment İşlemleri Ödeme Linki Ekleme Bakınız Açıklama Not: Link ile ödeme mevcut müşteri ile yapılacaksa istekte CUSTOMER gönderilmelidir, aksi taktirde yeni müşteri parametreleri CUSTOMERNAME, CUSTOMERPHONE ve CUSTOMEREMAIL zorunludur. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONEXPIRY: string, required Max length: 10 Default value: '168h' Tanımlı oturum geçerlilik süresi, varsayılan geçerlilik süresi 7 gündür ( 7x24 saat ). MERCHANTPAYMENTID: string, required Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, required Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CURRENCY: string, required Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. RETURNURL: string, optional Max length: 512 Başarılı veya başarısız ödeme ardından dönüş URL değeri. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CUSTOMEREMAIL: string, conditional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, conditional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. TCKN: string, optional Max length: 11 TCKN / Müşteri Kimlik Numarası. LANGUAGE: string, optional Max length: 2 Default value: 'tr' Ödeme süresince kullanılacak sayfa dili. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. NOTIFICATIONCHANNELS: string, optional Max length: 16 NOTIFICATIONCHANNELS parametresi bildirim kanallarının belirtilmesi için kullanılır. Birden fazla kanal ile bildirim yapılacaksa kanallar , (virgül ile) birleştirilmelidir. Örn: EMAIL,SMS BILLTOADDRESSLINE: string, optional Max length: 255 Bill To Address Line BILLTOCITY: string, optional Max length: 32 Bill To City BILLTOPOSTALCODE: string, optional Max length: 16 Bill To Postal Code BILLTOCOUNTRY: string, optional Max length: 32 Bill To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. BILLTOPHONE: string, optional Max length: 32 Fatura bilgilerine ait telefon numarası SHIPTOADDRESSLINE: string, optional Max length: 255 Ship To Address Line SHIPTOCITY: string, optional Max length: 32 Ship To City SHIPTOPOSTALCODE: string, optional Max length: 32 Ship To Postal Code SHIPTOCOUNTRY: string, optional Max length: 32 Ship To CountryISO 3166-1 standardında yer alan bir alpha-3 kodu gönderilmelidir. SHIPTOPHONE: string, optional Max length: 32 Teslimat bilgilerine ait telefon numarası EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. INSTALLMENTSUPPORT: string, optional Max length: 10000 description PAYBYLINKPAYMENT için İstek Örneği ACTION: PAYBYLINKPAYMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: Customer-UCUoumJV SESSIONTYPE: PAYMENTSESSION MERCHANTPAYMENTID: Payment-UCUoumJV AMOUNT: 10.00 CURRENCY: TRY CUSTOMEREMAIL: customerEmail-UCUoumJV CUSTOMERNAME: CustomerNameUCUoumJV CUSTOMERPHONE: 123456789 RETURNURL: http://merchantReturnUrl SESSIONTYPE: PAYMENTSESSION SESSIONEXPIRY: 168h EXTRA:[ { "IsbankBolumKodu": 1 } ] ORDERITEMS:[ { "code": "T00D3AITCC", "name": "Galaxy Note 3", "description": "Description of Galaxy Note 3", "quantity": 2, "amount": 449.99 }, { "code": "B00D9AVYBM", "name": "Samsung Galaxy S III", "description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)", "quantity": 1, "amount": 149.95 }, { "code": "B00NQGP5M8", "name": "Apple iPhone 6", "description": "Apple iPhone 6, Gold, 64 GB (Unlocked) by Apple", "quantity": 1, "amount": 139.95 }, { "code": "B00U8KSUIG", "name": "Samsung Galaxy S6", "description": "Samsung Galaxy S6 SM-G920F 32GB (FACTORY UNLOCKED) 5.1 QHDBlack-InternationalVersion", "quantity": 1, "amount": 129.95 } ] PAYBYLINKPAYMENT için Örnek Cevap { "sessionToken" : "HZ3JBAFJ72AJTWRR75JOKWTFHMVHG7Y6UH6VTAGABLMV7LID", "responseCode" : "00", "responseMsg" : "Approved" } Ödeme Linki İptal Etme PAYBYLINKPAYMENTCANCEL Link ile ödeme işlemini iptal etmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PAYBYLINKPAYMENTCANCEL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYBYLINKTOKEN: string, required Max length: 48 description ACTION: PAYBYLINKPAYMENTCANCEL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] PAYBYLINKTOKEN: [PAYBYLINKTOKEN] PAYBYLINKPAYMENTCANCEL için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } Ödeme Linkini Yeniden Gönderme PAYBYLINKPAYMENTRESEND işlemi Kart Sahibine yeniden bir hatırlatma maili göndermek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: PAYBYLINKPAYMENTRESEND, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYBYLINKTOKEN: string, required Max length: 48 description NOTIFICATIONCHANNELS: string, optional Max length: 16 NOTIFICATIONCHANNELS parametresi bildirim kanallarının belirtilmesi için kullanılır. Birden fazla kanal ile bildirim yapılacaksa kanallar , (virgül ile) birleştirilmelidir. Örn: EMAIL,SMS PAYBYLINKPAYMENTRESEND için İstek Örneği ACTION: PAYBYLINKPAYMENTRESEND MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] PAYBYLINKTOKEN: [PAYBYLINKTOKEN] PAYBYLINKPAYMENTRESEND için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } Tekrarlı Ödeme Planı Aksiyonları Tekrarlı Ödeme Planı Ekleme RECURRINGPLAN aksiyonu, belli bir tutar için ayrı ayrı ayarlanmış zamanlarda planlanmış ödemeler grubuna dair olan aksiyonları içerir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTANTPAYMENT: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMEREMAIL: string, required Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. FIRSTAMOUNT: decimal, optional Max length: 30 İlk tekrarlı ödeme tutarı. RECURRINGAMOUNT: decimal, required Max length: 30 Tekrarlı ödeme tutarları. RECURRENCECOUNT: decimal, required Max length: 2 Default value: '1' Tekrarlı ödeme planındaki tekrar sayısı. FREQUENCY: string, required Max length: 4 Tekrarlı ödeme sıklığı. Gün için D, ay için M, yıl için Y kullanılmalıdır. (Örn.: 5D, 3M, 1Y). STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description TOTALSELLERPAYMENTAMOUNT: decimal, optional Max length: 30 description RECURRINGPLAN için İstek Örneği ACTION: RECURRINGPLANADD INSTANTPAYMENT: YES MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: merchant-2yQZyloV CUSTOMERNAME: CustomerName 2yQZyloV CUSTOMEREMAIL: 2yQZyloV@email.com CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User RECURRINGPLANCODE: Code-JSjAuDXf FIRSTAMOUNT: 1.00 RECURRINGAMOUNT: 100.00 RECURRENCECOUNT: 5 FREQUENCY: 5D CURRENCY: TRY STARTDATE: 01-10-2015 PAYMENTSYSTEM: GarantiPOS RECURRINGPLAN için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "recurringPlanCode" : "Code-JSjAuDXf" } Tekrarlı Ödeme Planı Güncelleme Tekrarlı Ödeme Planı Güncelleme RECURRINGPLANEDIT isteği bir tekrarlı ödeme planı veya bir tekrarlı ödemenin belirli özelliklerini güncellemek için kullanılır.Bu istek ile tekrarlı ödeme planının,DurumuKart BilgileriTekrarlı ödeme tutarıÖeme sistemive bir tekrarlı ödemenin,DurumuBaşlangıç tarihiTutarıgüncellenebilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. RECURRINGSTATUS: string, optional Max length: 16 Tekrarlı ödeme durum bilgisi. RECURRINGAMOUNT: decimal, optional Max length: 30 Tekrarlı ödeme tutarları. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. RECURRENCE: decimal, optional Max length: 2 Düzenlenecek tekrarlı ödeme. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. RECURRINGPLAN için İstek Örneği ACTION: RECURRINGPLANEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CARDPAN: CARDEXPIRY: NAMEONCARD: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGAMOUNT: 50.00 RECURRINGSTATUS: INACTIVE RECURRENCECOUNT: STARTDATE: AMOUNT: PAYMENTSYSTEM: RECURRINGPLAN için Örnek Cevap { "action" : "RECURRINGPLANEDIT", "responseCode" : "00", "responseMsg" : "Approved" } Tekrarlı Ödeme Kartı Planı Aksiyonları Tekrarlı Ödeme Planı Kartı Ekleme RECURRINGPLANCARDADD action lets you to add card and relate it to recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. RECURRINGPLANCARDADD için İstek Örneği ACTION: RECURRINGPLANCARDADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User CARDSAVENAME: Test Name CARDTOKEN: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGPLANCARDADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6" } Tekrarlı Ödeme Planı Kartı Sil RECURRINGPLANCARDDELETE action lets you to remove relation between card and recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. RECURRINGPLANCARDDELETE için İstek Örneği ACTION: RECURRINGPLANCARDDELETE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: [CARDTOKEN] RECURRINGPLANCODE: [RECURRINGPLANCODE] RECURRINGPLANCARDDELETE için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } e-Cüzdan Aksiyonları Kart Güncelleme EWALLETEDITCARD aksiyonu, mevcut bir kart anahtarı vererek bu kartı düzenleyebilmenizi sağlar. Değiştirilmesine izin verilen tek alanlar kartın son kullanma tarihi ve kaydetme adımıdır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETEDITCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDEXPIRY: string, optional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, optional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. Örnek İstek MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] ACTION: EWALLETEDITCARD CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN CARDSAVENAME: My Card Name (New) CARDEXPIRY: 12.2020 Örnek Cevap { "cardToken":"ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN", "responseCode":"00", "responseMsg":"Approved" } Kart Silme EWALLETDELETECARD aksiyonu ile kayıtlı müşteri kartlarınızı silebilirsiniz. Bir kart sistemden silindikten sonra sorgulanamaz, güncellenemez ya da bununla herhangi bir şekilde ödeme yapılamaz. Kart silmek için, aşağıdaki alanların Paratika’ya gönderilmesi gerekmektedir: İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETDELETECARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: EWALLETDELETECARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN SampleRespons { "responseCode":"00", "responseMsg":"Approved" } Satıcı Aksiyonları Satıcı Ekle The SELLERADD action lets you add a seller. You should give the required parameters also optional parameters like TCKN. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLERADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, required Max length: 512 İsim LASTNAME: string, required Max length: 512 description EMAIL: string, required Max length: 512 description MOBILENUMBER: string, required Max length: 64 description TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLERADD için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [SELLER NAME] LASTNAME: [SELLER LASTNAME] EMAIL: [seller@email.com] MOBILENUMBER: [1234567890] TCKN: [012345678911] SELLERPAYMENTDUEDAY: [2] SELLERADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "WA", "sellerpaymentdueday" : "2", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLEREDIT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLERPAYMENTDUEDAY: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "sellerpaymentdueday" : "2" "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcı Ödeme Tarihi Güncellemesi Satıcı işleminin ödeme tarihini günceller İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: UPDATEPAYMENTDATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. ORDERITEMS: string, required Max length: 4096 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. UPDATESELLERPAYMENTDATE için İstek Örneği ACTION: UPDATEPAYMENTDATE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANID: [21127PnXF19482] SELLER: [ URLEncoded [{"sellerId": "seller-id", "sellerPaymentDate": "25.06.2025"}] ] UPDATESELLERPAYMENTDATE için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved" } Başvuru İşlemleri Başvuru ekle APPLICATIONADD işlemi başvuru eklemenizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, required Max length: 256 description APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONPHONE: string, required Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, required Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: APPLICATIONADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationStatus": "PA", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Düzenle BAŞVURUDÜZENLE seçeneği başvuruyu düzenlemenizi sağlar. Zorunlu parametreler olan isim ve email adresini, ayrıca opsiyonel parametreleri de düzenleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, conditional Max length: 256 description APPLICATIONEMAIL: string, conditional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONPHONE: string, optional Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, optional Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSTATUS: string, optional Max length: 16 description Tüm geçerli değerleri görün (24) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONSIGNAUTHORITIES: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONDOCUMENTDATA: string, optional Max length: 10000000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SALESSUPPORTOPINION: string, optional Max length: 256 description RequestSample ACTION: APPLICATIONEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSTATUS:[APPLICATIONSTATUS] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONDOCUMENTDATA:[APPLICATIONDOCUMENTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationDocumentData": [ { "fileType": "JPEG", "fileContent": "iLe+8q38tU8zEAOSimLdxx8ZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "fileName" } ], "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Sorgulama QUERYAPPLICATION başvuru işlemi sorgulamanizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, optional Max length: 256 description APPLICATIONEMAIL: string, optional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: QUERYAPPLICATION MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "applications": [{ "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB" "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } }] } Başvuru onayla APPLICATIONAPPROVE işlemi başvuru onaylamanızı sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONAPPROVE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONNAME: string, required Max length: 256 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONSTATUS: string, required Max length: 4 description Tüm geçerli değerleri görün (24) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. APPLICATIONREJECTMSG: string, optional Max length: 256 description SampleResponse ACTION: APPLICATIONAPPROVE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type" } } Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Tekrarlı Ödeme Planı Aksiyonları Tekrarlı Ödeme Planı Ekleme RECURRINGPLAN aksiyonu, belli bir tutar için ayrı ayrı ayarlanmış zamanlarda planlanmış ödemeler grubuna dair olan aksiyonları içerir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTANTPAYMENT: string, optional Max length: 3 Default value: 'NO' description Tüm geçerli değerleri görün (2) MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMEREMAIL: string, required Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. FIRSTAMOUNT: decimal, optional Max length: 30 İlk tekrarlı ödeme tutarı. RECURRINGAMOUNT: decimal, required Max length: 30 Tekrarlı ödeme tutarları. RECURRENCECOUNT: decimal, required Max length: 2 Default value: '1' Tekrarlı ödeme planındaki tekrar sayısı. FREQUENCY: string, required Max length: 4 Tekrarlı ödeme sıklığı. Gün için D, ay için M, yıl için Y kullanılmalıdır. (Örn.: 5D, 3M, 1Y). STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. ORDERITEMS: string, optional Max length: 100000 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. TOTALSELLERCOMMISSIONAMOUNT: decimal, optional Max length: 30 description TOTALSELLERPAYMENTAMOUNT: decimal, optional Max length: 30 description RECURRINGPLAN için İstek Örneği ACTION: RECURRINGPLANADD INSTANTPAYMENT: YES MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CUSTOMER: merchant-2yQZyloV CUSTOMERNAME: CustomerName 2yQZyloV CUSTOMEREMAIL: 2yQZyloV@email.com CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User RECURRINGPLANCODE: Code-JSjAuDXf FIRSTAMOUNT: 1.00 RECURRINGAMOUNT: 100.00 RECURRENCECOUNT: 5 FREQUENCY: 5D CURRENCY: TRY STARTDATE: 01-10-2015 PAYMENTSYSTEM: GarantiPOS RECURRINGPLAN için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "recurringPlanCode" : "Code-JSjAuDXf" } Tekrarlı Ödeme Planı Güncelleme Tekrarlı Ödeme Planı Güncelleme RECURRINGPLANEDIT isteği bir tekrarlı ödeme planı veya bir tekrarlı ödemenin belirli özelliklerini güncellemek için kullanılır.Bu istek ile tekrarlı ödeme planının,DurumuKart BilgileriTekrarlı ödeme tutarıÖeme sistemive bir tekrarlı ödemenin,DurumuBaşlangıç tarihiTutarıgüncellenebilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. RECURRINGSTATUS: string, optional Max length: 16 Tekrarlı ödeme durum bilgisi. RECURRINGAMOUNT: decimal, optional Max length: 30 Tekrarlı ödeme tutarları. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. RECURRENCE: decimal, optional Max length: 2 Düzenlenecek tekrarlı ödeme. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. RECURRINGPLAN için İstek Örneği ACTION: RECURRINGPLANEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CARDPAN: CARDEXPIRY: NAMEONCARD: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGAMOUNT: 50.00 RECURRINGSTATUS: INACTIVE RECURRENCECOUNT: STARTDATE: AMOUNT: PAYMENTSYSTEM: RECURRINGPLAN için Örnek Cevap { "action" : "RECURRINGPLANEDIT", "responseCode" : "00", "responseMsg" : "Approved" } Tekrarlı Ödeme Kartı Planı Aksiyonları Tekrarlı Ödeme Planı Kartı Ekleme RECURRINGPLANCARDADD action lets you to add card and relate it to recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. RECURRINGPLANCARDADD için İstek Örneği ACTION: RECURRINGPLANCARDADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User CARDSAVENAME: Test Name CARDTOKEN: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGPLANCARDADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6" } Tekrarlı Ödeme Planı Kartı Sil RECURRINGPLANCARDDELETE action lets you to remove relation between card and recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. RECURRINGPLANCARDDELETE için İstek Örneği ACTION: RECURRINGPLANCARDDELETE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: [CARDTOKEN] RECURRINGPLANCODE: [RECURRINGPLANCODE] RECURRINGPLANCARDDELETE için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } e-Cüzdan Aksiyonları Kart Güncelleme EWALLETEDITCARD aksiyonu, mevcut bir kart anahtarı vererek bu kartı düzenleyebilmenizi sağlar. Değiştirilmesine izin verilen tek alanlar kartın son kullanma tarihi ve kaydetme adımıdır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETEDITCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDEXPIRY: string, optional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, optional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. Örnek İstek MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] ACTION: EWALLETEDITCARD CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN CARDSAVENAME: My Card Name (New) CARDEXPIRY: 12.2020 Örnek Cevap { "cardToken":"ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN", "responseCode":"00", "responseMsg":"Approved" } Kart Silme EWALLETDELETECARD aksiyonu ile kayıtlı müşteri kartlarınızı silebilirsiniz. Bir kart sistemden silindikten sonra sorgulanamaz, güncellenemez ya da bununla herhangi bir şekilde ödeme yapılamaz. Kart silmek için, aşağıdaki alanların Paratika’ya gönderilmesi gerekmektedir: İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETDELETECARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: EWALLETDELETECARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN SampleRespons { "responseCode":"00", "responseMsg":"Approved" } Satıcı Aksiyonları Satıcı Ekle The SELLERADD action lets you add a seller. You should give the required parameters also optional parameters like TCKN. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLERADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, required Max length: 512 İsim LASTNAME: string, required Max length: 512 description EMAIL: string, required Max length: 512 description MOBILENUMBER: string, required Max length: 64 description TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLERADD için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [SELLER NAME] LASTNAME: [SELLER LASTNAME] EMAIL: [seller@email.com] MOBILENUMBER: [1234567890] TCKN: [012345678911] SELLERPAYMENTDUEDAY: [2] SELLERADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "WA", "sellerpaymentdueday" : "2", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLEREDIT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLERPAYMENTDUEDAY: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "sellerpaymentdueday" : "2" "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcı Ödeme Tarihi Güncellemesi Satıcı işleminin ödeme tarihini günceller İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: UPDATEPAYMENTDATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. ORDERITEMS: string, required Max length: 4096 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. UPDATESELLERPAYMENTDATE için İstek Örneği ACTION: UPDATEPAYMENTDATE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANID: [21127PnXF19482] SELLER: [ URLEncoded [{"sellerId": "seller-id", "sellerPaymentDate": "25.06.2025"}] ] UPDATESELLERPAYMENTDATE için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved" } Başvuru İşlemleri Başvuru ekle APPLICATIONADD işlemi başvuru eklemenizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, required Max length: 256 description APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONPHONE: string, required Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, required Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: APPLICATIONADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationStatus": "PA", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Düzenle BAŞVURUDÜZENLE seçeneği başvuruyu düzenlemenizi sağlar. Zorunlu parametreler olan isim ve email adresini, ayrıca opsiyonel parametreleri de düzenleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, conditional Max length: 256 description APPLICATIONEMAIL: string, conditional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONPHONE: string, optional Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, optional Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSTATUS: string, optional Max length: 16 description Tüm geçerli değerleri görün (24) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONSIGNAUTHORITIES: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONDOCUMENTDATA: string, optional Max length: 10000000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SALESSUPPORTOPINION: string, optional Max length: 256 description RequestSample ACTION: APPLICATIONEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSTATUS:[APPLICATIONSTATUS] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONDOCUMENTDATA:[APPLICATIONDOCUMENTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationDocumentData": [ { "fileType": "JPEG", "fileContent": "iLe+8q38tU8zEAOSimLdxx8ZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "fileName" } ], "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Sorgulama QUERYAPPLICATION başvuru işlemi sorgulamanizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, optional Max length: 256 description APPLICATIONEMAIL: string, optional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: QUERYAPPLICATION MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "applications": [{ "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB" "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } }] } Başvuru onayla APPLICATIONAPPROVE işlemi başvuru onaylamanızı sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONAPPROVE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONNAME: string, required Max length: 256 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONSTATUS: string, required Max length: 4 description Tüm geçerli değerleri görün (24) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. APPLICATIONREJECTMSG: string, optional Max length: 256 description SampleResponse ACTION: APPLICATIONAPPROVE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type" } } Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Tekrarlı Ödeme Kartı Planı Aksiyonları Tekrarlı Ödeme Planı Kartı Ekleme RECURRINGPLANCARDADD action lets you to add card and relate it to recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. RECURRINGPLANCARDADD için İstek Örneği ACTION: RECURRINGPLANCARDADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 4242420000004242 CARDEXPIRY: 12.2020 NAMEONCARD: Test User CARDSAVENAME: Test Name CARDTOKEN: RECURRINGPLANCODE: Code-JSjAuDXf RECURRINGPLANCARDADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6" } Tekrarlı Ödeme Planı Kartı Sil RECURRINGPLANCARDDELETE action lets you to remove relation between card and recurring plan. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECURRINGPLANCARDDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. RECURRINGPLANCARDDELETE için İstek Örneği ACTION: RECURRINGPLANCARDDELETE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: [CARDTOKEN] RECURRINGPLANCODE: [RECURRINGPLANCODE] RECURRINGPLANCARDDELETE için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } e-Cüzdan Aksiyonları Kart Güncelleme EWALLETEDITCARD aksiyonu, mevcut bir kart anahtarı vererek bu kartı düzenleyebilmenizi sağlar. Değiştirilmesine izin verilen tek alanlar kartın son kullanma tarihi ve kaydetme adımıdır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETEDITCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDEXPIRY: string, optional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, optional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. Örnek İstek MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] ACTION: EWALLETEDITCARD CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN CARDSAVENAME: My Card Name (New) CARDEXPIRY: 12.2020 Örnek Cevap { "cardToken":"ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN", "responseCode":"00", "responseMsg":"Approved" } Kart Silme EWALLETDELETECARD aksiyonu ile kayıtlı müşteri kartlarınızı silebilirsiniz. Bir kart sistemden silindikten sonra sorgulanamaz, güncellenemez ya da bununla herhangi bir şekilde ödeme yapılamaz. Kart silmek için, aşağıdaki alanların Paratika’ya gönderilmesi gerekmektedir: İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETDELETECARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: EWALLETDELETECARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN SampleRespons { "responseCode":"00", "responseMsg":"Approved" } Satıcı Aksiyonları Satıcı Ekle The SELLERADD action lets you add a seller. You should give the required parameters also optional parameters like TCKN. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLERADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, required Max length: 512 İsim LASTNAME: string, required Max length: 512 description EMAIL: string, required Max length: 512 description MOBILENUMBER: string, required Max length: 64 description TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLERADD için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [SELLER NAME] LASTNAME: [SELLER LASTNAME] EMAIL: [seller@email.com] MOBILENUMBER: [1234567890] TCKN: [012345678911] SELLERPAYMENTDUEDAY: [2] SELLERADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "WA", "sellerpaymentdueday" : "2", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLEREDIT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLERPAYMENTDUEDAY: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "sellerpaymentdueday" : "2" "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcı Ödeme Tarihi Güncellemesi Satıcı işleminin ödeme tarihini günceller İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: UPDATEPAYMENTDATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. ORDERITEMS: string, required Max length: 4096 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. UPDATESELLERPAYMENTDATE için İstek Örneği ACTION: UPDATEPAYMENTDATE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANID: [21127PnXF19482] SELLER: [ URLEncoded [{"sellerId": "seller-id", "sellerPaymentDate": "25.06.2025"}] ] UPDATESELLERPAYMENTDATE için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved" } Başvuru İşlemleri Başvuru ekle APPLICATIONADD işlemi başvuru eklemenizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, required Max length: 256 description APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONPHONE: string, required Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, required Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: APPLICATIONADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationStatus": "PA", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Düzenle BAŞVURUDÜZENLE seçeneği başvuruyu düzenlemenizi sağlar. Zorunlu parametreler olan isim ve email adresini, ayrıca opsiyonel parametreleri de düzenleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, conditional Max length: 256 description APPLICATIONEMAIL: string, conditional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONPHONE: string, optional Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, optional Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSTATUS: string, optional Max length: 16 description Tüm geçerli değerleri görün (24) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONSIGNAUTHORITIES: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONDOCUMENTDATA: string, optional Max length: 10000000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SALESSUPPORTOPINION: string, optional Max length: 256 description RequestSample ACTION: APPLICATIONEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSTATUS:[APPLICATIONSTATUS] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONDOCUMENTDATA:[APPLICATIONDOCUMENTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationDocumentData": [ { "fileType": "JPEG", "fileContent": "iLe+8q38tU8zEAOSimLdxx8ZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "fileName" } ], "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Sorgulama QUERYAPPLICATION başvuru işlemi sorgulamanizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, optional Max length: 256 description APPLICATIONEMAIL: string, optional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: QUERYAPPLICATION MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "applications": [{ "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB" "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } }] } Başvuru onayla APPLICATIONAPPROVE işlemi başvuru onaylamanızı sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONAPPROVE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONNAME: string, required Max length: 256 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONSTATUS: string, required Max length: 4 description Tüm geçerli değerleri görün (24) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. APPLICATIONREJECTMSG: string, optional Max length: 256 description SampleResponse ACTION: APPLICATIONAPPROVE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type" } } Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
e-Cüzdan Aksiyonları Kart Güncelleme EWALLETEDITCARD aksiyonu, mevcut bir kart anahtarı vererek bu kartı düzenleyebilmenizi sağlar. Değiştirilmesine izin verilen tek alanlar kartın son kullanma tarihi ve kaydetme adımıdır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETEDITCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDEXPIRY: string, optional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, optional Max length: 64 Kart üzerinde yazan isim. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. Örnek İstek MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] ACTION: EWALLETEDITCARD CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN CARDSAVENAME: My Card Name (New) CARDEXPIRY: 12.2020 Örnek Cevap { "cardToken":"ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN", "responseCode":"00", "responseMsg":"Approved" } Kart Silme EWALLETDELETECARD aksiyonu ile kayıtlı müşteri kartlarınızı silebilirsiniz. Bir kart sistemden silindikten sonra sorgulanamaz, güncellenemez ya da bununla herhangi bir şekilde ödeme yapılamaz. Kart silmek için, aşağıdaki alanların Paratika’ya gönderilmesi gerekmektedir: İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EWALLETDELETECARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, required Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: EWALLETDELETECARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDTOKEN: ZP7BJ24P5HTA4EKKHMOAEAPWJWSWKMCKQ54EWK37IBAEUPPN SampleRespons { "responseCode":"00", "responseMsg":"Approved" }
Satıcı Aksiyonları Satıcı Ekle The SELLERADD action lets you add a seller. You should give the required parameters also optional parameters like TCKN. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLERADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, required Max length: 512 İsim LASTNAME: string, required Max length: 512 description EMAIL: string, required Max length: 512 description MOBILENUMBER: string, required Max length: 64 description TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLERADD için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [SELLER NAME] LASTNAME: [SELLER LASTNAME] EMAIL: [seller@email.com] MOBILENUMBER: [1234567890] TCKN: [012345678911] SELLERPAYMENTDUEDAY: [2] SELLERADD için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "WA", "sellerpaymentdueday" : "2", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLEREDIT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLERPAYMENTDUEDAY: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "sellerpaymentdueday" : "2" "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Satıcı Ödeme Tarihi Güncellemesi Satıcı işleminin ödeme tarihini günceller İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: UPDATEPAYMENTDATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. ORDERITEMS: string, required Max length: 4096 Sipariş bilgileri JSON formatinda bir diziden oluşmaktadır. Gönderilecek verinin URL Encoded olarak kodlandığından emin olunuz. Geçerli format tanımları için lütfen sağ tarafta bulunan istek örneklerindeki kullanımları inceleyiniz. UPDATESELLERPAYMENTDATE için İstek Örneği ACTION: UPDATEPAYMENTDATE MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] MERCHANTPAYMENTID: [MERCHANTPAYMENTID] PGTRANID: [21127PnXF19482] SELLER: [ URLEncoded [{"sellerId": "seller-id", "sellerPaymentDate": "25.06.2025"}] ] UPDATESELLERPAYMENTDATE için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved" } Başvuru İşlemleri Başvuru ekle APPLICATIONADD işlemi başvuru eklemenizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, required Max length: 256 description APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONPHONE: string, required Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, required Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: APPLICATIONADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationStatus": "PA", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Düzenle BAŞVURUDÜZENLE seçeneği başvuruyu düzenlemenizi sağlar. Zorunlu parametreler olan isim ve email adresini, ayrıca opsiyonel parametreleri de düzenleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, conditional Max length: 256 description APPLICATIONEMAIL: string, conditional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONPHONE: string, optional Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, optional Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSTATUS: string, optional Max length: 16 description Tüm geçerli değerleri görün (24) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONSIGNAUTHORITIES: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONDOCUMENTDATA: string, optional Max length: 10000000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SALESSUPPORTOPINION: string, optional Max length: 256 description RequestSample ACTION: APPLICATIONEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSTATUS:[APPLICATIONSTATUS] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONDOCUMENTDATA:[APPLICATIONDOCUMENTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationDocumentData": [ { "fileType": "JPEG", "fileContent": "iLe+8q38tU8zEAOSimLdxx8ZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "fileName" } ], "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Sorgulama QUERYAPPLICATION başvuru işlemi sorgulamanizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, optional Max length: 256 description APPLICATIONEMAIL: string, optional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: QUERYAPPLICATION MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "applications": [{ "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB" "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } }] } Başvuru onayla APPLICATIONAPPROVE işlemi başvuru onaylamanızı sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONAPPROVE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONNAME: string, required Max length: 256 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONSTATUS: string, required Max length: 4 description Tüm geçerli değerleri görün (24) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. APPLICATIONREJECTMSG: string, optional Max length: 256 description SampleResponse ACTION: APPLICATIONAPPROVE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type" } } Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Başvuru İşlemleri Başvuru ekle APPLICATIONADD işlemi başvuru eklemenizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, required Max length: 256 description APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONPHONE: string, required Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, required Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: APPLICATIONADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationStatus": "PA", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Düzenle BAŞVURUDÜZENLE seçeneği başvuruyu düzenlemenizi sağlar. Zorunlu parametreler olan isim ve email adresini, ayrıca opsiyonel parametreleri de düzenleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, conditional Max length: 256 description APPLICATIONEMAIL: string, conditional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONPHONE: string, optional Max length: 64 description APPLICATIONWEBADDRESS: string, optional Max length: 256 description APPLICATIONTURNOVER: string, optional Max length: 256 description APPLICATIONCOMPANYTYPE: string, optional Max length: 16 description Tüm geçerli değerleri görün (4) APPLICATIONSTATUS: string, optional Max length: 16 description Tüm geçerli değerleri görün (24) APPLICATIONSHAREHOLDERS: string, optional Max length: 100000 description APPLICATIONSIGNAUTHORITIES: string, optional Max length: 100000 description APPLICATIONMERCHANT: string, optional Max length: 100000 description APPLICATIONDOCUMENTDATA: string, optional Max length: 10000000 description APPLICATIONFINANCIALDATA: string, optional Max length: 100000 description APPLICATIONSALESUPPORTDATA: string, optional Max length: 100000 description APPLICATIONRISKMANAGEMENTDATA: string, optional Max length: 100000 description SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. SALESSUPPORTOPINION: string, optional Max length: 256 description RequestSample ACTION: APPLICATIONEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONNAME: [APPLICATIONNAME] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] APPLICATIONWEBADDRESS: [APPLICATIONWEBADDRESS] APPLICATIONTURNOVER: [APPLICATIONTURNOVER] APPLICATIONCOMPANYTYPE: [APPLICATIONCOMPANYTYPE] APPLICATIONSTATUS:[APPLICATIONSTATUS] APPLICATIONSHAREHOLDERS:[APPLICATIONSHAREHOLDERS] APPLICATIONMERCHANT:[APPLICATIONMERCHANT] APPLICATIONSALESUPPORTDATA:[APPLICATIONSALESUPPORTDATA] APPLICATIONDOCUMENTDATA:[APPLICATIONDOCUMENTDATA] APPLICATIONRISKMANAGEMENTDATA:[APPLICATIONRISKMANAGEMENTDATA] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationDate": "2022-04-01 08:23:28.211", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB", "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationDocumentData": [ { "fileType": "JPEG", "fileContent": "iLe+8q38tU8zEAOSimLdxx8ZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "fileName" } ], "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } } } Başvuru Sorgulama QUERYAPPLICATION başvuru işlemi sorgulamanizi sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONNAME: string, optional Max length: 256 description APPLICATIONEMAIL: string, optional Max length: 64 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION: QUERYAPPLICATION MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "applications": [{ "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type", "applicationCode": "UKKYXGJNUFEJIHSBUS4MR3S3G2ODAE7QY53LLCMEZ7H7SJSB" "applicationShareholders":[ { "name": "002", "surname": "002", "phone": "+38345698325", "email": "002@gmail.com", "idNumber": "002", "signAuthority": "YES", "signAuthorityDuration": "01-02-2026 01:00" }, { "name": "001", "surname": "001", "phone": "+38345698325", "email": "001@gmail.com", "idNumber": "001", "signAuthority": "NO", "signAuthorityDuration": "01-02-2026 01:00" } ], "applicationMerchant": [ { "commercialTitle": "123", "name": "123", "surname": "123", "email": "123@email.com", "phoneNumber": "+38345698325", "landPhone": "+3834569832", "address": "123", "eCommerce": "123" } ], "applicationFinancialData": { "merchantCommissionSchema": "MCS_ZERO_COMMISSION", "paymentSystemPool": "testPaymentSystemPool" }, "applicationSaleSupportData": { "ssl": "test_ssl2", "content": "test_content2", "whois": "test_whois", "tradeRegistryNumber": "test_tradeRegistryNumber" }, "applicationRiskManagmentDataVo": { "kkbPoint": "kkbPoint", "mcc": "1352", "threeDCondition": "THD_ALL", "threeDLimit": "0", "complaintRecord": "complaintRecord", "product": "DON", "contractSigned": "YES", "blockageTimeAndDay": "", "integrationModel": "API", "guaranteeAmount": "50.5", "guaranteeAmountStartDate": "01-02-2026 01:00", "guaranteeAmountEndDate": "01-02-2026 01:00", "foreignCardPermission": "YES" } }] } Başvuru onayla APPLICATIONAPPROVE işlemi başvuru onaylamanızı sağlar. Zorunlu parametreleri girmelisiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: APPLICATIONAPPROVE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONEMAIL: string, required Max length: 64 description APPLICATIONNAME: string, required Max length: 256 description APPLICATIONCODE: string, optional Max length: 64 Başvuru kodu APPLICATIONSTATUS: string, required Max length: 4 description Tüm geçerli değerleri görün (24) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. APPLICATIONREJECTMSG: string, optional Max length: 256 description SampleResponse ACTION: APPLICATIONAPPROVE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONEMAIL: [APPLICATIONEMAIL] APPLICATIONPHONE: [APPLICATIONPHONE] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "application" : { "applicationName" : "Application Name", "applicationEmail" : "Application Email", "applicationPhone" : "Application Phone", "applicationWebAddress" : "www.google.com", "applicationTurnover" : "Application Turnover", "applicationStatus" : "Application status", "applicationCompanyType" : "Application company type" } } Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Currency Actions Para Birimi Değişimi Para Birimi Değişimi İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: CURRENCYEXCHANGE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. FROMCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) TOCURRENCY: string, required Max length: 3 description Tüm geçerli değerleri görün (33) AMOUNT: decimal, optional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. Sample Request For CURRENCYEXCHANGE ACTION: CURRENCYEXCHANGE MERCHANTUSER: apiuser@testmerchant.com MERCHANTPASSWORD: Pluto321` MERCHANT: 10000000 FROMCURRENCY: USD TOCURRENCY: TRY AMOUNT: 10.00 Sample Response For CURRENCYEXCHANGE { "fromCurrency": "USD", "toCurrency": "TRY", "amount": "10.00", "convertedAmount": "60.62" } Satıcıyı Güncelle SELLEREDIT işlemi mevcut satıcı kayıtlarını güncellemenizi sağlar. Seller ID ve Üye işyeri ID gerekli parametrelerini sağlayarak isim, soyisim, telefon numarası, e-posta, TCKN ve satıcı durumu alanlarını güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: SELLEREDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SELLERID: string, required Max length: 32 Satıcı başına benzersiz değer. NAME: string, optional Max length: 512 İsim LASTNAME: string, optional Max length: 512 description EMAIL: string, optional Max length: 512 description MOBILENUMBER: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) TCKN: string, conditional Max length: 11 TCKN / Müşteri Kimlik Numarası. VKN: string, conditional Max length: 10 Vergi Kimlik No IBAN: string, required Max length: 34 description IBANUSD: string, optional Max length: 34 description IBANEUR: string, optional Max length: 34 description IBANGBP: string, optional Max length: 34 description SELLERPAYMENTDAYS: string, required Max length: 32 Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir: Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4). Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4; ACCOUNTOWNERNAME: string, conditional Max length: 512 description ACCOUNTOWNERLASTNAME: string, conditional Max length: 512 description SELLERPAYMENTDUEDAY: integer, optional Max length: 2 description COMMERCIALTITLE: string, conditional Max length: 512 description COMMISSIONAPPLYTYPE: string, conditional Max length: 3 COMMISSIONAPPLYTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONAPPLIERTYPE: string, conditional Max length: 3 COMMISSIONAPPLIERTYPE sadece CA parametresini desteklemektedir. Diğer parametreler geçerli değil. Tüm geçerli değerleri görün (3) COMMISSIONVALUE: decimal, optional Max length: 30 description ONBEHALFOFMERCHANT: string, optional Max length: 16 description SELLERURL: string, optional Max length: 256 description ISDEFAULT: string, optional Max length: 3 Default value: 'NO' description SELLEREDIT için İstek Örneği ACTION: SELLERADD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: [SELLER ID] NAME: [] LASTNAME: [] EMAIL: [] MOBILENUMBER: [] TCKN: [] STATUS: [] SELLEREDIT için Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "seller" : { "sellerId" : "Seller-vd6ShJUF", "name" : "Seller01", "lastName" : "LastName-XKGo", "email" : "seler01@email.com", "mobileNumber" : "+900408866157", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "MSU Test Merchant", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" } } } Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" } OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Müşteri Komisyon Aksiyonları Müşteri Komisyonu Güncelleme EDITCUSTOMERCOMMISSION isteği müşteri maliyet yansıtma şablonunu düzenlemek için kullanılır. "CURRENCYCOMMISSIONS" nesnesinde, CommissionKey alanında hangi taksitin güncellendiğini aşağıdaki örnek formatla belirtmeniz gerekir: 2 Taksit olarak "CR2" veya 4 Taksit olarak "CR4" veya "ON_NETWORK_DEBIT" vb. değerleri aşağıdaki şekilde belirleyebilirsiniz: "commissionKey":"ON_NETWORK_DEBIT" veya "commissionKey":"CR4" "commissionValue" bölümünde, o taksit için değeri belirlersiniz. Ödeme Sistemleri için değer eklemek istiyorsanız "paymentSystemCurrencyCommissions" ve "paymentSystemId" parametrelerini doldurmanız gerekir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: EDITCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCYCOMMISSIONS: string, required Max length: 200000 description ACTIVATIONDATE: date, required Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi Örnek İstek ACTION:EDITCUSTOMERCOMMISSION MERCHANT:10000000 MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` CURRENCYCOMMISSIONS: [ { "commissionKey":"CR2", "commissionValue":0.1, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"2", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR4", "commissionValue":4.3, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"4", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true }, { "commissionKey":"CR3", "commissionValue":2, "serviceCommissionRate":0, "pointCommissionRate":0, "cutoffCommissionRate":0, "currency":null, "dueDate":null, "paymentSystemCurrencyCommissions":[ { "commissionValue":"1", "paymentSystemId":"00BqGQyD2W0M" } ], "active":true } ] ACTIVATIONDATE:21-06-2024 10:47 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved" }
OTP İşlemleri OTP ekle OTPADD isteği yeni bir OTP (tek seferlik şifre) yaratmak ve eklemek için kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } } Edit OTP OTPEDIT request can be used to generate and edit OTP (One time password) İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OTPEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description OTPSTATUS: string, required Max length: 2 description Tüm geçerli değerleri görün (4) EMAIL: string, required Max length: 64 description RequestSample ACTION: OTPEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] EMAIL: [EMAIL] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otp": { "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } }
Bin Rule İşlemleri Bin Kuralı ekle BINRULEADD isteği, yeni bir Bin Kuralı oluşturmak ve eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEADD MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } BIN Kuralı Sorgulama QUERYBINRULE QUERY BIN Kuralı sistem üzerindeki tüm bin kurallarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, optional Max length: 128 Bin Kuralı RequestSample ACTION: QUERYBINRULE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRules": [ { "ruleName": "TESTDEMO19", "cardBrand": "VISA", "cardType": "CREDIT", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": MULTIPLESHOT, "installmentCount": 3 } "status": "OK" }, { "ruleName": "RuleForTest", "cardBrand": "MC", "countryIsoA3": "TUR", "issuer": "test11", "cardNetwork": "WORLD", "lowerLimit": 2.5, "upperLimit": 3.7, "status": "OK", "installmentType": ONESHOT, "installmentCount": 1 } ] } Bin Kuralı sil BINRULEDELETE isteği, mevcut bir Bin Kuralını silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı RequestSample ACTION: BINRULEDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Bin Kuralı düzenle BINRULEEDIT isteği, mevcut bir Bin Kuralını düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEEDIT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı CARDBRAND: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) CARDTYPE: string, conditional Max length: 8 description Tüm geçerli değerleri görün (6) CARDNETWORK: string, conditional Max length: 8 description Tüm geçerli değerleri görün (9) ISSUER: string, conditional Max length: 128 description COUNTRYISOA3: string, conditional Max length: 3 description LOWERLIMIT: decimal, optional Max length: 22 description UPPERLIMIT: decimal, optional Max length: 22 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) INSTALLMENTTYPE: string, optional Max length: 64 description Tüm geçerli değerleri görün (2) INSTALLMENTCOUNT: integer, conditional Max length: 2 description FOREIGN: string, optional Max length: 3 Yabancı seçilirse ülke belirtmeye gerek yoktur. Tüm geçerli değerleri görün (2) UNDEFINEDBIN: string, optional Max length: 3 Tanımlamayan Bin Tüm geçerli değerleri görün (2) RequestSample ACTION: BINRULEEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] STATUS: [STATUS] CARDBRAND: [CARDBRAND] CARDTYPE: [CARDTYPE] CARDNETWORK: [CARDNETWORK] COUNTRYISOA3: [COUNTRYISOA3] ISSUER: [ISSUER] LOWERLIMIT: [LOWERLIMIT] UPPERLIMIT: [UPPERLIMIT] INSTALLMENTTYPE: [INSTALLMENTTYPE] INSTALLMENTCOUNT: [INSTALLMENTCOUNT] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST12", "cardBrand": "VISA", "cardType": "DEBIT", "countryIsoA3": "ALB", "issuer": "test12", "cardNetwork": "WORLD", "lowerLimit": 2.7, "upperLimit": 3.9, "status": "OK", "installmentType": "MULTIPLESHOT", "installmentCount": "4" } } Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } } Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" } api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" } Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] } Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } } Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] } Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
Bin Rule, Ödeme Sistemi Havuzu İlişkisi İşlemleri Bin Kuralı, Ödeme Sistemi Havuzu İlişkisi ekle BINRULEPSPASSOCADD isteği, yeni bir Bin Kuralı, Ödeme sistemi ilişkisi eklemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } Bin Kuralı, Ödeme Sistemi İlişkisi düzenle BINRULEPSPASSOCEDIT isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisini düzenlemek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCADD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RULENAME: string, required Max length: 128 Bin Kuralı PAYMENTSYSTEMPOOLNAME: string, required Max length: 255 Ödeme sistemi havuzu PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. STATUS: string, required Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) RequestSample ACTION: BINRULEPSPASSOCEDIT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] STATUS: [STATUS] BINRULEPSPOOLASSOCNAME: [ASSOC-sfdsafa] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "binRule": { "ruleName": "TEST11", "paymentSystemPoolName": "PSPOOL_TEST", "paymentSystem": "Akbank", "status": "OK", } } BIN Kuralı, Ödeme Sistemi İlişkisi Sorgulama QUERYBINRULEPSPASSOC Request can be used to query Bin Rule and Payment System Pool Relations İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBINRULEPSPASSOC, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION: QUERYBINRULEPSPASSOC MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SampleResponse { "responseCode" : "00", "responseMsg" : "Approved", "binRulePSPoolAssoc" : [ { "binRuleName" : "urlChange", "paymentSytemPoolName" : "All Payment System In Pool", "paymentSystem" : "YKB", "status" : "OK", "addedDate" : 1678453875268, "addedBy" : "PF Super Admin", "modifiedBy" : "" }, { "binRuleName" : "testingRule", "paymentSytemPoolName" : "Test Pool", "paymentSystem" : "Finansbank", "status" : "OK", "addedDate" : 1678453725637, "addedBy" : "PF Super Admin", "modifiedBy" : "" } ] } Bin Kuralı, Ödeme Sistemi İlişkisi sil BINRULEPSPASSOCDELETE isteği, mevcut bir Bin Kuralı, Ödeme sistemi ilişkisi silmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: BINRULEPSPASSOCDELETE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BINRULEPSPOOLASSOCNAME: string, required Max length: 128 Association Name, unique and is autogenerated RequestSample ACTION: BINRULEPSPASSOCDELETE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RULENAME: [RULENAME] PAYMENTSYSTEMPOOLNAME: [PAYMENTSYSTEMPOOLNAME] PAYMENTSYSTEM: [PAYMENTSYSTEM] SampleResponse { "responseCode": "00", "responseMsg": "Approved" }
Alışveriş Kredisi Aksiyonları Alışveriş Kredisi İşlemini Başlat STARTONLINESHOPPINGLOAN isteği, alışveriş kredisi işlemini başlatmak, ve işlemin yönleneceği URL bilgisini almak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: STARTONLINESHOPPINGLOAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, conditional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, conditional Max length: 128 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN RequestSample ACTION: STARTONLINESHOPPINGLOAN SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEMTYPE: [PAYMENTSYSTEMTYPE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "redirectURL": "https://odemetest.fibabanka.com.tr?transactionId=7b434063-6893-4c08-8c12-e817a67c68a6" } }
Kuveyt Türk Alışveriş Kredisi İşlem Sonuç Bildirimi KuveytTürk Alışveriş Kredisi işlemi başlatıldıktan sonra, işlem durumu Paratika üzerinde DEVAM EDİYOR olarak işaretlenecektir. KuveytTürk tarafında işlem tamamlandığında (başarısız veya onaylandığında) KuveytTürk bu endpoint üzerinden Paratika uygulamasını bilgilendirecektir. DEV API URL: https://neon-app.local.payten.com.tr/paratika/api/v2 /kuveytturk/loan/handler TEST API URL: https://test.paratika.com.tr/paratika/api/v2/kuveytturk/loan/handler PROD API URL: https://vpos.paratika.com.tr/paratika/api/v2/ kuveytturk/loan/handler İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACQUIRERID: string, required Max length: 50 description ACQUIRERPASSWORD: string, required Max length: 50 description TRANSACTIONID: string, required Max length: 64 description RequestSample { "acquirerId": "ACQUIRERID", "acquirerPassword": "ACQUIRERPASSWORD", "transactionId": "TRANSACTIONID" } SampleResponse //SUCCESFUL { "returnCode": "00", "returnMessage": "Payment notification successful" } //UNSUCCESSFUL { "returnCode": "99", "returnMessage": "Payment state is not as expected or transaction failed" }
api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. VALIDATEUSER api çağrısı, kullanıcıyı doğrulamak için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: VALIDATEUSER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. USEREMAIL: string, required Max length: 128 Kullanıcının sistemde mail ile bulunup bulunmadığını görmek için parametre kullanılacaktır SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. RequestSample ACTION:VALIDATEUSER MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` USEREMAIL:testuser@email.com SampleResponse { "responseCode": "00", "responseMsg": "Approved" }
Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. OPENBANKINGPROVIDERLIST Api çağrısı, enqura tarafından paylaşılan sağlayıcıları görmek için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGPROVIDERLIST, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:OPENBANKINGPROVIDERLIST MERCHANTUSER:apiuser@testmerchant.com MERCHANTPASSWORD:Pluto321` MERCHANT:10000000 SampleResponse { "responseCode": "00", "responseMsg": "Approved", "providerList": [ { "ProviderCode": "2199", "Name": "turkonay", "ShortName": "turkonay", "Status": "A", "LogoInfos": [] } ] }
Açık Bankacılık OPENBANKINGGETREFERENCEINFO Api çağrısı, Enqura dan bir referans bilgisi almak için kullanılır. Bu referans bilgisi, hesap ödeme işlemi içerisinde kullanılacaktır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGGETREFERENCEINFO için İstek Örneği ACTION: OPENBANKINGGETREFERENCEINFO MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGGETREFERENCEINFO için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "ReferenceId": "2pyc091db42a4d28bb9a10187a6f99bn", "ReferenceInfo": { "referenceInfo": ed7c091db42a4d28bb9a10187a6f99a8 } }
Açık Bankacılık OPENBANKINGACCOUNTLIST Api çağrısı, girilen müşteri kimlik numarası ile ilgili hesap bilgileri Enqura dan almak için kullanılır. .glyphicon { color: #337ab7 !important; } ACTION: OPENBANKINGGETREFERENCEINFO, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. IDENTIFIERNUMBER: string, required Max length: 40 Müşteri Kimlik Numarası (TCKN veya VKN değeri girilmelidir). OPENBANKINGACCOUNTLIST için İstek Örneği ACTION: OPENBANKINGACCOUNTLIST MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] IDENTIFIERNUMBER: [TCKN/VKN] OPENBANKINGACCOUNTLIST için Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "Data": [ { "Provider": { "providerCode": "0046", "shortName": "akbank", "logoInfos": [] }, "AccountInfos": [ { "consentReference": "81697131bf514d61826a9ce047fd5354", "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "branchName": "Åube-2", "accountNumber": "TR870219903334551979451527", "shortName": "Hesap-2", "currency": "TRY", "accountHolder": "Nur Bektürk", "balance": { "accountRef": "fee182bd-587f-416d-8949-3b99088a2540", "amount": "195693", "blockedAmount": "120", "currency": "TRY", "transmissionTime": "2024-02-20T10:32:20+03:00" } } ] } ] }
Sorgulama İşlemleri İşlem Sorgulama İşlem Sorgulama aksiyonu belli bir sipariş/ödeme numarası (MerchantPaymentID) bilgisini vererek bu numara altındaki başarılı işlemlerin ya da işlem numarasını (PGTRANID) vererek belli bir işleme ait detayların görüntülenmesini sağlar. Bu detaylar ödemenin durumu, ödeme sistemi/vpos sağlayıcı banka, taksit sayısı ve faiz oranı vs gibi bilgiler olacaktır. Bankaların işlemlere cevap verme süresi azami 90 saniyedir. Üye işyeri olarak bu sürenin altında bir zaman aşımı değeri belirleyecekseniz, işlemin bankadaki durumunu öğrenmek için QUERYTRANSACTION servisini kullanmanız önemlidir.Bankadan işleme geç cevap gelmesi veya gelmemesi durumunda bu servisi entegre etmeniz önemlidir.Bu servis sayesinde işlemin MSU daki durumunu öğrenir ve ERP sistemlerinizi doğru güncelleyebilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. TRANSACTIONSTATUS: string, optional Max length: 18 İslem durum bilgisi. STARTDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERPHONE: string, optional Max length: 64 Müşteri telefon ya da cep telefonu numarası. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PGTRANID: 18285OQZD14766 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "pgTranTraceAudit" : "828514893296", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-PaymentId-mQ15HqoF7d8f", "pgTranApprCode" : "294906", "pgTranId" : "18285OQZD14766", "pgTranRefId" : "828514893296", "timePsSent" : "2018-10-12 14:16:26.815", "timePsReceived" : "2018-10-12 14:16:27.967", "timeCreated" : "2018-10-12 14:16:26.474", "amount" : 80, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "My Finans Webpos Online Account (Test)", "panLast4" : "4026", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** G***", "customerId" : "Customer-GUZUbLrQ", "bin" : "402277", "sellers" : [ { "sellerId" : "tigran", "commissionAmount" : 10 }, { "sellerId" : "benjamin", "commissionAmount" : 10 }, { "sellerId" : "aurela", "commissionAmount" : 20 }, { "sellerId" : "alfred", "commissionAmount" : 4.5 }, { "sellerId" : "john", "commissionAmount" : 10 }, { "sellerId" : "alketa", "commissionAmount" : 5.5 }, { "sellerId" : "nora", "commissionAmount" : 10 }, { "sellerId" : "kate", "commissionAmount" : 10 } ] } ] } Taksit Sorgulama QUERYINSTALLMENT isteği alındığında sistemde tanımlı ve kart sahibinin kullanımına açık olan taksit seçeneklerin bilgisi dönülmektedir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, optional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) Örnek İstek ACTION: QUERYINSTALLMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "paymentSystemEftCode" : "0111", "paymentSystemNetwork" : "CARD_FNS", "paymentSystemList" : [ { "name" : "My Finans Webpos Online Account (Test)", "paymentSystem" : 1, "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 2, "paymentSystemEftCode" : "0046", "paymentSystemNetwork" : "AXESS", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "My Halkbank Sanalpos Account (Test)", "paymentSystem" : 3, "paymentSystemEftCode" : "0012", "paymentSystemNetwork" : "PARAF", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] }, { "name" : "ISBANK TEST", "paymentSystem" : 4, "paymentSystemEftCode" : "0064", "paymentSystemNetwork" : "MAXIMUM", "installmentList" : [ { "count" : "NOT_ON_US", "customerCostCommissionRate" : 0 }, { "count" : "4", "customerCostCommissionRate" : 0 }, { "count" : "5", "customerCostCommissionRate" : 0 }, { "count" : "6", "customerCostCommissionRate" : 0 }, { "count" : "7", "customerCostCommissionRate" : 0 }, { "count" : "8", "customerCostCommissionRate" : 0 } ] } ] } Kart Sorgulama QUERYCARD aksiyonu kullanılarak belli bir müşteri (kart sahibi) için kaydedilmiş olan kart token değerleri ya da belli bir token’a ait kart detayları bilgileri alınabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, optional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDSAVENAME: string, optional Max length: 64 Kaydı yapılacak kart için verilen isim. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. OFFSET: integer, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: integer, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. Örnek İstek ACTION: QUERYCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken":"YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner":"NAME SURNAME", "panLast4":"0520", "customer":"merchant20140920", "cardBin":"540667", "cardbrand":"MC", "cardType":"CREDIT", "cardLevel":"CLASSIC", "cardNetwork":"MAXIMUM", "cardIssuer":"T. IS BANKASI A.S.", "cardVirtual":"NO", "cardCountryIso":"TUR", "cardPaymentSystem":"ISBANK TEST", "cardExpiry":"01.2023", "cardName":"ISBANKASI", "pan":"540667***0520" }] } Kart Vade Sorgulama QUERYCARDEXPIRY aksiyonu içinde bulunulan ay ve gelecek ay içerisinde geçerliliği dolacak olan kartların sorgulanmada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCARDEXPIRY, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. CUSTOMER: string, required Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. OFFSET: string, optional Max length: 4 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYCARDEXPIRY MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CUSTOMER: merchant20140920 Örnek Cevap { "responseCode":"00", "responseMsg":"Approved", "cardCount":"1", "totalCardCount":"1", "cardList":[{ "cardToken" : "YGQHGWH4L3V3T6M2W6HHZ6FGJCZ5EKI5SBFGHHZORD55P6YV", "cardOwner" : "NAME SURNAME", "panLast4" : "0520", "customer" : "merchant20140920", "cardBin" : "540667", "cardExpiry" : "04.2015", "pan" : "540667***0520" }] } Oturum Sorgulama QUERYSESSION aksiyonu geçerli bir oturumun bilgilerinin sorgulamada kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSESSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYSESSION SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "session" : { "token" : "EMEVAXFGO7G4UWRTJD3R5QJ5ZOQJLY4YWLAOQJRKE7A2Z36L", "apiAction" : "SESSIONTOKEN", "merchantPaymentId" : "PaymentId-bl94pcHQ1mpO", "firstAmount" : 18.63, "amount" : 18.63, "currency" : "TRY", "returnUrl" : "https://neon-app.local.payten.com.tr/paratika.merchant/index.jsp", "language" : "tr", "redirectWaitingTime" : 0, "itemTotalAmount" : 18.63, "shippingContact" : { "address" : "Road", "city" : "Ankara", "country" : "Turkey", "postalCode" : "1105", "phone" : "987654321" }, "billingContact" : { "address" : "Road", "city" : "Istanbul", "country" : "Turkey", "postalCode" : "1103", "phone" : "123456789" }, "fastShipping" : false, "extra" : "{\"IframeDomainUrl\":\"https://www.google.com/\"}", "allowedUrl" : "https://www.google.com/" }, "merchant" : { "businessId" : "***", "name" : "MSU Test Merchant", "tradingName" : "Trading name", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "fax" : "+902123650555", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco SEE", "secretKey" : "***", "paymentPolicy" : "THD_ALL", "domains" : "www.domain.com,https://www.google.com/,alketa.com", "preInformationText" : "NA", "remoteSalesAgreement" : "NA", "useHpp" : true, "integrationModel" : "API" }, "customer" : { "id" : "Customer-CVnUJCST", "email" : "CVnUJCST@email.com", "phone" : "+906613328056", "name" : "Name CVnUJCST", "birthday" : "2001-01-01", "lastLogin" : "16.10.2017 14:24" }, "orderItems" : [ { "code" : "u91f4", "name" : "seat belt", "description" : "seat belt description ...", "amount" : 9.01, "quantity" : 1 }, { "code" : "1rnxq8", "name" : "lace", "description" : "lace description ...", "amount" : 3.39, "quantity" : 1 }, { "code" : "bdvhiv", "name" : "television", "description" : "television description ...", "amount" : 4.5, "quantity" : 1 }, { "code" : "5cwai", "name" : "mp3 player", "description" : "mp3 player description ...", "amount" : 1.6, "quantity" : 1 }, { "code" : "vhlt5d", "name" : "bookmark", "description" : "bookmark description ...", "amount" : 0.13, "quantity" : 1 } ] } BIN Sorgulama QUERYBIN Talep BIN bilgi almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYBIN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYBIN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "450803", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "BUSINESS", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType": "ISBANK", "is6Digit": "YES", "is8Digit": "NO" } } Ödeme sistemlerini Sorgulama Ödeme sistemlerini Sorgulama QUERYPAYMENTSYSTEMS Talep tüm ödeme sistemlerini almak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. Örnek İstek ACTION: QUERYPAYMENTSYSTEMS MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "installmentPaymentSystem" : { "name" : "ISBANK TEST", "paymentSystem" : 1, "paymentSystemEftCode": "0064", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0.5 }, { "count" : "3", "customerCostCommissionRate" : 0.5 }, { "count" : "4", "customerCostCommissionRate" : 0.5 }, { "count" : "5", "customerCostCommissionRate" : 0.5 }, { "count" : "6", "customerCostCommissionRate" : 0.5 } ] }, "oneShotPaymentSystem" : { "name" : "My Sanalakpos Account (Test)", "paymentSystem" : 1, "paymentSystemEftCode" : "0046", "installmentList" : [ { "count" : "1", "customerCostCommissionRate" : 0.3 } ] } } Query Pay By Link Payment Query Pay By Link Payment İstek, istek filtrelerine göre tek tıkla ödemelerini döndürür. Yanıttaki tarih özellikleri satıcının zaman diliminde döndürülür ve ISO_8601 olarak biçimlendirilir Request parameters .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYBYLINKPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. PAYBYLINKTOKEN: string, conditional Max length: 48 description MERCHANTNOTE: string, optional Max length: 50 Üye işyerinin ödemeye ilişkin notu varsa bu parametreye yazılır. STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. PAYBYLINKSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) Sample request ACTION: QUERYPAYBYLINKPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYBYLINKTOKEN: [TF7MPD55XU656FPW7ZJOGYVJ2X2AOKMNMDTXHECEQPYGO2RS] PAYBYLINKSTATUS: [] CREATEDTS: [] DUEDATE: [] CUSTOMEREMAIL: [] Sample response { "payByLinkPaymentList":[ { "amount":10, "dueDate":"2016-06-27T21:10:41", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:41", "token":"3LQ74ANRG6RSAA32KYFELZX2VKPD22SN7KPWHYOOWQSXGBLE", "status":"SD" }, { "amount":10, "dueDate":"2016-06-27T15:00:42", "currency":"TRY", "cardHolderEmail":"testcustomer@email.com", "createdTs":"2016-06-20T14:46:42", "token":"HKLON7HKRJGEZGHOY3WE3GHLIY7TG4ZRGIGU4XFETJLJSRWV", "status":"SD" } ], "responseCode":"00", "responseMsg":"Approved" } PAN Sorgulama QUERYPAN aksiyonu belli bir kart pan bilgisi verilerek BIN bilginin sorgulanmasında kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDPAN: string, required Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. Örnek İstek ACTION: QUERYPAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] CARDPAN: 5406670000000009 Sample response { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Örnek İstek ACTION: QUERYPAN SESSIONTOKEN: [SESSIONTOKEN] CARDPAN: 5406670000000009 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "bin" : { "bin" : "540667", "cardBrand" : "MC", "cardType" : "CREDIT", "cardLevel" : "CLASSIC", "cardNetwork" : "MAXIMUM", "issuer" : "T. IS BANKASI A.S.", "virtual" : "NO", "countryIsoA3" : "TUR" } } Üye İş Yeri İçerik Sorgulama QUERYMERCHANTCONTENT aksiyonu, üye iş yerinin sattığı ürünler için verilmiş olan ID bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCONTENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYMERCHANTCONTENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTCONTENTID: 00AXVTSiHX99Z Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "merchantContentList" : [ { "merchantContentType" : "tac", "language" : "tr", "merchant" : "009testID001", "displayed" : "true", "content" : "test" } ] } Puan Sorgulama QUERYPOINTS aksiyonu belli bir kart için mevcut olan puanların banka sisteminden sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPOINTS, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYPOINTS MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: session-vMMSSxDCxL9o MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.25 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 4355084355084358 PAYMENTSYSTEM: GarantiPOS Akbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 15.25, "currency" : "TRY", "apiMerchantId" : "100100000", "paymentSystem" : "My Sanalakpos Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-vMMSSxDCxL9o", "pgTranId" : "15182NCJB01021266", "pgTranRefId" : "", "pgOrderId" : "session-vMMSSxDCxL9o", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PCBCHIPPARABAKIYE", "value" : "000000009856" }, { "name" : "CCBCHIPPARABAKIYE", "value" : "000000083118" }, { "name" : "XCBCHIPPARABAKIYE", "value" : "000000029196" }, { "name" : "CCBCHIPPARAACIKLAMA", "value" : "ccb chip para aciklama" }, { "name" : "PCBCHIPPARAACIKLAMA", "value" : "pcb chip para aciklama" }, { "name" : "XCBCHIPPARAACIKLAMA", "value" : "xcb chip para aciklama" }, { "name" : "ERRORCODE", "value" : "" } ] } İş Bankası için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 12.58, "currency" : "TRY", "apiMerchantId" : "700100000", "paymentSystem" : "My İşbank VPOS Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-nmR4PEmEihOO", "pgTranId" : "15182PonE07021429", "pgTranRefId" : "", "pgOrderId" : "session-nmR4PEmEihOO", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "HOSTMSG", "value" : "TOPLAMMAXIPUAN: 50.00 TL" }, { "name" : "HOSTDATE", "value" : "0701-154039" }, { "name" : "MAXIPUAN", "value" : "50.00" }, { "name" : "ERRORCODE", "value" : "" } ] } Finanbank için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.31, "currency" : "TRY", "apiMerchantId" : "600100000", "paymentSystem" : "My Finans Webpos Online Account (Test)", "pgTranDate" : "", "merchantPaymentId" : "session-GHmNvtjCKMos", "pgTranId" : "15182PrjH00128947", "pgTranRefId" : "", "pgOrderId" : "session-GHmNvtjCKMos", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "NUMCODE", "value" : "00" }, { "name" : "PARAPUANTRL", "value" : "000000002631" }, { "name" : "SEYAHATAVANSPUANTRL", "value" : "" }, { "name" : "SEYAHATAVANSPUANVADETARIHI", "value" : "" }, { "name" : "PARAPUAN", "value" : "000000002631" }, { "name" : "CAVVRESULTCODE", "value" : "3" }, { "name" : "ERRORCODE", "value" : "" } ] } Sample response for VakifBank { "action" : "QUERYPOINTS", "merchant" : "testmerchant", "amount" : 17.27, "currency" : "TRY", "apiMerchantId" : "000100000012656", "paymentSystem" : "Vakifbank", "paymentSystemType" : "VAKIFBANK", "paymentSystemEftCode" : "0015", "merchantPaymentId" : "PaymentId-YwOuiloCfCHK", "pgTranId" : "bf2a7eef537a4e1bad0ca5be00f07519", "pgTranRefId" : "000075283460", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "PUAN", "value" : "283567.72" } ] } HSBC için Örnek Cevap { "action" : "QUERYPOINTS", "merchant" : "10000000", "amount" : 11.22, "currency" : "TRY", "apiMerchantId" : "9916570", "paymentSystem" : "HSBC", "paymentSystemType" : "HSBC", "paymentSystemEftCode" : "0123", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-7Yx5s2QSMRvP", "pgTranId" : "", "pgTranRefId" : "", "pgOrderId" : "", "responseCode" : "00", "responseMsg" : "Approved", "points" : [ { "name" : "ODUL", "value" : "5612.47" } ] } Tekrarlı Ödeme Planı Sorgulama QUERYRECURRINGPLAN aksiyonu tekrarlı ödeme planı kodu veya belli bir başlangıç/bitiş tarih aralığı verilerek tekrarlı ödeme plan(ların)ın detaylarının sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLAN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, optional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, optional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. STARTDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 16 Format: [dd-MM-yyyy] İşlem sorgulama tarih aralığı için bitiş değeridir. RECURRINGPLANCODE: string, conditional Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. CARDPAN: string, optional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CUSTOMER: string, optional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. Örnek İstek ACTION: QUERYRECURRINGPLAN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: Code-JSjAuDXf Sample response { "action" : "QUERYRECURRINGPLAN", "responseCode" : "00", "responseMsg" : "Approved", "recurringPlan" : { "recurringPlanCode" : "Code-wAasdfMW", "firstAmount" : 0, "recurringAmount" : 100, "startDate" : "01-10-2015 00:00", "scheduledEndDate" : "04-10-2015 00:00", "recurrenceCount" : 2, "completedRecurrence" : 0, "frequency" : "3D", "currency" : "TRY", "paymentSytem" : "My Finans Webpos Online Account", "status" : "ACTIVE" }, "recurringPaymentList" : [ { "startDate" : "01-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 1, "amount" : 100, "tryCount" : 0 }, { "startDate" : "04-10-2015 00:00", "status" : "PENDING", "executionDate" : "", "recurrence" : 2, "amount" : 100, "tryCount" : 0 } ], "merchant" : { "businessId" : "[MERCHANT_BUSINESS_ID]", "name" : "[MERCHANTNAME]", "address" : "[MERCHANTADDRESS]", "phone" : "[MERCHANTPHONE]", "fax" : "[MERCHANTFAX]", "webAddress" : "http://www.asseco-see.com.tr/", "additionalDetails" : "Asseco South Eastern Europe", "secretKey" : "[SECRETKEY]", "referrer" : "https://www.example.com" }, "customer" : { "id" : "MRCH_CUST_ID_123", "email" : "customerEmail-DA1y5O0U", "phone" : "11111111111111", "name" : "CustomerNameDA1y5O0U", "lastLogin" : "30.01.2015 16:11" }, "card" : { "cardToken" : "CBCANDT5NRAJK2DCKYWZ2LZ6XIPCXXMPOBEKXEXSCD4YZN6O", "cardOwner" : "Name oa9iDQNM", "panLast4" : "5454", "customer" : "Customer-oa9iDQNM", "cardBin" : "545616", "cardExpiry" : "12.2020" } } Tekrarlı Ödeme Planı Kartı Sorgulama QUERYRECURRINGPLANCARD request will return the details of cards for a specified recurring plan by using RECURRINGPLANCODE. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYRECURRINGPLANCARD, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. RECURRINGPLANCODE: string, required Max length: 16 Tekrarlı ödeme için kullanılan tekil (unique) kod. Örnek İstek ACTION: QUERYRECURRINGPLANCARD MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] RECURRINGPLANCODE: [Code-UPAG0PzB] Sample response { "responseCode" : "00", "responseMsg" : "Approved", "cardList" : [ { "cardToken" : "BKSJWIERRJQFODRQ27AEI3JLLNLVDZ64Z74I6D2Q6GJ73YBN", "cardOwnerMasked" : "N*** A*******", "panLast4" : "5454", "customer" : "Customer-AtdW4XGx", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "T45FWSAXNHZPC4NYCGVQSYY4INTCCPB3GC5MJ2HGD2YKLCG6", "cardOwnerMasked" : "N*** V*******", "panLast4" : "5454", "customer" : "Customer-Vdsj1bTN", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "RF4DIKGLC65GLBTJWUJJDJAERGKTZ27NN7PPEE7NEPWBJGVP", "cardOwnerMasked" : "N*** f*******", "panLast4" : "5454", "customer" : "Customer-f2EWrLZE", "cardBin" : "545616", "cardExpiry" : "12.2020", "pan" : "545616***5454" }, { "cardToken" : "Z6VJJMIYBNWDVIXUC3547D356FX5DZZT5KVIZBA4Z3GYAVN5", "cardOwnerMasked" : "d***", "panLast4" : "9159", "customer" : "Customer-f2EWrLZE", "cardBin" : "409070", "cardExpiry" : "12.2020", "pan" : "409070***9159" } ] } Kampanya Sorgulama QUERYCAMPAIGN aksiyonu kullanılarak kampanyalara ulaşabilirsiniz. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGN, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYCAMPAIGN MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] BIN: 511452 Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "campaignCodeList" : [ { "campaignName" : "Test1", "campaignCode" : "123", "installment" : "4", "minInstallment" : 3, "maxInstallment" : 4, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "ADDITIONALINSTALLMENT", "details" : "Test details" }, { "campaignName" : "Test2", "campaignCode" : "456", "installment" : "4", "minInstallment" : 2, "maxInstallment" : 2, "installmentAmount" : "3", "currency" : "TRY", "paymentSystemType" : "FINANS", "campaignType" : "POSTPONE", "details" : "Test details 2" } ] } Online Kampanya Sorgulama QUERYCAMPAIGNONLINE request can be used to get card holders' campaigns if they are available to merchants. Query made from bank side and a financial transaction. Request parameters: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCAMPAIGNONLINE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. AMOUNT: decimal, conditional Max length: 30 İşlem tutarı bilgisidir. Önemli Not: Üye iş yerlerinin Paratika tarafina ilettikleri tutar KDV dahil tutardır. Paratika ek olarak herhangi bir vergi hesaplaması yapmaz. INSTALLMENTS: integer, required Max length: 2 İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDCVV: string, optional Max length: 4 Kart güvenlik kodu, CVV değeri. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. CUSTOMERIP: string, optional Max length: 39 Kart Sahibi (Müşteri) IP Adresi. CUSTOMERUSERAGENT: string, optional Max length: 512 Kart Sahibi (Müşteri) Teknik Donanım. EXTRA: string, optional Max length: 1024 text.ApiDoc.Param.EXTRA.description=EXTRA parametresi, oturum bilgisine ek parametreler iletmek için kullanılan özel bir parametredir. Bu parametrenin JSON (URL-ENCODED olarak) biçiminde olması bekleniyor. Bu parametre ve iç değerlerin hatalı yazılması durumunda, gözardı edileceklerdir! Desteklenen parametreler: CardHolderAgreementMode(value: NONE/SHOW/SHOWCHECKED/SHOWCHECKEDDISABLED), AlwaysSaveCard(value: true/false), BuyerType (value: giriş yapmış kullanıcı için L; anonim için A, Üyelik ile ilk alışverişte F. Ya da bu durumlar için 0, 1, 2 olabilir), IsbankBolumKodu(string), IframeDomainUrl Etki Alanı URL'si, ödemenin hangi URL adresinden işleneceğini belirtir. PREAUTH=YES parametresi satış olarak başlansa dahi ödemenin ön provizyon olarak işleme alınacağını belirtir. IGNORECUSTOMERCOMMISSION(values : YES/NO). EXTRA: {"AlwaysSaveCard": "true", "BuyerType": "L", "IsbankBolumKodu": 12, "CardHolderAgreementMode": "SHOWCHECKED", "IGNORECUSTOMERCOMMISSION" : "YES"} Other bank parameters MAXIMUMMOBIL - Varsayılan HPP'de Maximum Mobil sekmesine sahip olmak için aşağıdaki gibi Maximum Mobil ödeme sistemi adını içerir {"MaximumMobilPaymentSystem":"PaymentSystemName"} GIROGATE Ödeme metodları. Ödeme yöntemlerinden birinin "YES" olarak gönderilmesi durumunda kimlik doğrulama GiroGate ödeme yöntemleri kullanılarak yapılacaktır. Olası değerler: YES/NO. SOFORT: {"SOFORT": "YES"} SAFETYPAY: {"SAFETYPAY": "YES"} QIWI: {"QIWI": "YES"} GIROPAY: {"GIROPAY": "YES"} IDEAL: {"IDEAL": "YES"} FINNISHONLINEBANKING: {"FINNISHONLINEBANKING": "YES"} BANCONTACT: {"BANCONTACT": "YES"} ALIPAY: {"ALIPAY": "YES"} MULTIBANCO: {"MULTIBANCO": "YES"} TRUSTPAY: {"TRUSTPAY": "YES"} EPS: {"EPS": "YES"} MYBANK: {"MYBANK": "YES"} P24: {"P24": "YES"} BOLETO: {"BOLETO": "YES"} ELO: {"ELO": "YES"} SEPA: {"SEPA": "YES"} UPOP: {"UPOP": "YES"} ISBANK - imece kart işlemlerini yaparken tarım şablonu bilgilerini İş Bankası'na göndermek için aşağıdaki gibi ekstraları eklenmelidir. {"IMCKOD":"imckod", "FDONEM":"fdonem"} SEKERBANK - Hasat Kart için bu paratmetreler kullanılabilir: {"HASATKARTSATIS", "VADEKODU", "VADEADEDI", "URUNKODU", "PLASIYERNO", "FATURANO"} ISBANK_LOAN - İşbank alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. ISBANK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"ISBANK_LOAN":"YES", "ISBANK_LOAN.maximum_term":"5"} KUVEYTTURK_LOAN - Kuveyttürk alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. KUVEYTTURK_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"KUVEYTTURK_LOAN":"YES", "KUVEYTTURK_LOAN.softDescriptor":"Finansman islem bilgisi", "KUVEYTTURK_LOAN.commissionAmount":"0", "KUVEYTTURK_LOAN.orderItemCount":"1", "KUVEYTTURK_LOAN.categoryCode":"1101", "KUVEYTTURK_LOAN.unitPrice":"100", "KUVEYTTURK_LOAN.count":"1", "KUVEYTTURK_LOAN.channel":"WM"} NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"11920171664", "NKolay.products": {"NKolay.name": "phone","NKolay.categoryId": 1,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 8000.0} FIBABANKA_LOAN - Fibabanka alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. FIBABANKA_LOAN parametresi "YES" gönderilmesi gerekmektedir. {"FIBABANKA_LOAN":"YES", "FIBABANKA_LOAN.productType":"12"} PAYMENTSYSTEMTYPENAME: string, optional Max length: 100 description FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Sample request ACTION: QUERYCAMPAIGNONLINE MERCHANTUSER: [MERCHANTUSER] MERCHANT: [MERCHANT] MERCHANTPAYMENTID: PaymentId-pqkzBsVhLD3K MERCHANTPASSWORD: [MERCHANTPASSWORD] AMOUNT: 15.92 INSTALLMENTS : 3 CURRENCY: TRY CUSTOMER: merchant-7CtRNVbX CARDEXPIRY: 12.2020 NAMEONCARD: NameOnCard CARDCVV: 000 CARDPAN: 5406670000000009 Sample response for Isbank { "action" : "QUERYCAMPAIGNONLINE", "merchant" : "testmerchant", "amount" : 15.92, "installment" : "1", "currency" : "TRY", "apiMerchantId" : "700658785", "paymentSystem" : "Türkiye İş Bankası Sanal POS", "paymentSystemType" : "ISBANK", "paymentSystemEftCode" : "0064", "pgTranDate" : "", "merchantPaymentId" : "PaymentId-pqkzBsVhLD3K", "pgTranId" : "16180OzcC07010161", "pgTranRefId" : "", "pgOrderId" : "PaymentId-pqkzBsVhLD3K", "responseCode" : "00", "responseMsg" : "Approved", "campaigns" : [ { "campaignCode" : "000001", "campaignName" : "kampanya1", "campaignExtra" : "" }, { "campaignCode" : "000002", "campaignName" : "kampanya2", "campaignExtra" : "" }, { "campaignCode" : "000003", "campaignName" : "kampanya3", "campaignExtra" : "" } ] } Ödeme Sistemi Verileri Sorgulama Query Payment System Data QueryPSData İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMDATA, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. INSTALLMENTS: integer, required Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. EFTCODE: string, optional Max length: 4 description MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. BIN: string, conditional Max length: 8 BIN değeri (Kredi / Banka kartının ilk 8 hanesi). Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. PAYMENTSYSTEMTYPE: string, conditional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) CURRENCY: string, optional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) Örnek İstek ACTION: QUERYPAYMENTSYSTEMDATA MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] INSTALLMENTS: 1 PAYMENTSYSTEMTYPE: FINANS Örnek Cevap { "paymentSystemType" : "FINANS", "responseCode" : "00", "responseMsg" : "Approved" } Üye İşyeri Komisyonunu Sorgulama QUERYMERCHANTCOMMISSION request can be used to get transaction hosting commission İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYMERCHANTCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantCommissions" : [ { "paymentDueInDays": "30", "merchantPaymentDayIndexes": "0;3;4", "paymentSystemBased": "YES", "posType" : "VPOS", "defaultCommission": { "installmentList": [ { "count": "1", "merchantCostCommissionRate": 1 }, { "count": "2", "merchantCostCommissionRate": 2 }, { "count": "3", "merchantCostCommissionRate": 3 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0 }, { "count": "6", "merchantCostCommissionRate": 0 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0 }, { "count": "11", "merchantCostCommissionRate": 0 }, { "count": "12", "merchantCostCommissionRate": 50 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] }, "paymentSystemBasedCommissionList": [ { "paymentSystemName": "My Sanalakpos Account (Test)", "installmentList": [ { "count": "1", "merchantCostCommissionRate": 0.4 }, { "count": "2", "merchantCostCommissionRate": 0 }, { "count": "3", "merchantCostCommissionRate": 0 }, { "count": "4", "merchantCostCommissionRate": 0 }, { "count": "5", "merchantCostCommissionRate": 0.29 }, { "count": "6", "merchantCostCommissionRate": 0.29 }, { "count": "7", "merchantCostCommissionRate": 0 }, { "count": "8", "merchantCostCommissionRate": 0.38 }, { "count": "9", "merchantCostCommissionRate": 0 }, { "count": "10", "merchantCostCommissionRate": 0.39 }, { "count": "11", "merchantCostCommissionRate": 0.39 }, { "count": "12", "merchantCostCommissionRate": 0 }, { "count": "crNotOnUs", "merchantCostCommissionRate": 0 }, { "count": "crOnNetwork", "merchantCostCommissionRate": 0 } ] } ], "distinctPaymentSystemId": [ "your-payment-system-id", "DEFAULT" ], "paymentSystemNames": { "your-payment-system-id": "My Sanalakpos Account (Test)", "DEFAULT": "DEFAULT" }, "classifiedCommissionList": [ { "currency": "EUR", "currencyCommissions": [ { "id": "00BYLHh9UyDE", "commissionKey": "CR8", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9Uxzm", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9Uxzl", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyCG", "commissionKey": "CR2", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyE0", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDz", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, { "id": "00BYLHh9UyC3", "commissionKey": "CR1", "commissionValue": 0, "currency": "EUR", "dueDate": 0, "paymentSystemCurrencyCommissions": [ { "id": "00BYLHh9UyDZ", "paymentSystemId": "your-payment-system-id", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 }, { "id": "00BYLHh9UyDa", "paymentSystemId": "DEFAULT", "commissionValue": 0, "dueDate": 0, "validated": false, "version": 0 } ], "active": true, "validated": false, "version": 0 }, ... ] } } } Müşteri Komisyonunu Sorgulama QUERYCUSTOMERCOMMISSION aksiyonu müşteri komisyon şema bilgisinin sorgulanmasını sağlar. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYCUSTOMERCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. ACTIVATIONDATE: date, optional Max length: 32 Format: [dd-MM-yyyy HH:mm] Eş Güdümlü Evrensel Zaman (UTC) standardında aktivasyon tarihi ACTIVATIONDATEINMILLISECONDS: string, optional Max length: 19 description Örnek İstek ACTION: QUERYCUSTOMERCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] ACTIVATIONDATE: [dd-MM-yyyy HH:mm] Örnek Cevap { "activationDate" : "25-03-2019 18:20", "paymentSystemBased" : "YES", "defaultCommission" : { "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 2.55 }, { "count" : "3", "customerCostCommissionRate" : 3.2 }, { "count" : "4", "customerCostCommissionRate" : 4.5 }, { "count" : "5", "customerCostCommissionRate" : 5.1 }, { "count" : "6", "customerCostCommissionRate" : 5.99 }, { "count" : "7", "customerCostCommissionRate" : 6.12 }, { "count" : "8", "customerCostCommissionRate" : 6.77 }, { "count" : "9", "customerCostCommissionRate" : 6.89 }, { "count" : "10", "customerCostCommissionRate" : 6.99 }, { "count" : "11", "customerCostCommissionRate" : 7.99 }, { "count" : "12", "customerCostCommissionRate" : 8.22 } ] }, "paymentSystemBasedCommissionList" : [ { "paymentSystemName" : "Test Payment System Name", "installmentList" : [ { "count" : "2", "customerCostCommissionRate" : 0 }, { "count" : "3", "customerCostCommissionRate" : 0.51 }, { "count" : "4", "customerCostCommissionRate" : 6.35 }, { "count" : "5", "customerCostCommissionRate" : 8.76 }, { "count" : "6", "customerCostCommissionRate" : 10.11 }, { "count" : "7", "customerCostCommissionRate" : 12.33 }, { "count" : "8", "customerCostCommissionRate" : 14.05 }, { "count" : "9", "customerCostCommissionRate" : 16.23 }, { "count" : "10", "customerCostCommissionRate" : 18.22 }, { "count" : "11", "customerCostCommissionRate" : 19.33 }, { "count" : "12", "customerCostCommissionRate" : 19.97 } ] } ] } Sipariş Kalemini Sorgula QUERYORDERITEM belirtilen üye işyeri ödeme numarası için ödeme kalemlerinin listesini döner. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYORDERITEM, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. PGTRANID: string, conditional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. MERCHANTPAYMENTID: string, conditional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. Örnek İstek ACTION: QUERYORDERITEM MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANTPAYMENTID : [MERCHANTPAYMENTID] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "orderItemList": [ { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 }, { "code": "ljwsd", "name": "keyboard", "description": "keyboard description ...", "sellerId": "MySeller", "quantity": 1, "productCategoryCode": 4722, "amount": 100, "sellerPaymentAmount": 10 } ] } Satıcı Sorgulama QUERYSELLER belirli bir satıcı için kaydedilen tüm satıcıları veya belirli satıcı kimliği değerine dayanarak belirli satıcının ayrıntılarını almak için istek kullanılabilir. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSELLER, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SELLERID: string, optional Max length: 32 Satıcı başına benzersiz değer. ONBEHALFOFMERCHANT: string, optional Max length: 64 description STATUS: string, optional Max length: 2 Statü, durum bilgisi. Örnek İstek ACTION: QUERYSELLER SESSIONTOKEN: [SESSIONTOKEN] MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SELLERID: seller-id Örnek Cevap { "responseCode" : "00", "responseMsg" : "Approved", "sellers" : [ { "sellerId" : "seller-id", "name" : "seller-name", "lastName" : "seller-lastname", "email" : "seller@email.com", "mobileNumber" : "+902123650505", "status" : "OK", "merchant" : { "businessId" : "10000000", "name" : "PF", "address" : "İTÜ Ayazağa Kampüsü Teknokent ARI 1 Binası No: 12 34469 Maslak", "phone" : "+902123650505", "webAddress" : "http://www.asseco-see.com.tr/" }, "iban" : "TR330006100519786457841326", "ibanUsd" : "TR330006100519786457841326", "ibanEur" : "TR330006100519786457841326", "ibanGbp" : "TR330006100519786457841326", "accountOwnerName" : "seller-owner-name", "accountOwnerLastName" : "seller-owner-lastname" } ] } Recon İşlemleri Sorgulama Query Recon Transaction Mutabakat işlem ayrıntılarını sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: RECONTRANSACTION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. PAYMENTSYSTEMTYPE: string, optional Max length: 32 Ödeme sisteminin tipi. Alışveriş kredisi için geçerli değerler: ISBANK_LOAN, KUVEYTTURK_LOAN, AKTIFBANK_LOAN, FIBABANKA_LOAN Tüm geçerli değerleri görün (34) PGORDERID: string, optional Max length: 64 description PGTRANID: string, optional Max length: 64 Ödeme sistemi / Sanal POS tarafında verilen işlem numarası (Transaction ID) bilgisi. PGTRANAPPRCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 19 Format: [dd-MM-yyyy HH:mm:ss] İşlem sorgulama tarih aralığı için bitiş değeridir. OFFSET: string, optional Max length: 6 Default value: '0' Sayfalama işleminde kullanılacak işlem raporu işlem sayısı bazında başlangıç değeri, offset. LIMIT: string, optional Max length: 4 Default value: '1000' Sorgulama cevabında yer alacak azami işlem sayısı. MERCHANTPAYMENTID: string, optional Max length: 128 Üye iş yeri tekil (unique) ödeme / sipariş kodu. TRANSACTIONTYPE: string, optional Max length: 32 description Tüm geçerli değerleri görün (12) ENDOFDAYDATE: string, optional Max length: 3 description Tüm geçerli değerleri görün (2) Örnek İstek ACTION: RECONTRANSACTION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] PAYMENTSYSTEMTYPE: [FINANS] PGORDERID : [PGORDERID] Örnek Cevap { "action" : "RECONTRANSACTION", "responseCode" : "00", "responseMsg" : "Approved", "transactionCount" : "1", "totalTransactionCount" : "1", "transactionList" : [ { "id" : "04gjM3ZOTCkr", "pgTranTraceAudit" : "331323523373", "pgTranReturnCode" : "00", "pgOrderId" : "10000000-1699563547678Q", "pgTranApprCode" : "628126", "pgTranSettleId" : "2594", "pgTranId" : "23313X9IG12585", "pgTranRefId" : "331323523373", "timePsSent" : "2023-11-09 20:59:07.683", "timePsReceived" : "2023-11-09 20:59:09.960", "timeCreated" : "2023-11-09 20:59:07.449", "amount" : 15.11, "transactionStatus" : "AP", "currency" : "TRY", "paymentSystem" : "Finansbank", "panLast4" : "5454", "transactionType" : "SALE", "installmentCount" : 1, "cardOwnerMasked" : "N*** M***", "customerId" : "Customer-M3yMoq47", "bankCommissionRate" : 2.5, "bankCommissionAmount" : -0.3778, "bankAmount" : 14.7322, "merchantBusinessId" : "10000000", "pgTranDate" : "20231109 23:59:08", "merchantPaymentId" : "PaymentId-hKXrINXF1SJT", "paymentSystemType" : "FINANS", "paratikaNetRevenue" : -0.3778, "paymentSystemPaymentDate" : "2023-11-09 20:59:07.484", "bin" : { "bin" : "545616", "cardBrand" : "VISA", "cardType" : "CREDIT", "cardLevel" : "GOLD", "cardNetwork" : "CARD_FNS", "issuer" : "FINANS", "virtual" : "NO", "countryIsoA3" : "TUR", "issuerType" : "FINANS", "is6Digit" : "YES", "is8Digit" : "NO" }, "schemaValue" : { "commissionKey" : "ON_NETWORK_CREDIT", "commissionValue" : 2.5, "currency" : "TRY", "schemaName" : "PSCS_ZERO_COMMISSION", "dueDate" : 0, "pointCommissionRate" : 0, "serviceCommissionRate" : 0, "cutoffCommissionRate" : 0 }, "merchant" : { "product" : "Tek Tıkla Ãde", "commissionRate" : 0, "commissionAmount" : 0, "paymentAmount" : -15.11, "paymentDate" : "2023-11-13 00:00:00.000", "schemaName" : "MCS_ZERO_COMMISSION" } } ] } Ödeme Sistemi Havuzu Sorgulama QUERYPAYMENTSYSTEMPOOL Ödeme sistem havuzlarını almak için istek kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYPAYMENTSYSTEMPOOL, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. STATUS: string, optional Max length: 2 Statü, durum bilgisi. Tüm geçerli değerleri görün (4) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. Örnek İstek ACTION: QUERYPAYMENTSYSTEMPOOL MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] STATUS: OK Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "PsPools": [ { "name": "All Payment System In Pool", "status": "OK" }, { "name": "Halkbank", "status": "OK" }, { "name": "YKB Pool", "status": "OK" }, { "name": "Akbank Pool", "status": "OK" }, { "name": "Isbank Pool", "status": "OK" }, { "name": "Vakifbank Pool", "status": "OK" }, { "name": "HSBC Pool", "status": "OK" }, { "name": "Teb Pool", "status": "OK" }, { "name": "Finans Pool", "status": "OK" } ] } Tarım Şablonu Sorgula QUERYAGRICULTURETEMPLATE request can be used to get agriculture template information from bank side. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAGRICULTURETEMPLATE, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, conditional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. CURRENCY: string, conditional Max length: 3 ISO Alpha para birimi kodu. Örneğin: TRY, EUR, USD, GBP. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/ISO_4217#Position_of_ISO_4217_code_in_amounts. Tüm geçerli değerleri görün (33) PAYMENTSYSTEM: string, optional Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. INSTALLMENTS: integer, optional Max length: 2 Default value: '1' İşlemde kullanılacak taksit sayısı. Bu değer ödeme sisteminde tanımlı ve geçerli bir değer olmalıdır. CUSTOMER: string, conditional Max length: 128 Üye iş yeri sisteminde tanımlı olan müşteri kodu ya da numarası. Üye iş yeri tarafında bu değer tekil (unique) olmalıdır. TCKN gibi bilgiler de kullanılabilir. CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CUSTOMERNAME: string, optional Max length: 128 Müşteri ad soyad bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. CARDTOKEN: string, conditional Max length: 64 Kaydedilen kart numara (PAN) ve kartın geçerlilik bitiş tarih bilgisi için verilen güvenli alfa-nümerik değer. Kart bilgilerinin verilmediği durumlarda bu değerin verilmesi zorunludur. CARDPAN: string, conditional Max length: 19 PAN (Primary account number), kart numarası. Detaylar için lütfen bakınız, https://en.wikipedia.org/wiki/Bank_card_number. CARDEXPIRY: string, conditional Max length: 7 Kartın geçerlilik bitiş tarihi. [mm.yy] formatında belirtilmelidir. NAMEONCARD: string, conditional Max length: 64 Kart üzerinde yazan isim. FORGROUP: string, optional Max length: 3 Default value: 'YES' Grup içi sorgulama ve diğer özellikler için kullanılan belirteçtir. Kabul edilen değerler şunlardır: 'yes', 'no'. Örnek İstek ACTION: QUERYAGRICULTURETEMPLATE MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] MERCHANT: [MERCHANT] CURRENCY: TRY MERCHANTPAYMENTID: PaymentId-xKYNX3KFWwfi CARDPAN: 5456165456165454 CARDEXPIRY: 12.2025 CUSTOMER: Customer-nLRiOspV CUSTOMERNAME: Name nLRiOspV CUSTOMEREMAIL: nLRiOspV@email.com CUSTOMERIP: 127.0.0.1 CUSTOMERUSERAGENT: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.81 Safari/537.36 NAMEONCARD: Name nLRiOspV CUSTOMERPHONE: +904196113535 CUSTOMERBIRTHDAY: 01-01-2001 Örnek Cevap { "apiMerchantId" : "3123", "paymentSystem" : "AgricultureVPOS", "paymentSystemType" : "DENIZBANKINTERTECH", "paymentSystemEftCode" : "0134", "merchantPaymentId" : "PaymentId-xUASUZrAczOj", "pgTranId" : "117312***0043", "pgTranRefId" : "hostid", "pgOrderId" : "10000000-PaymentId-xUASUZrAczOj", "pgTranReturnCode" : "00", "pgTranApprCode" : "949377", "pgTranTraceAudit" : "Success", "responseCode" : "00", "responseMsg" : "Approved", "agricultureTemplate" : [ { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 4, "paymentFrequency" : 4, "commissionRate" : 1.23 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 11, "paymentFrequency" : 1, "commissionRate" : 3.04 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 10, "paymentFrequency" : 1, "commissionRate" : 2.35 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 1, "commissionRate" : 3.73 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 3, "commissionRate" : 5.12 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 5, "paymentFrequency" : 5, "commissionRate" : 1.71 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 3, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 9, "commissionRate" : 1.65 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 6, "paymentFrequency" : 6, "commissionRate" : 3.13 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 12, "paymentFrequency" : 6, "commissionRate" : 7.18 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 9, "paymentFrequency" : 3, "commissionRate" : 3.08 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 8, "paymentFrequency" : 1, "commissionRate" : 1.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 1, "commissionRate" : 2.00 }, { "templateName" : "12 AY VADE 120 BLK A", "maturityPeriod" : 3, "paymentFrequency" : 3, "commissionRate" : 2.00 } ] } Başvuru Dokümanı Sorgulama QUERYAPPLICATIONDOCUMENT isteği başvuruya ait dokümanları listelemek için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYAPPLICATIONDOCUMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. APPLICATIONCODE: string, required Max length: 64 Başvuru kodu APPLICATIONDOCUMENTTYPE: string, optional Max length: 64 Başvuru doküman tipi Tüm geçerli değerleri görün (14) SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYAPPLICATIONDOCUMENT MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] APPLICATIONCODE: [APPLICATIONCODE] APPLICATIONDOCUMENTTYPE: [APPLICATIONDOCUMENTTYPE] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "applicationDocuments": [ { "fileType": "PNG", "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAKoAAABVCAYAAADZsn9OAAAMy0lEQVR42u1dD5RUVRm/i4AoQvgvDoW2uIM7b6IV2D/z3pusYXfn/SlFQGZntuwcy+PJP0VaekiKQu0YHkEwTpZUlmigZmaZUSpJ4p9UtPiTAYYKyh+h3ZlZFnYXF7bvu292d968++bPMntmlr7fOffMMvPeffd+93e/+33f/e6DMQKBQCAQCAQCgUAgEAgEAoFAIBBOIhycec6YWHjy1ESTJCfCFZ6eIBtOUiGUDHrCbGSi6cLr41HpSKLZ12MVqScW8W5IXH7B5B7GhpGUCEXWopVjgKCrgJjH+knaX2JRKXEo4p0DZC0jaRGKhniTNF9E0NQCRP5322zv2SQtQlEQm1U+Lt4src9GVE7WSGWYJEYoCo7M8UyMR327cyFqIiI9SBIjFIeo0YrzYFnfkxNRo9LDJDFCUXBodsVHgaibc1r6o94FJDFCUYBx0kTUuzIHZ6q9M+KpIIkRiobW2RVTgIjvZ1jyj8cj3qVbw2wkSYtQVLwTHDcuFpV2CEkalVb2hNkpJCVCSaDF9IxNNHm/HotIy2MR74q2qPcOKCpJhkAgEAgEAoFQLCTCE8+Kz/FMb2+WQu1NlXqsqXJGfJan4i3TcypJh1ACHn/5qLaI99vg3W/C1D5b/LRZ6gDPf01b2KOQpAhFA6bugea8DcNQmYP+0s4PZk4aTxIjFAVIPtCkW3JLSvHeShIjFAX5JKXEopWUlEIoDuKfP//MOB43yUpUqRuIehVJjFA0xKLeIGjVjsxJ09IjPdr40SQtQpE9fzYKyPp4vNm3G0orkDMG/z4Qi0rbW5u8t5CECCVG2PJRrZdXVsXnSNNj0fJyOn1KIBAIBMJJi/bmSeNj4clXxiLe+8HBWg226ZKW2R4F7VeSDqGowIToeLiyPhaR9mbM8I96f4Lnq0hihKLg4BxpAhBxW27n+qVlJDFCUYAZU4lm77rsh/t8h1ubKq8hiRGKBlj6JyWivnmw/K8B7RqHvz+Epb67rVnqiqG2jXoXtUa8l9Cb/QilY7MyVpZeSCoEAoEwqJgaHMcU/QGmGjuSZSvzhz5HgiGUFvymxgJmj62oxvOcwATCYKIl7PGBZ38FlMVYYk3eRYm5F5p7LplwOhGVMNgoY+XBUYwFhR77gbDvDPD2/wDefrZ3T3XG53o0Iiqh8JC1a5mq38tU8zEo90NZzgJGpYOoTdKN8aj3nxmSpo/GIt6HWkC7ElEJhYeqb3GQSdG/kOmW5xgbvrGajcAj0hsZG/Eoc3nnFBGVUECibs6XqORMEYio/xeYFvoYq2m4gH+m75ZUN36EqdpnmGLovKAQ/Q0+lm92uhUbrGNqSOurS4W6VK2eqfUVOdY3jCn1H+dtrdLs2UbTzHOhvvpk3Q2sOniOuApwfBTNy6/pbQeWgBZiakOt5RxlAMrjU58+E4j6poNMsn41/y2XgvLw+UYWhKiVgTFMNsqtMbz43KwOYM2MSmhro63/OC7+RpnXVaKa4U4QwiYW0LfzT1m7kROiunoEkOg78N1LUNqBBMd4CZjd8PkudO5xdzKkoBYGXzUehfIylP8m7z/WX5/RyYPaivF7Jof8Wdq62NJkvK2vA+Fu4N/XNYKgjVehvq5kvV1Q34a0wR8LE2UZ3P8XuPadlGt72/EhfH8Qynq47ntCwir6XbwfAfPv8HlEQKb/8N9yLarxLKsL1ZwAUWHiGnfDby9C2cblEjA2Qjt/7agzAARUjB/CdWvhmrfh82ha/7uhtELZwOt0m0TFI6rxil0g6MGCtpKNNfBbj0Ng9mt3gnatctU8iv5kxvudg3EcyHcTC4rDPdaEsi21q5g/hIPaKqyvV0v79cvg3niebXmdaz7784/nVUdOz9FXDpiosnEln3DOa1+2kVnWIsLrMvf/peQKW7JEfQ0I8EpWkvYL+m9M5L2q5lyuPfMfvBgQa0aORH3G0iQudSn6Wcn79gyMRMZDTFFO69dKBSYpb6Px8wERdVr9J5IaPP26t5jcKKUojPMzysi971h+VrpEddN0mX6XjXmCZfJraRPAqocvNfpOy5xwqddNQOlEzVZ67W1Rf7j2BlNEQTPAtR37mdI4LcX02FUiRB0B970rWOHaoL16Wl0+WM53CfuvGi0wTvvdxxfIinZvyRNVAXtHNW5nteBMyXoT/PtpYadUEBou9faAuGmR0jgE5Zd8+a2uPt3mrNU1nA11PuLQ3lhfvkRVjQQQ6WH4vA/KX2HyPJVy33vJa56Fa+aDuYIvJOs3L9Ae94eu4APnGFBtbv914PSh/RYwlyXt7fQ2rOW/uRXF2HvCRPWYp8JYLBGQtAu+v8bhDAdg+VbNNy3fAOSimLdxx8vRf/1LSR8kfcX8VmkTFZ2RWu0827WWt7tTIMR2HhlIRZU2mnv5OCNREK47PEaQG/bpBGGCRGI3oqrgCNU1KHwQ0Sbz+8dy56kX6OXWhqZyh8IN6Dyp+m8Ecri5YOEpxXjhhImKZpFqHnba9vr1TJzfOgzGZgqT66dzuWSMqBjP5NS+EiLqTq49hKET0IzO68Fj1q8e0PNxMgTMTkedfnNiTkRFTYrhlcLI4kfO+rWlJUNUWZ8Ozzgo0Hr32mzpgULWvi/o05OlS9RM6p6HrYyDgg4tHNDzUUsHjI4BE1U2flywUIpq3CMg0t0lQtRtUP9GwTMfcJhdA+6/du0QI6p2XZZ7XhXYSEuESw+SSDUrLJtVf4I7JGjfYbiot4iW85w1qv7NnPuKmwXoHMk8dryVO0up7RCFcEqHqJZDav/ugzycnTJWrU9gtfonoZ23QdnO71fNWIoMjpxsRP2zQOD3OXaX6vSL4fvVeccwC01U1NqyvoCHbtCezc8rLxWidognkr4WlrkRGZ+L9res3Z7cTcsvZDjEifpHgSCX2jSq36jiGmugYZvCEbUMyPCrnOPCpUvUF+GZ61ycyXmuz0QHUzWeGnj4bGgT9Q0BYX5g209X9dcE5kEr3Ls6aQvelSwruDM2WERFe1tEUuy3CvYtmiy9bVHNN0qYqM+zGjBbVGO3MMjvD00WP1P7isNZtWLIG5L5tP39D4i8/qFLVHSmutIIeAw69I1+QYc08cZA6NKk41NWMGcqE1ExRBUQ7Mooxqrk9uiwIeRMWeEp2bzUEe/EiajovxA/U39a6IAJ+z/UnClFf5s7QOIZerNgB6ODKaHZKcJZKBiQFwbF689EVNxKVM19aYN6lJWXjxoUr9+vf3nw46j+sfD3E8LdNtzTd7Zzv6P/SmPDyeH19yY2oJdsEyDanYI4HiaFpBJb0W8VDMhvxYMX+qwj4F8ooqoY5DcOpPUrLoxOTFRO4xlhuRN1i6Atd7JML5UoBFF57NmodRmzHQ4TwBl37XTJUsOA/9qhR1RLU+6FTs3kZ4EUTRXmYFqd+ZNdOOYNgro6k5sIZX1hKwxguyVMFIKoddokmEDvC/NGrV0sy9nCLVVZu0e4PexKVMGgYvJLnVbP5eXXQjytzpPyP/MViqjWBL9FYAIc56mI9nbuEphpC20HErH/ivHToedMpXdMNQ4L94Et4RxiNdoUu6AbfC4e9L+SOaGLeWZSprBVIYjKY7g8f9Q5adCpk6Edirkc+vYP16iAO1EXuUzubr7FaeV57mPVmndQiIohp4DxnHA8alO2s1XjQcGYJridihOJ57Nyx7d7KBK1O/f8UZcdKUwQyT0MMnhef29yTK79SdeqbkTlK0yW+DDu4KUmRheSqLxv4JwKg/RGS18uLa8LyJtzel+arEqaqH7tu9ymzBQct0i6gmdAuS67xvosQrESlDHRYjAD/tZJhWykOgLku4OHbXIiKti0mAeQuc73bIk9hSYqbmejZhSRDY9z95lYvP8dWUjaxmRwJlX9saEVnsLsJ1n7IgiyXbiEyw2NWffYUbCqcR2PnzoF38UnxJSG8clB3JRCvs0g4ZECZ+Qmvmz317EP6qjO2kc8MYDngRRB/Nd63jqYWBfxgZdDC/q0Ci7hdaFwxmB6nTarL40w3bxQjKtsISCUJybR9Lf/AKvR6xz14rYobnGmZofh8RjRiy6qqkYnzaijtkQdTB7qQ/gUrtnTJ2HqaQbuYEH9sj6/b0VVwYypM746NOKomEOKg8iPc2BeKuYyBvN7lyfWgQfq8CAf1oNhI1/wDIfXOQGum5CWs+pk3XA+ONkO4bntUuHxCiQ3tgOX74t4ZMMeT0QHCJ/Bckx2weunBst5VIQTHpxG9/al9jPzgUZsA29HDgcfUWngtVbOr3v/sb9IStmYybe4q4ITHfLG8B1/brCE3tk6kJ0pAoGISiAQUQlEVAKBiEogouq/EyRXXEaCIZQWMHY4HbOMDIUX6ygt/W8dBAKBQCAQCAQCgUAgEAgEAuFkwP8ATX9UIiXmF98AAAAASUVORK5CYII=", "documentType": "IDENTITY", "fileName": "image.png", "filePath" : "/application-files/ZCKZAPMGG3LZYTAU7KMWV2IRBAFXBSGXNAYDEIQVUWGMK4IB/IDENTITY" } ] } İşlem Barındırma Komisyonu Sorgulama QUERYTRANSACTIONHOSTINGCOMMISSION bu istek işlem barındırma komisyonu sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. MERCHANT: string, optional Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. Örnek İstek ACTION: QUERYTRANSACTIONHOSTINGCOMMISSION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SESSIONTOKEN: [SESSIONTOKEN] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "transactionHostingCommissionSchemaList": [ { "name": "TEST_THCS" }, { "name": "THCS_ZERO_COMMISSION" }, { "name": "thcDev" } ] } Query OTP(One time password) QUERYOTP request can be used to get OTP(One time password). İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYOTP, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SESSIONTOKEN: string, optional Max length: 48 Oturum anahtarı. OTPCODE: string, required Max length: 6 description EMAIL: string, required Max length: 64 description RequestSample ACTION: QUERYOTP MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] OTPCODE: [OTPCODE] SampleResponse { "responseCode": "00", "responseMsg": "Approved", "otpCode": "107038", "createdTs": "2022-08-18 16:08:43.578", "status": "OK" } Üye İş Yeri Kullanıcı Sorgulama QUERYMERCHANTINFORMATION request, üye işyeri kullanıcılarını sorgulamak amacıyla kullanılır İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYMERCHANTINFORMATION, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANT: string, required Max length: 128 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, required Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, required Max length: 128 API Kullanıcı şifresi. Örnek İstek ACTION: QUERYMERCHANTINFORMATION MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "merchantInformationList": [ { "merchantName": "Test Merchant", "merchantUserInformation": [ { "merchantUser": "Test User", "merchantPhone": "+902123456789", "merchantEmail": "merchantuser@testmerchant.com" } ] } ] } Alışveriş Kredisi Taksit Sorgulama QUERYSHOPPINGLOANINSTALLMENT bir kredi kullandırım hizmetinden kredi taksitlerini sorgulamak için kullanılır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSHOPPINGLOANINSTALLMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, required Max length: 48 Oturum anahtarı. PAYMENTSYSTEM: string, required Max length: 128 Ödeme sisteminin (banka ödeme geçidinin /vPOS hesabının) adı. Belirtilen isim Paratika ilgili ekranlarda tanımlanan isimle aynı olmalıdır, aksi takdirde burada belirtilen değer gözardı edilir ve Paratika uygulamasındaki akıllı değişim özelliği devreye alınır. Örnek İstek ACTION: QUERYSHOPPINGLOANINSTALLMENT SESSIONTOKEN: [SESSIONTOKEN] PAYMENTSYSTEM: [PAYMENTSYSTEM] Örnek Cevap { "responseCode": "00", "responseMsg": "Approved", "loanServiceResponse": { "resultCode": "1", "resultExplanation": "Ä°Ålem baÅarılı", "loanInstallments": [ { "productCode": "AG", "effectiveInterestRateMonthly": "1.6125107187716647", "installmentAmount": "708.10", "creditInterest": "0.012900", "term": "24", "totalPaymentAmount": "16994.53", "productName": "TEST 24 AY", "effectiveInterestRate": "21.161931631123785" }, { "productCode": "AH", "effectiveInterestRateMonthly": "0.0", "installmentAmount": "388.88", "creditInterest": "0.000000", "term": "36", "totalPaymentAmount": "14000.00", "productName": "TEST 36 AY", "effectiveInterestRate": "0.0" }, { "productCode": "AJ", "effectiveInterestRateMonthly": "1.712476181653022", "installmentAmount": "2945.48", "creditInterest": "0.013700", "term": "5", "totalPaymentAmount": "14727.38", "productName": "5 AY faizli", "effectiveInterestRate": "22.600072680100357" }, { "productCode": "AC", "effectiveInterestRateMonthly": "1.6125154919656604", "installmentAmount": "1292.53", "creditInterest": "0.012900", "term": "12", "totalPaymentAmount": "15510.40", "productName": "TEST 12 AY", "effectiveInterestRate": "21.161999929353968" } ] } } api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] } Parçalı Ödeme Sorgulama QUERYSPLITPAYMENT talebi bölünmüş ödemeyi sorgulamak için kullanılabilir İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYSPLITPAYMENT, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. SESSIONTOKEN: string, conditional Max length: 48 Oturum anahtarı. MERCHANT: string, conditional Max length: 16 Sistemde tanımlı olan üye iş yeri kodu bilgisidir. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. SPLITPAYMENTCODE: string, optional Max length: 64 description STARTDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için başlangıç değeridir. ENDDATE: date, conditional Max length: 32 Format: [dd-MM-yyyy HH:mm] İşlem sorgulama tarih aralığı için bitiş değeridir. DUEDATE: date, optional Max length: 16 Format: [dd-MM-yyyy HH:mm] description CUSTOMEREMAIL: string, optional Max length: 64 Müşteri e-posta bilgisi. Müşteri / Kart sahibi bilgilendirme özellikleri kullanımlarında bu bilginin doğru olarak geçilmesi zorunludur. SPLITPAYMENTSTATUS: string, optional Max length: 2 description Tüm geçerli değerleri görün (5) MERCHANTCONTENTID: string, optional Max length: 16 Üye iş yeri tekil içerik belirtecidir. Örnek İstek ACTION: QUERYSPLITPAYMENT MERCHANT: [MERCHANT] MERCHANTUSER: [MERCHANTUSER] MERCHANTPASSWORD: [MERCHANTPASSWORD] SPLITPAYMENTCODE: Code-JSjAuDXf Sample response { { "responseCode": "00", "responseMsg": "Approved", "splitPaymentList": [ { "totalAmount": "50.00", "code": "Code-1256", "maxSplitCount": 2, "maxInstallmentCount": 0, "paidAmount": "50.00", "calculatedpaidAmount": "50.00", "refundedAmount": "0.00", "currency": "TRY", "createdTime": "2024-03-07T16:50:04", "expirationTime": "2024-03-08T17:50:16", "status": "AC", "merchant": { "businessId": "10000000", "name": "NestPay Ãdeme Sis", "tradingName": "COMPANYTEST", "address": "KÃLTÃR MH. NÄ°SPETÄ°YE CD. AKMERKEZ E3 BLOK", "phone": "+902123650505", "fax": "+902123650555", "webAddress": "http://www.asseco-see.com.tr/", "additionalDetails": "Asseco SEE", "secretKey": "kKdIU0EP9qKJWPfz5sF0", "paymentPolicy": "THD_OPT", "domains": "www.msumerchant.com", "preInformationText": "asfdafsdfasdsd", "remoteSalesAgreement": "asfddsfsdfasdfasdfafsda", "integrationModel": "ALL", "maximumMobilOnHPP": "YES", "axesWalletOnHPP": "YES", "axessMobileMaxInstallmentCount": "1", "allowPreamt": "YES", "useHpp": true, "showManualPOS": "true", "useFibabankaLoan": true, "useIsbankLoan": true, "useKuveytLoan": true, "useNkolayLoan": true }, "customer": { "id": "MRCHCUSTID-12310830", "email": "testcustomer@email.com", "phone": "4440444", "name": "Test Customer", "birthday": 978307200000, "lastLogin": "21.01.2018 13:48" }, "splitPaymentTransactionList": [ { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812559", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "310386", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} }, { "originalAmount": "25.00", "amount": "25.00", "merchantPaymentId": "payment-1709812635", "installmentCount": 1, "cardNumber": "435508***4358", "cardOwner": "N*** L***", "issuer": "Akbank 01", "paymentSystemType": "AKBANK", "authCode": "380571", "nameOnCard": "Name Lsw7mJAm", "cardExpiry": "12.2026", "extra": {} } ] }
api çağrısı, mevcut entegratörler için kullanılacaktır. QUERYINTEGRATOR api çağrısı, mevcut entegratörler için kullanılacaktır. İstek parametreleri: .glyphicon { color: #337ab7 !important; } ACTION: QUERYINTEGRATOR, required Max length: 128 API çağrısında yapılacak ana işlem belirteci. MERCHANTUSER: string, conditional Max length: 128 API Kullanıcısı. MERCHANTPASSWORD: string, conditional Max length: 128 API Kullanıcı şifresi. RequestSample ACTION:QUERYINTEGRATOR MERCHANTUSER:msusa@email.com MERCHANTPASSWORD:Pluto321` SampleResponse { "responseCode": "00", "responseMsg": "Approved", "integrators": [ "ARGEDAN", "BIGTEK", "BIZIMORADAN", "CALLCENTRE", "DIRECTSALE", "DOKUZYAZILIM", "EFASIS", "ESTERLIK" ] }