Shopinext: Sanal POS API V2 Dökümantasyon

Başlangıç

Shopinext bu dökümanı özel geliştirilmiş sistemlerin ödeme hizmetini kullanabilmesi için geliştirmeyi yapan teknik personel için hazırlamıştır.

Misyon & Vizyon

Shopinext olarak yenilikçi bir iş modeli ile, online satış süreçlerinde hem alıcılar hem de mağaza sahipleri için sorun teşkil eden komisyon ve kargo bedeli gibi etkenlerin sürece olan etkisini minimum seviyeye düşürmeyi hedefliyoruz.

Markamızı ulusal ve uluslararası pazarda büyüterek, Shopinext’i elektronik ticaret sektöründe güvenilir ve itibarlı bir konuma taşımak istiyoruz. 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

Markamızı ulusal ve uluslararası pazarda büyüterek, Shopinext’i elektronik ticaret sektöründe güvenilir ve itibarlı bir konuma taşımak istiyoruz. 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.

Desteklenen Diller

API desteği, HTTP Post yöntemlerini uygulayan tüm platformları ve dilleri desteklemektedir.

Sorgu Yanıtları

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

Önemli Değerler


snid: 'Shopinext ID' // 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.

Hata Kodları

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

SN0001 Api Anahtarı veya Gizli Anahtar hatalı, lütfen kontrol edin. SN0002 Shopinext hesabınız aktif değil, lütfen Shopinext yönetimi ile irtibata geçin. SN0003 Shopinext ID bilgisi hatalı, lütfen kontrol edin. SN0004 Sanal posunuz aktif değil, lütfen Shopinext paneli üzerinden kontrol edin. SN0005 Yetkisiz url üzerinden işlem yapılamaz, lütfen kontrol edin. SN0006 Bearer yetki kodu bulunamadı. SN0007 Bearer yetki kodu doğrulanamadı. SN0008 Gönderilen tutar ile sepetteki ürünlerin tutarı eşleşmemektedir, lütfen kontrol edin. SN0009 İşlem Shopinext tarafına kaydedilemedi, lütfen Shopinext yönetimi ile irtibata geçin. SN0010 Eksik veya hatalı alan gönderdiniz, lütfen kontrol edin. SN0011 Bu tokene ait işlem bulunamadı, lütfen kontrol edin. SN0012 İşlem doğrulama kodu hatalı, lütfen kontrol edin. SN0013 İşlem doğrulama kodu doğrulanamadı, lütfen tekrar deneyin. SN0014 Seçilen taksit mağaza taksit limitinden daha fazla, lütfen Shopinext yönetimi ile irtibata geçin. SN0015 Seçilen taksit bulunamadı, lütfen Shopinext yönetimi ile irtibata geçin. SN0016 Mağazanın yurtdışı yetkisi bulunmamaktadır, lütfen Shopinext yönetimi ile irtibata geçin. SN0017 Mağazanın özel kart yetkisi bulunmamaktadır, lütfen Shopinext yönetimi ile irtibata geçin. SN0018 Son kullanma tarihi hatalı, lütfen kontrol edin. SN0019 Mağazanın ödeme limiti bu işlem için yeterli değildir, lütfen mağaza ile irtibata geçin. SN0020 Ödeme işleme alınırken sorun oluştu. Lütfen daha sonra tekrar deneyin. SN0021 Ödeme güvenlik nedeniyle başarısız sonuçlandı, lütfen işlemi tekrar deneyin. SN0022 İşlem bulunamadı, lütfen tekrar deneyin. SN0023 Banka tarafından gönderilen hata mesajı. SN0024 [siparis_no] numaralı işlem bulunamadı. Lütfen kontrol edin. SN0025 [siparis_no] numaralı işlemin tutarı iade tutarından düşüktür, bu durum kur farkından yaşanıyor olabilir. Lütfen Shopinext ile iletişime geçin. İade edebileceğiniz tutar: [tutar] [kur] İade edilmek istenen tutar: [tutar] [kur] SN0026 Hesabınızın iade için yeterli bakiyesi bulunmamaktadır. Lütfen Shopinext ile iletişime geçin. İade edebileceğiniz tutar: [tutar] [kur] İade edilmek istenen tutar: [tutar] [kur] SN0027 [siparis_no] numaralı işlem iade edilemedi, lütfen tekrar deneyin. Sorun devam ederse Shopinext ile iletişime geçin. Hata: [hata_mesaji] SN0028 [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


snid: 'Shopinext ID' // 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 Shopinext 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

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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


snid: 'Shopinext ID' // 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

$snid = 'Shopinext ID gelecek';
$apikey = 'API Anahtarı gelecek';
$secret = 'Gizli Anahtar gelecek';
$salt = 'Oluşturulmuş salt değeri';

$pass = $apikey.$secret.$snid;
$hash = base64_encode(hash_pbkdf2("sha256", md5($pass), $salt, 20000));

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

Zorunlu Parametreler

Shopinext tarafına göndereceğiniz sorgularda zorunlu olarak gönderilmesi gereken HTTP Header Parametreleri bulunmaktadır.

Gerekli Parametreler

X-Forwarded-For Gerekli Bu alanda kullanıcınızın IP adresini göndermelisiniz. REMOTE_ADDR Gerekli Bu alanda kullanıcınızın IP adresini göndermelisiniz. HTTP_X_FORWARDED_FOR Gerekli Bu alanda kullanıcınızın IP adresini göndermelisiniz. Authorization Gerekli Bearer Oluşturma sayfası üzerinden örnek bearer oluşturma methoduna erişebilirsiniz. Bearer değeri oturuma özel benzersiz olarak oluşturulmaktadır. User-Agent Gerekli Bu alanda kullanıcınızın User Agent (Kullanıcı Aracısı) değerini göndermelisiniz. Referer Gerekli Bu alanda sorgunun gönderildiği tam adresi göndermelisiniz.

Örnekler

PHPCurlPythonJavascriptJava


$headers = [
  'Accept: application/json',
  'Content-Type: application/json',
  'Authorization: Bearer {$hash}',
  'X-Forwarded-For: 11.111.11.11',
  'REMOTE_ADDR: 11.111.11.11',
  'HTTP_X_FORWARDED_FOR: 11.111.11.11'
];

$actual_link = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? "https" : "http") . "://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";

$ch = curl_init($this->app_url);
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,  $headers);curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 90);
$output = curl_exec($ch);
$output = json_decode($output);
curl_close($ch);
return $output;

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

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.shopinext.com/api/t2/createToken

Canlı Ortam Uç Noktası

POST https://www.shopinext.com/api/v2/createToken

Parametreler

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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( 'snid' => 'Shopinext ID', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'customerName' => 'Shopinext Test', 'customerMail' => 'it@shopinext.com', 'customerPhone' => '08503057717', 'cart' => array( array( 'name' => 'Shopinext Entegrasyon Hizmeti', 'price' => 2.75, 'quantity' => 3 ), array( 'name' => 'Shopinext Ürün Hizmeti', 'price' => 10, 'quantity' => 1 ), array( 'name' => 'Kargo Ücreti', 'price' => 15, 'quantity' => 1 ) ), 'price' => 33.25, 'currency' => 'TRY', 'return' => 'https://www.shopinext.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.shopinext.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

stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [sessionToken] => BG2Q9XQL45HURZY0XZ0WQAYAXDVJDKYP5CR1BGW0OK0NM1VK5P [orderId] => SNT52FG6J6QIX )

İstek Örneği


PHPCurlPythonJavascriptJava

array(
  'snid' => 'Shopinext ID',
  'apikey' => 'Api Anahtarı',
  'secret' => 'Secret Anahtarı',
  'salt' => 'Oluşturulan Salt Değeri',
  'customerName' => 'Shopinext Test',
  'customerMail' => 'it@shopinext.com',
  'customerPhone' => '08503057717',
  'cart' => array(
    array(
      'name' => 'Entegrasyon Ücreti',
      'price' => 10,
      'quantity' => 1
    )
  ),
  'price' => 10,
  'currency' => 'TRY',
  'return' => 'https://www.shopinext.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' => 'Shopinext 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' => 'Shopinext Entegrasyon Hizmeti',
    'price' => 2.75,
    'quantity' => 3
  ),
  array(
    'name' => 'Shopinext Ü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.

Kargo Kodu Oluşturma

Token Oluşturma aşamasında gönderilen shipCode değerinin tanımlanması hakkında bilgi edinebilirsiniz. Kargo kodu sistemi sipariş sonrası hesabınızda tanımladığınız kargo firması üzerinden kargo kodu oluşturarak dönüş yapmasını sağlar.

Oluşturulan kargo kodu ödeme sonrası cargoCode değeri ile geri dönmektedir.

Parametreler

shipCode Gerekli true yada false olarak gönderilebilir. True gönderildiğinde kargo kodu diğer parametreler ile oluşturularak gönderilir. customerCountry Gerekli Ülke kodu gönderilmelidir. Eğer ülke kodu Shopinext sisteminde bulunamazsa ödeme aşamasında eksik alanların seçimi yapılır. Örneğin Azerbaijan => AZ, Australia => AU vb. customerCity Gerekli Şehir adı tam ve doğru şekilde gönderilmelidir. Eğer şehir adı Shopinext sisteminde bulunamazsa ödeme aşamasında eksik alanların seçimi yapılır. customerTown Gerekli İlçe adı tam ve doğru şekilde gönderilmelidir. Eğer ilçe adı Shopinext sisteminde bulunamazsa ödeme aşamasında eksik alanların seçimi yapılır. customerAddress Gerekli Adres bilgisi tam ve doğru şekilde gönderilmelidir. Ödeme aşamasında adres düzenlenebilir olacaktır.

Test Ortam Kargo Sistemi Örneği

$data = array( 'snid' => 'Shopinext ID', 'apikey' => 'Api Anahtarı', 'secret' => 'Secret Anahtarı', 'salt' => 'Oluşturulan Salt Değeri', 'customerName' => 'Shopinext Test', 'customerMail' => 'it@shopinext.com', 'customerPhone' => '08503057717', 'cart' => array( array( 'name' => 'Shopinext Entegrasyon Hizmeti', 'price' => 2.75, 'quantity' => 3 ), array( 'name' => 'Shopinext Ürün Hizmeti', 'price' => 10, 'quantity' => 1 ), array( 'name' => 'Kargo Ücreti', 'price' => 15, 'quantity' => 1 ) ), 'price' => 33.25, 'currency' => 'TRY', 'shipCode' => true, 'customerCountry' => 'TR', 'customerCity' => 'İstanbul', 'customerTown' => 'Maltepe', 'customerAddress' => 'İdealtepe, Dik Sk. 13/2, 34841', 'return' => 'https://www.shopinext.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.shopinext.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 Kargo Sistemi Sonucu

stdClass Object ( [responseCode] => 00 [responseMsg] => Başarılı! [sessionToken] => ML6ABCCMUBP55E9F5O22RPTKKLU5RZKA6TUGURMHAJGCZIVOO8 [orderId] => SNTD3R20DUL3Z )

İstek Örneği


PHPCurlPythonJavascriptJava


Aşağıda belirtilen değerler Token Oluşturma aşamasında kullanılan parametrelerin devamıdır. Aynı dizi içerisine tanımlamaya devam etmeniz gerekir.
'shipCode' => true,
'customerCountry' => 'TR',
'customerCity' => 'İstanbul',
'customerTown' => 'Maltepe',
'customerAddress' => 'İdealtepe, Dik Sk. 13/2, 34841'


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 Shopinext 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.shopinext.com/api/t2/getPaymentForm

Canlı Ortam Uç Noktası

POST https://www.shopinext.com/api/v2/getPaymentForm

Parametreler

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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

İstek Örneği


PHPCurlPythonJavascriptJava

array(
  'snid' => 'Shopinext ID',
  '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 Shopinext tarafında başarılı olup olmadığını mutlaka kontrol edin. Sipariş orderId bilgisi ile işlemin Shopinext 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.shopinext.com/api/v2/checkOrder

Parametreler

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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 Shopinext sipariş numarası bu alanda gönderilmelidir.

İstek Örneği


PHPCurlPythonJavascriptJava

array(
  'snid' => 'Shopinext ID',
  'apikey' => 'Api Anahtarı',
  'secret' => 'Secret Anahtarı',
  'salt' => 'Oluşturulan Salt Değeri',
  'orderId' => 'Shopinext 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' => 'Shopinext Test',
    'customerMail' => 'it@shopinext.com',
    'customerPhone' => '08503057717,
    'customerIp' => '11.222.333.4444'
  ),
  'cargoDetail' => array( // Kargo kodu oluşturulmuşsa görünür.
    'cargoCode' => 'Kargo Kodu',
    'cargoCompany' => 'it@shopinext.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.shopinext.com/api/v2/orderDetail

Parametreler

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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 Shopinext sipariş numarası bu alanda gönderilmelidir.

İstek Örneği


PHPCurlPythonJavascriptJava

array(
  'snid' => 'Shopinext ID',
  'apikey' => 'Api Anahtarı',
  'secret' => 'Secret Anahtarı',
  'salt' => 'Oluşturulan Salt Değeri',
  'orderId' => 'Shopinext 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' => 'Shopinext Test',
    'customerMail' => 'it@shopinext.com',
    'customerPhone' => '08503057717,
    'customerIp' => '11.222.333.4444'
  ),
  'cargoDetail' => array( // Kargo kodu oluşturulmuşsa görünür.
    'cargoCode' => 'Kargo Kodu',
    'cargoCompany' => 'it@shopinext.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

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

Canlı Ortam Uç Noktası

POST https://www.shopinext.com/api/v2/getInstallment

Parametreler

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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(
  'snid' => 'Shopinext ID',
  '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

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

Canlı Ortam Uç Noktası

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

Parametreler

snid Gerekli API Bilgi sayfası üzerinden Shopinext ID 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(
  'snid' => 'Shopinext ID',
  '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.