Başlangıç

Bu doküman Mavipos ödeme hizmetlerini kullanacak olan kullanıcıların sistemlerine özel entegrasyon geliştirebilmesi adına hazırlanmıştır. Dokümanda bulunan veriler geliştirme süreçleri sonrası güncellenebilmektedir. Geliştirici kullanıcıların doküman güncelliğini kontrol etmesi önerilir.

Misyon & Vizyon

Mavipos olarak kişiye özgü modern ödeme ekranları ile kullanıcıların müşterilerine güven sağlamasını ve bu imkanlardan en uygun komisyon oranları ile yararlanmasını hedefliyoruz.

Mavipos markamızı ulusal pazarda emin adımlarla büyüterek elektronik ticaret sektöründe güvenilir ve itibarlı bir konuma taşımak istiyoruz. Ulusal çaptaki hedeflerimizi tamamladığımızda uluslararası hizmetlerimizi de yayına almayı hedeflemekteyiz. Yöntemlerimizi güncel teknolojiler ile sürekli geliştirerek, uluslararası pazarda ülkemizi en iyi şekilde temsil eden markalar arasında yer almayı amaçlıyoruz.

Güven Unsuru

Mavipos olarak güven ilk önceliğimiz, geliştirmiş olduğumuz ödeme sistemlerimizi günümüze uygun en güvenli yöntemler ile geliştirmekte ve bu doğrultuda güncel tutmaktayız. Yaptığımız yenilikler ile güven konusunda geride kalmış bir çok ödeme kuruluşuna örnek olmayı hedefliyoruz.

Desteklenen Diller

API desteği, HTTP Post yöntemlerini uygulayan tüm platformları ve dilleri desteklemektedir. Dokümanımızda şuan için sadece PHP kod örnekleri yer almaktadır, bu kod örneklerini baz alarak diğer dillerde geliştirmelere uyarlayabilirsiniz. İlerleyen süreçte dokümanımızda yer alan örnek kodlara seçenekler eklenecektir.

Sorgu Yanıtları

Mavipos sorgu cevapları JSON formatında gönderilir. Cevapları işleyebilmek için JSON ayrıştırma araçları kullanabilirsiniz.

Önemli Değerler

merchant: 'Satıcı Anahtarı'
apikey: 'Api Anahtarı'
secret: 'Gizli Anahtar'
salt: 'Benzersiz Değer'
"Authorization: Bearer" değeri yukarıda belirtilen değerler ve Doğrulama sayfasındaki formül ile oluşturularak her oturum için HTTP headers ile gönderilmelidir. "salt" değeri kullanıcı tarafından her işleme özel veya kişiye özel oluşturularak gönderilmesi gereken değerdir. Salt Oluşturma sayfası üzerinden tüm detayları inceleyebilirsiniz.

Hata Kodları

İşlem sırasında alabileceğin hata kodları ve detayları aşağıda yer almaktadır.

MV0001 "Satıcı Anahtarı, Gizli Anahtar, API Anahtarı değerleri hatalı, lütfen kontrol edin." hatası ile karşılaştığınızda belirtilen değerlerin Mavipos tarafında görünen veriler ile karşılaştırın. MV0002 "Mavipos hesabınız aktif değil, lütfen Mavipos yönetimi ile irtibata geçin." hatasına Mavipos hesabınızın durumunu kullanıma uygun olmadığında karşılaşılmaktadır. MV0003 "[Değer Adı] değeri gönderilmeli, lütfen kontrol edin." hatası ile istekte zorunlu olarak gönderilmesi gereken değerin gönderilmemesi durumunda karşılaşılmaktadır. MV0004 "Sanal posunuz aktif değil, lütfen Mavipos paneli üzerinden kontrol edin." hatası ile işlem yapmak istediğiniz sitenin sanal pos yetkisinin aktif olmaması durumunda karşılaşılmaktadır. MV0005 "Referer değeri gönderilmemiş, lütfen isteği kontrol edin." veya "Yetkisiz url üzerinden işlem yapılamaz, lütfen kontrol edin." hatası ile Zorunlu Parametreler sayfasında bulunan Referer değerinin eksik veya hatalı gönderilmesi durumunda karşılaşılmaktaıdr. MV0006 "Bearer yetki kodu bulunamadı." hatası ile Zorunlu Parametreler sayfasında bulunan Authorization değerinin eksik gönderilmesi durumunda karşılaşılmaktaıdr. MV0007 "Bearer yetki kodu doğrulanamadı." hatası ile Zorunlu Parametreler sayfasında bulunan Authorization değerinin hatalı gönderilmesi durumunda karşılaşılmaktaıdr. MV0008 Gönderilen tutar ile sepetteki ürünlerin tutarı eşleşmemektedir, lütfen kontrol edin. MV0009 İşlem Mavipos tarafına kaydedilemedi, lütfen Mavipos yönetimi ile irtibata geçin. MV0010 Eksik veya hatalı alan gönderdiniz, lütfen kontrol edin. MV0011 Bu tokene ait işlem bulunamadı, lütfen kontrol edin. MV0012 İşlem doğrulama kodu hatalı, lütfen kontrol edin. MV0013 İşlem doğrulama kodu doğrulanamadı, lütfen tekrar deneyin. MV0014 Seçilen taksit mağaza taksit limitinden daha fazla, lütfen Mavipos yönetimi ile irtibata geçin. MV0015 Seçilen taksit bulunamadı, lütfen Mavipos yönetimi ile irtibata geçin. MV0016 Mağazanın yurtdışı yetkisi bulunmamaktadır, lütfen Mavipos yönetimi ile irtibata geçin. MV0017 Mağazanın özel kart yetkisi bulunmamaktadır, lütfen Mavipos yönetimi ile irtibata geçin. MV0018 Son kullanma tarihi hatalı, lütfen kontrol edin. MV0019 Mağazanın ödeme limiti bu işlem için yeterli değildir, lütfen mağaza ile irtibata geçin. MV0020 Ödeme işleme alınırken sorun oluştu. Lütfen daha sonra tekrar deneyin. MV0021 Ödeme güvenlik nedeniyle başarısız sonuçlandı, lütfen işlemi tekrar deneyin. MV0022 İşlem bulunamadı, lütfen tekrar deneyin. MV0023 Banka tarafından gönderilen hata mesajı. MV0024 [siparis_no] numaralı işlem bulunamadı. Lütfen kontrol edin. MV0025 [siparis_no] numaralı işlemin tutarı iade tutarından düşüktür, bu durum kur farkından yaşanıyor olabilir. Lütfen Mavipos ile iletişime geçin. İade edebileceğiniz tutar: [tutar] [kur] İade edilmek istenen tutar: [tutar] [kur] MV0026 Hesabınızın iade için yeterli bakiyesi bulunmamaktadır. Lütfen Mavipos ile iletişime geçin. İade edebileceğiniz tutar: [tutar] [kur] İade edilmek istenen tutar: [tutar] [kur] MV0027 [siparis_no] numaralı işlem iade edilemedi, lütfen tekrar deneyin. Sorun devam ederse Mavipos ile iletişime geçin. Hata: [hata_mesaji] MV0028 [siparis_no] numaralı işlemi gün sonu olmadan kısmi iade edemezsiniz, gün sonu alındıktan sonra lütfen tekrar deneyin.

Önemli Değerler

merchant: 'Satıcı Anahtarı' // API Bilgi sayfası üzerinden erişebilirsiniz. apikey: 'Api Anahtarı' // API Bilgi sayfası üzerinden erişebilirsiniz. secret: 'Gizli Anahtar' // API Bilgi sayfası üzerinden erişebilirsiniz. salt: 'Benzersiz Değer' // Her işleme özel oluşturulmuş anahtar Salt Oluşturma sayfası üzerinden erişebilirsiniz. "Authorization: Bearer" değeri yukarıda belirtilen değerler ve Doğrulama sayfasındaki formül ile oluşturularak her oturum için HTTP headers ile gönderilmelidir.

Salt Oluşturma

Salt değeri oturumun şifrelemesini en güvenli hale getirmek için benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Salt değeri sabit gönderilebilir fakat sabit gönderilmesi önerilmez. Oturum esnasında rastgele oluşturulması önerilir.

İstek Örneği

PHPCurlPythonJavascriptJava
$salt = hash('sha512', uniqid(mt_rand())); $salt değeri oturuma özel oluşturulmuş salt değeridir. Bearer oluşturulduğu esnada burada belirtilen salt kullanılmalıdır. Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Bearer Oluşturma

Bearer değeri Mavipos API sorguları için oluşturulan her oturum için özel oluşturulmalıdır. Oluşturulan Authorization Bearer değeri HTTP Headers alanında gönderilmelidir.

Gerekli Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahtarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

merchant: 'Satıcı Anahtarı' // API Bilgi sayfası üzerinden erişebilirsiniz. apikey: 'Api Anahtarı' // API Bilgi sayfası üzerinden erişebilirsiniz. secret: 'Gizli Anahtar' // API Bilgi sayfası üzerinden erişebilirsiniz. salt: 'Benzersiz Değer' // Her işleme özel oluşturulmuş anahtar Salt Oluşturma sayfası üzerinden erişebilirsiniz.
PHPCurlPythonJavascriptJava
$merchant = 'Satıcı Anahtarı gelecek'; $apikey = 'API Anahtarı gelecek'; $secret = 'Gizli Anahtar gelecek'; $salt = 'Oluşturulmuş salt değeri'; $pass = $apikey.$secret.$merchant; $hash = base64_encode(hash_pbkdf2("sha256", md5($pass), $salt, 8138)); $hash değeri oluşturulmuş Bearer değeridir. Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Örnek Headers Tanımlaması

PHP Curl Python Javascript Java
$headers = [ 'Accept: application/json', 'Content-Type: application/json', 'Authorization: Bearer {$hash}' ]; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Token Oluşturma

Ödeme formu için istek gönderilmeden önce gönderilecek işleme ait token oluşturulmalıdır. Bu token kullanılarak ödeme formu alınabilir. Her tokenin oturum süresi 30 dakikadır ve tek sefer kullanılabilir.

Test Ortamı Uç Noktası

POST https://www.mavipos.com/api/createToken

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/createToken

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahtarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez. customerName Gerekli Siparişi veren kişinin adı ve soyadı bu alanda gönderilmelidir. Bu alan maksimum 128 karakter gönderilebilir. customerMail Gerekli Siparişi veren kişinin mail adresi bu alanda gönderilmelidir. Bu alan maksimum 64 karakter gönderilebilir. customerPhone Gerekli Siparişi veren kişinin telefon numarası bu alanda gönderilmelidir. Bu alan maksimum 64 karakter gönderilebilir. cart Gerekli Bu alanı nasıl oluşturacağınıza dair bilgiye Sepet Oluşturma sayfasından erişebilirsiniz. price Gerekli Sipariş tutarı bu alanda gönderilmelidir. Bu alan sayı olarak gönderilebilir. Virgül kullanılmamalıdır. currency Gerekli Sipariş para birimi bu alanda gönderilmelidir. Bu alan TRY, USD, EUR, GBP gönderilebilir. Gönderilen birim hesabınıza tanımlı olmadığı takdirde tanımlı kura göre çevrimi yapılarak tahsis edilir. return Gerekli Sipariş sonucunun gönderileceği sayfa bu alanda gönderilmelidir. shipCode Gerekli true yada false olarak gönderilebilir. True gönderildiğinde Kargo Kodu parametreleri zorunludur.

Test Ortam Sorgu Örneği

$data = array( 'merchant' => 'Satıcı Anahtarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'customerName' => 'Mavipos Test', 'customerMail' => 'it@evkal.com', 'customerPhone' => '08503057717', 'cart' => array( array( 'name' => 'Mavipos Entegrasyon Hizmeti', 'price' => 2.75, 'quantity' => 3 ), array( 'name' => 'Mavipos Ürün Hizmeti', 'price' => 10, 'quantity' => 1 ), array( 'name' => 'Kargo Ücreti', 'price' => 15, 'quantity' => 1 ) ), 'price' => 33.25, 'currency' => 'TRY', 'return' => 'https://www.mavipos.com/api/v2/payment' ); $actual_link = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? "https" : "http") . "://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]"; $ch = curl_init('https://www.mavipos.com/api/v2/createToken'); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']); curl_setopt($ch, CURLOPT_REFERER, $actual_link); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Accept: application/json', 'Content-Type: application/json', 'Authorization: Bearer {Oluşturulan Bearer Hash Değeri}' ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($this->data)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_TIMEOUT, 90); $output = curl_exec($ch); $output = json_decode($output); curl_close($ch);

Test Ortam Sorgu Sonucu


Notice: Trying to get property 'responseCode' of non-object in /www/wwwroot/mavipos.com/classes/ParallaxFunctions/mavipos.php on line 96

Notice: Trying to get property 'responseCode' of non-object in /www/wwwroot/mavipos.com/classes/ParallaxFunctions/mavipos.php on line 97

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahtarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'customerName' => 'Mavipos Test', 'customerMail' => 'it@evkal.com', 'customerPhone' => '08505327580', 'cart' => array( array( 'name' => 'Entegrasyon Ücreti', 'price' => 10, 'quantity' => 1 ) ), 'price' => 10, 'currency' => 'TRY', 'return' => 'https://www.mavipos.com/geridonus' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
array( 'responseCode' => 00, 'responseMsg' => 'Başarılı!', 'sessionToken' => 'Oluşan Token', 'orderId' => 'Mavipos Sipariş Numarası' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Sepet Oluşturma

Token Oluşturma aşamasında gönderilen cart değerinin tanımlanması hakkında bilgi edinebilirsiniz.

İstek Örneği

PHPCurlPythonJavascriptJava
$examplecart = array( array( 'name' => 'Mavipos Entegrasyon Hizmeti', 'price' => 2.75, 'quantity' => 3 ), array( 'name' => 'Mavipos Ürün Hizmeti', 'price' => 10, 'quantity' => 1 ), array( 'name' => 'Kargo Ücreti', 'price' => 15, 'quantity' => 1 ) ); Yukarıda gönderilen örnek cart değeri doğrultusunda price değeri 33.25 olmalıdır. Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Ödeme Formu

Token Oluşturma aşaması ile oluşturulmuş siparişe özel tokeni kullanarak ödeme formunu alabilirsiniz. Ödeme formu iFrame yapısında gönderilmektedir ve her tasarıma uyum sağlayan responsive yapıya sahiptir. Yapılan ödeme sonrası işlemin Mavipos tarafında başarılı olup olmadığını İşlem Doğrulama ile mutlaka kontrol edin. 30 dakika içerisinde kontrol edilmeyen işlemler otomatik kontrole kapatılır.

Test Ortamı Uç Noktası

POST https://www.mavipos.com/api/paymentForm

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/paymentForm

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahtarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez. sessionToken Gerekli Token Oluşturma aşaması ile oluşturulan sessionToken değeri bu alanda gönderilmelidir.

Test Ortam Sorgu Sonucu


Notice: Trying to get property 'responseCode' of non-object in /www/wwwroot/mavipos.com/view/themes/default/api/pages/8_payment_form.php on line 34

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahtarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'sessionToken' => 'Oluşturulan sessionToken' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
array( 'responseCode' => 00, 'responseMsg' => 'Başarılı!', 'iframeData' => 'Ödeme Formu Kodu' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

İşlem Doğrulama

Yapılan ödeme sonrası işlemin Mavipos tarafında başarılı olup olmadığını mutlaka kontrol edin. Sipariş orderId bilgisi ile işlemin Mavipos tarafındaki Sale durumunu teyit ederek başarılı durumuna aktarın. Her sipariş için sadece 1 defa İşlem Doğrulama sorgusu gönderebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/checkPayment

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez. orderId Gerekli Sorgulanacak işleme ait Mavipos sipariş numarası bu alanda gönderilmelidir.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'orderId' => 'Mavipos Sipariş Numarası' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object( 'responseCode' => 00, 'responseMsg' => 'Başarılı!', 'orderDetail' => array( 'orderStatus' => 'Sale', // Refund - Fail - Partial 'refundDate' => '2020-05-29 17:27:57', // Refund 'refundPaymentDay' => 'Ödemenin Kesileceği Gün', // Refund 'orderDate' => '2020-05-29 17:27:57', 'orderCurrency' => 'İşlem Kuru', 'orderPrice' => 'İşlem Tutarı', 'orderEarn' => 'Mağaza Ödenecek Tutar', 'orderCommissionRate' => 'Komisyon Oranı', 'orderCommission' => 'Komisyon Tutarı', // Sale - Refund 'orderPaymentDay' => 'Ödemenin Ödeneceği Gün', // Sale 'orderMainCurrency' => 'İşlemin Ana Kuru', // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. 'orderMainPrice' => 'İşlemin Ana Tutarı', // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. 'orderExchange' => 'İşlem Kuru' // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. ), 'customerDetail' => array( 'customerName' => 'Mavipos Test', 'customerMail' => 'it@evkal.com', 'customerPhone' => '08503057717, 'customerIp' => '11.222.333.4444' ), 'cargoDetail' => array( // Kargo kodu oluşturulmuşsa görünür. 'cargoCode' => 'Kargo Kodu', 'cargoCompany' => 'it@evkal.com', 'customerCountry' => '08503057717, 'customerCity' => '11.222.333.4444', 'customerTown' => '11.222.333.4444', 'customerAddress' => '11.222.333.4444' ), 'failDetail' => array( // İşlem Fail ise görünür. 'responseMsg' => 'Kargo Kodu' ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

İşlem Sorgulama

Sipariş orderId bilgisi ile işlemin detaylarını sorgulayabilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/paymentDetail

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez. orderId Gerekli Sorgulanacak işleme ait Mavipos sipariş numarası bu alanda gönderilmelidir.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'orderId' => 'Mavipos Sipariş Numarası' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object( 'responseCode' => 00, 'responseMsg' => 'Başarılı!', 'orderDetail' => array( 'orderStatus' => 'Sale', // Refund - Fail - Partial 'refundDate' => '2020-05-29 17:27:57', // Refund 'refundPaymentDay' => 'Ödemenin Kesileceği Gün', // Refund 'orderDate' => '2020-05-29 17:27:57', 'orderCurrency' => 'İşlem Kuru', 'orderPrice' => 'İşlem Tutarı', 'orderEarn' => 'Mağaza Ödenecek Tutar', 'orderCommissionRate' => 'Komisyon Oranı', 'orderCommission' => 'Komisyon Tutarı', // Sale - Refund 'orderPaymentDay' => 'Ödemenin Ödeneceği Gün', // Sale 'orderMainCurrency' => 'İşlemin Ana Kuru', // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. 'orderMainPrice' => 'İşlemin Ana Tutarı', // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. 'orderExchange' => 'İşlem Kuru' // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. ), 'customerDetail' => array( 'customerName' => 'Mavipos Test', 'customerMail' => 'it@evkal.com', 'customerPhone' => '08503057717, 'customerIp' => '11.222.333.4444' ), 'cargoDetail' => array( // Kargo kodu oluşturulmuşsa görünür. 'cargoCode' => 'Kargo Kodu', 'cargoCompany' => 'it@evkal.com', 'customerCountry' => '08503057717, 'customerCity' => '11.222.333.4444', 'customerTown' => '11.222.333.4444', 'customerAddress' => '11.222.333.4444' ), 'failDetail' => array( // İşlem Fail ise görünür. 'responseMsg' => 'Kargo Kodu' ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Kur Sorgulama

Sipariş orderId bilgisi ile işlemin detaylarını sorgulayabilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/currencyDetail

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez. orderId Gerekli Sorgulanacak işleme ait Mavipos sipariş numarası bu alanda gönderilmelidir.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'orderId' => 'Mavipos Sipariş Numarası' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object( 'responseCode' => 00, 'responseMsg' => 'Başarılı!', 'orderDetail' => array( 'orderStatus' => 'Sale', // Refund - Fail - Partial 'refundDate' => '2020-05-29 17:27:57', // Refund 'refundPaymentDay' => 'Ödemenin Kesileceği Gün', // Refund 'orderDate' => '2020-05-29 17:27:57', 'orderCurrency' => 'İşlem Kuru', 'orderPrice' => 'İşlem Tutarı', 'orderEarn' => 'Mağaza Ödenecek Tutar', 'orderCommissionRate' => 'Komisyon Oranı', 'orderCommission' => 'Komisyon Tutarı', // Sale - Refund 'orderPaymentDay' => 'Ödemenin Ödeneceği Gün', // Sale 'orderMainCurrency' => 'İşlemin Ana Kuru', // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. 'orderMainPrice' => 'İşlemin Ana Tutarı', // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. 'orderExchange' => 'İşlem Kuru' // İşlem kuru ile hesap kuru uyuşmadığında gönderilir. ), 'customerDetail' => array( 'customerName' => 'Mavipos Test', 'customerMail' => 'it@evkal.com', 'customerPhone' => '08503057717, 'customerIp' => '11.222.333.4444' ), 'cargoDetail' => array( // Kargo kodu oluşturulmuşsa görünür. 'cargoCode' => 'Kargo Kodu', 'cargoCompany' => 'it@evkal.com', 'customerCountry' => '08503057717, 'customerCity' => '11.222.333.4444', 'customerTown' => '11.222.333.4444', 'customerAddress' => '11.222.333.4444' ), 'failDetail' => array( // İşlem Fail ise görünür. 'responseMsg' => 'Kargo Kodu' ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Taksit Sorgulama

Mavipos hesabınıza tanımlı taksit ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/installmentDetail

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object( [responseCode] => 00 [responseMsg] => Başarılı! [installmentData] => Array ( [0] => stdClass Object ( [installmentCount] => 2 [installmentRate] => 7.99 ) [1] => stdClass Object ( [installmentCount] => 3 [installmentRate] => 8.99 ) [2] => stdClass Object ( [installmentCount] => 4 [installmentRate] => 9.99 ) [3] => stdClass Object ( [installmentCount] => 5 [installmentRate] => 10.99 ) [4] => stdClass Object ( [installmentCount] => 6 [installmentRate] => 11.99 ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Komisyon Sorgulama

Mavipos hesabınıza tanımlı ürün ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/v2/getCommission

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [commissionData] => stdClass Object ( [yurtici] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 2.11 [commissionVatExcluded] => 1.79 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 2.49 [commissionVatExcluded] => 2.11 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 2.79 [commissionVatExcluded] => 2.36 ) ) [yurtdisi] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 3.49 [commissionVatExcluded] => 2.96 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 3.99 [commissionVatExcluded] => 3.38 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 4.49 [commissionVatExcluded] => 3.81 ) ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Komisyon Sorgulama

Mavipos hesabınıza tanımlı ürün ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/v2/getCommission

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [commissionData] => stdClass Object ( [yurtici] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 2.11 [commissionVatExcluded] => 1.79 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 2.49 [commissionVatExcluded] => 2.11 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 2.79 [commissionVatExcluded] => 2.36 ) ) [yurtdisi] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 3.49 [commissionVatExcluded] => 2.96 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 3.99 [commissionVatExcluded] => 3.38 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 4.49 [commissionVatExcluded] => 3.81 ) ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Komisyon Sorgulama

Mavipos hesabınıza tanımlı ürün ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/v2/getCommission

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [commissionData] => stdClass Object ( [yurtici] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 2.11 [commissionVatExcluded] => 1.79 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 2.49 [commissionVatExcluded] => 2.11 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 2.79 [commissionVatExcluded] => 2.36 ) ) [yurtdisi] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 3.49 [commissionVatExcluded] => 2.96 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 3.99 [commissionVatExcluded] => 3.38 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 4.49 [commissionVatExcluded] => 3.81 ) ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Komisyon Sorgulama

Mavipos hesabınıza tanımlı ürün ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/v2/getCommission

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [commissionData] => stdClass Object ( [yurtici] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 2.11 [commissionVatExcluded] => 1.79 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 2.49 [commissionVatExcluded] => 2.11 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 2.79 [commissionVatExcluded] => 2.36 ) ) [yurtdisi] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 3.49 [commissionVatExcluded] => 2.96 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 3.99 [commissionVatExcluded] => 3.38 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 4.49 [commissionVatExcluded] => 3.81 ) ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Komisyon Sorgulama

Mavipos hesabınıza tanımlı ürün ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/v2/getCommission

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [commissionData] => stdClass Object ( [yurtici] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 2.11 [commissionVatExcluded] => 1.79 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 2.49 [commissionVatExcluded] => 2.11 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 2.79 [commissionVatExcluded] => 2.36 ) ) [yurtdisi] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 3.49 [commissionVatExcluded] => 2.96 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 3.99 [commissionVatExcluded] => 3.38 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 4.49 [commissionVatExcluded] => 3.81 ) ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Komisyon Sorgulama

Mavipos hesabınıza tanımlı ürün ve komisyon bilgileri hakkında bilgi edinebilirsiniz.

Canlı Ortam Uç Noktası

POST https://www.mavipos.com/api/v2/getCommission

Parametreler

merchant Gerekli API Bilgi sayfası üzerinden Satıcı Anahatarı bilginize erişebilirsiniz. apikey Gerekli API Bilgi sayfası üzerinden API Anahtarı bilginize erişebilirsiniz. secret Gerekli API Bilgi sayfası üzerinden Gizli Anahtar bilginize erişebilirsiniz. salt Gerekli Salt Oluşturma sayfası üzerinden örnek salt oluşturma methoduna erişebilirsiniz. Salt değeri oturuma özel benzersiz olarak tarafınızdan belirlenebilecek bir değerdir. Sabit gönderilebilir fakat sabit gönderilmesi önerilmez.

İstek Örneği

PHPCurlPythonJavascriptJava
array( 'merchant' => 'Satıcı Anahatarı', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri' ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.

Cevap Örneği

PHP Curl Python Javascript Java
stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [commissionData] => stdClass Object ( [yurtici] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 2.11 [commissionVatExcluded] => 1.79 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 2.49 [commissionVatExcluded] => 2.11 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 2.79 [commissionVatExcluded] => 2.36 ) ) [yurtdisi] => stdClass Object ( [safeself] => stdClass Object ( [commissionName] => Safe/Self Komisyon Oranı [commissionVatIncluded] => 3.49 [commissionVatExcluded] => 2.96 ) [pure] => stdClass Object ( [commissionName] => Pure Komisyon Oranı [commissionVatIncluded] => 3.99 [commissionVatExcluded] => 3.38 ) [api] => stdClass Object ( [commissionName] => Sanal Pos Komisyon Oranı [commissionVatIncluded] => 4.49 [commissionVatExcluded] => 3.81 ) ) ) ) Curl örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Python örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Javascript örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin. Java örnek kodları henüz hazır değil. Lütfen daha sonra tekrar kontrol edin.
/**$merchantid = 'MAVITEST'.rand(11111111,99999999); $name = 'MAVICUSTOMERTEST'.rand(11111111,99999999); $items = array( array( 'code' => $merchantid, 'name' => $merchantid, 'description' => $merchantid, 'quantity' => 1, 'amount' => 150000, 'sellerId' => 'MV1234', 'sellerCommissionAmount' => number_format(150000*(3.5/100), 2, '.', '') ) ); $data = [ 'AMOUNT' => '11.21', 'SESSIONTYPE' => 'PAYMENTSESSION', 'MERCHANTPAYMENTID' => $merchantid, 'CURRENCY' => 'TRY', 'AMOUNT' => 150000, 'CUSTOMER' => 'MAVICUSTOMERTEST1234', 'CUSTOMEREMAIL' => 'MAVICUSTOMERTEST'.rand(11111111,99999999).'@email.com', 'CUSTOMERNAME' => $name, 'CUSTOMERPHONE' => rand(11111111,99999999), 'ORDERITEMS' => urlencode(json_encode($items)), 'TOTALSELLERCOMMISSIONAMOUNT' => number_format(150000*(3.5/100), 2, '.', ''), ]; $response = $evkal->paratika->sessionToken($data); print_r($evkal->paratika->output); $card = [ 'name' => $name, 'number' => '4355084355084358', 'month' => '12', 'year' => '2030', 'cvv' => '000' ]; echo $evkal->paratika->paymentForm($evkal->paratika->output->sessionToken, $card, 'preauth');**/