Parakolay API, kullanıcıların finansal işlemlerini güvenli ve hızlı bir şekilde gerçekleştirmeleri için tasarlanmıştır. API, ödeme, 3D Secure işlemleri, iade, iptal ve puan sorgulama gibi temel fonksiyonlar sunar. Bu doküman, Parakolay API'nin işleyişini ve kullanımını detaylı bir şekilde açıklamaktadır.
\nTest Ortamı URL: https://api-test.parakolay.com
Üretim Ortamı URL: https://api.parakolay.com
Parakolay API’yi hızlı ve verimli şekilde entegre edebilmeniz için çeşitli dillerde resmi SDK’ler sağlıyoruz. Bu SDK’ler, kimlik doğrulama, ödeme işlemleri, iade, iptal, 3D Secure ve kart yönetimi gibi temel işlevleri kolayca kullanmanıza olanak tanır.
\nAşağıdaki GitHub bağlantılarından ihtiyacınız olan SDK’yi seçebilir ve projenize dahil edebilirsiniz.
\nHızlı Başlangıç için her SDK’nin README dosyasını inceleyebilir, temel yapılandırma ve API çağrılarını nasıl gerçekleştireceğinizi öğrenebilirsiniz.
\nSDK’ları geliştirmek veya hata bildirmek isterseniz, Pull Request oluşturabilir veya GitHub Issues üzerinden geri bildirimde bulunabilirsiniz.
\nParakolay API’lerini kullanarak e-ticaret sitenize kolayca sanal POS entegrasyonu yapabilmeniz için, popüler açık kaynak içerik yönetim sistemleri (CMS) için hazır eklentiler geliştirdik. Aşağıdaki bağlantılardan eklentileri indirip kullanmaya başlayabilirsiniz.
\nWordPress yönetim panelinize giriş yapın.
\nEklentiler → Yeni Ekle bölümüne gidin.
\nEklenti Yükle butonuyla .zip dosyasını seçin ve yükleyin.
Eklentiyi etkinleştirin.
\nParakolay API anahtarınızı ayarlar sayfasından girin.
\n📦 v3 İndir (.zip): parakolay-opencart-3.ocmod.zip
\n📦 v4 İndir (.zip): parakolay-opencart-4.ocmod.zip
\nOpenCart yönetim panelinize giriş yapın.
\nExtensions → Installer menüsünden .zip dosyasını yükleyin.
Extensions → Modifications bölümünden değişiklikleri etkinleştirin.
\nGerekli ayarları yaptıktan sonra ödeme sayfasında Parakolay seçeneği görünür olacaktır.
\n\n\nℹ️ Her eklenti, temel Parakolay ödeme akışlarını desteklemektedir. Gelişmiş kullanım ve özelleştirme için bu sayfa üzerindeki dokümantasyonları inceleyebilirsiniz.
\n
API’ye erişim için her çağrı sırasında bir public key, nonce ve signature gereklidir.
\nHer API çağrısında, bu değerlerin HTTP header veya body ile gönderilmesi gereklidir.
\nPublic Key: Üye iş yerinin açık anahtarı.
\nNonce: Zaman damgası.
\nSignature: SHA256 algoritmasıyla üretilen imza.
\nParakolay API kullanımı için üye iş yerlerine özel bir Public Key (Mağaza Açık Anahtarı) ve Private Key (Mağaza Gizli Anahtarı) sağlanır. Bu bilgiler, üye iş yerinin kimlik doğrulama sürecinde kullanılır.
\nPublic Key ve Private Key Nereden Alınır?
\nBu bilgiler Merchant Paneli'nin \"Bilgilerim\" sekmesinde yer alır.
\nPrivate Key, yalnızca üye iş yerine özeldir ve paylaşılmamalıdır. Hiçbir API isteğinde bu değer açıkça talep edilmez.
\nNonce, API güvenliğini sağlamak için kullanılan benzersiz bir sayı veya milisaniye bazlı zaman damgasıdır. Her istek için farklı bir nonce değeri üretilmeli ve sunucuya iletilmelidir. Böylece, tekrar oynatma (replay attack) saldırıları önlenir.
\nKullanımı:
\nAPI çağrılarında zaman damgası olarak kullanılır.
\nSignature (İmza) hesaplamasında bir parametre olarak dahil edilir.
\nAynı isteğin tekrar gönderilmesini engeller.
\nConversationID, API çağrısının benzersiz kimliğini temsil eder, Üye İşyeri Sipariş Numarasıdır. Üye iş yerinin, yaptığı her API çağrısını eşleştirmek için kullanılır.
\nKullanımı:
\nAPI isteği ile birlikte gönderilir.
\nAPI yanıtında döndürülerek, istek ve yanıtın eşleşmesi sağlanır.
\nGenellikle sipariş numarası olarak kullanılır.
\nSignature, API çağrılarında güvenliği sağlamak ve isteklerin doğruluğunu kontrol etmek için kullanılan HMAC-SHA256 ile üretilmiş bir mesajdır. Bu imza, nonce, API anahtarları ve işlem verilerinin hashlenmesiyle oluşturulur ve her isteğe eklenmelidir.
\nTüm API isteklerinde aşağıdaki değerler header alanında gönderilmelidir:
\n‼️ Bu veriler olmadan yapılan API çağrıları doğrulanamaz ve işleme alınmaz.
\nSignature oluşturulurken şu adımlar izlenmelidir:
\n1️⃣ Public Key ve Nonce birleştirilerek ilk veri seti oluşturulur.
2️⃣ Bu veri, üye işyerine sağlanan Private Key ile HMAC-SHA256 algoritması kullanılarak hashlenir → 1. Seviye güvenlik verisi elde edilir.
3️⃣ Bu aşamada elde edilen veri, Private Key, ConversationId ve Nonce ile tekrar hashlenerek Signature üretilir.
4️⃣ Signature, her API isteğinde header içinde sunucuya gönderilir.
public static string GenerateSignature(string apiKey, string apiSecret, long nonce, string conversationId)\n {\n var message = $\"{apiKey}{nonce}\";\n var securityData = Generate(message, apiSecret);\n var secondMessage = $\"{apiSecret}{conversationId}{nonce}{securityData}\";\n var signature = Generate(secondMessage, apiSecret);\n return signature;\n }\n public static string Generate(string message, string key)\n {\n var keyBytes = Convert.FromBase64String(key);\n var messageBytes = Encoding.UTF8.GetBytes(message);\n var hmacsha256 = new HMACSHA256(keyBytes);\n var hashmessage = hmacsha256.ComputeHash(messageBytes);\n return Convert.ToBase64String(hashmessage);\n }\n\n static generateSignature(apiKey, apiSecret, nonce, conversationId) {\n const message = `${apiKey}${nonce}`;\n const securityData = this.generate(message, apiSecret);\n const secondMessage = `${apiSecret}${conversationId}${nonce}${securityData}`;\n const signature = this.generate(secondMessage, apiSecret);\n return signature;\n }\n static generate(message, key) {\n const keyBuffer = Buffer.from(key, 'base64');\n const messageBuffer = Buffer.from(message, 'utf-8');\n const hmac = crypto.createHmac('sha256', keyBuffer);\n hmac.update(messageBuffer);\n return hmac.digest('base64');\n }\n\nfunction generateSignature($apiKey, $apiSecret, $nonce, $conversationId)\n{\n $message = $apiKey . $nonce;\n $securityData = generate($message, $apiSecret);\n $secondMessage = $apiSecret . $conversationId . $nonce . $securityData;\n $signature = generate($secondMessage, $apiSecret);\n return $signature;\n}\nfunction generate($message, $key)\n{\n $hash = hash_hmac('sha256', $message, base64_decode($key), true);\n return base64_encode($hash);\n}\n\nString generateSignature(\n String apiKey, String apiSecret, String nonce, String conversationId) {\n var message = apiKey + nonce;\n var securityData = generate(message, apiSecret);\n var secondMessage = apiSecret + conversationId + nonce + securityData;\n var signature = generate(secondMessage, apiSecret);\n return signature;\n}\nString generate(String message, String key) {\n var keyBytes = base64Decode(key);\n var hmacSha256 = Hmac(sha256, keyBytes);\n var digest = hmacSha256.convert(utf8.encode(message));\n return base64Encode(digest.bytes);\n}\n\nHata Mesajı: \"Invalid Signature\"
\nHata Mesajı: \"Authentication Failed\"
\nHata Mesajı: \"Endpoint Not Found\"
\nhttps://api-test.parakolay.com).1️⃣ v1/tokens – Kart Token Oluşturma
\nKullanıcının kart bilgileriyle kart token’ı oluşturulur.
\nToken, ödeme işlemlerinde kart bilgilerini taşımadan işlem yapmayı sağlar.
\n2️⃣ v1/threeds/getthreedsession – 3D Secure Oturumu Başlatma
\nKullanıcı için 3D Secure oturumu açılır.
\nBankanın yönlendireceği doğrulama ekranı için gerekli bilgiler oluşturulur.
\n3️⃣ v1/threeds/init3ds – 3D Secure İşlemi Başlatma
\nKullanıcının yönlendirileceği 3D doğrulama html formu oluşturulur.
\nKullanıcı bu html aracılığıyla banka tarafındaki ekranlara yönlendirilir.
\n4️⃣ Kullanıcı 3DS Formunda İşlemi Onaylar
\nKullanıcı, bankanın doğrulama sayfasına yönlendirilir.
\nKullanıcı şifresini girerek işlemi onaylar.
\n5️⃣ Callback URL ile 3D Sonuç Alınır
\nKullanıcı işlemi tamamladıktan sonra, üye işyerinin belirttiği Callback URL’ye döner.
\n‼️ Callback URL çağırılırken GET methodu ile istek gönderilecektir.
\n3D Secure sonucu, v1/threeds/getthreedsessionresult servisi ile kontrol edilir.
\n6️⃣ v1/Payments/provision Servisi ile Çekim Yapılır – Ödeme Tamamlama
\nProvision servisi çağrılarak ödeme tahsilatı gerçekleştirilir.
\nİşlem sonucu başarılı olursa, sipariş tamamlanır.
\n‼️ Provision servisi çağrılmayan işlemlerde kart sahibinden çekim gerçekleştirilmez.
\nParakolay API, her istekte işlem sonucunu dönen bir isSucceed parametresi ile doğrular. Eğer isSucceed değeri false ise, işlem sırasında bir hata oluşmuş demektir. Hata durumlarında, yanıt içinde errorCode ve errorMessage alanları detaylı bilgi verir.
Bazı durumlarda, Parakolay, banka veya ağ kaynaklı gecikmeler nedeniyle API yanıtını zamanında veremeyebilir.
Böyle bir senaryoda backend sisteminizde timeout yönetimi uygulamak önerilir.
📌 Önerilen Çözüm:
\nBelirsiz İşlemleri Yönetme*_İşlem beklenenden uzun sürüyorsa *_\\işlem durumunu sorgulamak için /v1/Payments/inquire servisini kullanın.
Otomatik İptal / İade Süreci****Yanıt alınamayan işlemleri backend’de takip edip, işlemi iptal veya iade etmek için ilgili servisi çağırabilirsiniz.
\nYönetici Paneli Üzerinden Kontrol
Belirsiz işlemleri API ile yönetmenin yanı sıra, *Merchant Paneli’nden de işlemlerin durumu manuel olarak kontrol edilebilir.__*
Herhangi bir sorun ya da teknik destek talebinizde aşağıdaki bilgilerden bizimle iletişime geçebilirsiniz:
\nKart numarası
\n"},{"key":"ExpireMonth","value":"01","type":"text","description":"Kartın son kullanma tarihi (ay)
\n"},{"key":"ExpireYear","value":"24","type":"text","description":"Kartın son kullanma tarihi (yıl)
\n"},{"key":"Cvv","value":"123","type":"text","description":"Kartın güvenlik kodu
\n"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı
\n"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası
\n"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri
\n"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri sipariş numarası
\n"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası
\n"},{"key":"CardHolderName","value":"John Doe","type":"text","description":"Kart sahibinin adı
\n"}]},"url":"https://api.parakolay.com/v1/Tokens","description":"Bu endpoint, kart bilgilerini içeren bir token oluşturmak için kullanılır. Token oluşturulduktan sonra finansal işlemlerde kullanılır. Kart bilgileri, güvenlik amacıyla form-data formatında gönderilir ve tokenlaştırılır.
\n","urlObject":{"path":["v1","Tokens"],"host":["https://api.parakolay.com"],"query":[],"variable":[]}},"response":[{"id":"e50d469e-123f-4346-b35d-e9414e8ccff9","name":"Successful","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"CardNumber","value":"1234123412341234","type":"text"},{"key":"ExpireMonth","value":"01","type":"text"},{"key":"ExpireYear","value":"24","type":"text"},{"key":"Cvv","value":"123","type":"text"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text"},{"key":"Nonce","value":"1738121552307","type":"text"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text"},{"key":"ConversationId","value":"ORD-1316678114","type":"text"},{"key":"MerchantNumber","value":"1100000001","type":"text"},{"key":"CardHolderName","value":"John Doe","type":"text"}]},"url":"https://api.parakolay.com/v1/Tokens"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"cardToken\": \"8vR+KNz6R3tRSSL3lWnK4azx//QGMyG+18SWsVvijpc=\",\n \"signature\": \"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=\",\n \"isSucceed\": true,\n \"errorCode\": null,\n \"errorMessage\": null,\n \"conversationId\": \"ORD-1316678114\"\n}"},{"id":"d6edf50f-0d13-45e8-8663-104a0a69a1e8","name":"Forbidden","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"CardNumber","value":"1234123412341234","type":"text"},{"key":"ExpireMonth","value":"01","type":"text"},{"key":"ExpireYear","value":"24","type":"text"},{"key":"Cvv","value":"123","type":"text"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text"},{"key":"Nonce","value":"1738121552307","type":"text"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text"},{"key":"ConversationId","value":"ORD-1316678114","type":"text"},{"key":"MerchantNumber","value":"1100000001","type":"text"},{"key":"CardHolderName","value":"John Doe","type":"text"}]},"url":"https://api.parakolay.com/v1/Tokens"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.3\",\n \"title\": \"Forbidden\",\n \"status\": 403,\n \"detail\": \"ForbiddenAccessException\"\n}"},{"id":"0a54ca83-d4fd-44ac-a160-03db33678086","name":"Signature Mismatch","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"CardNumber","value":"1234123412341234","type":"text"},{"key":"ExpireMonth","value":"01","type":"text"},{"key":"ExpireYear","value":"24","type":"text"},{"key":"Cvv","value":"123","type":"text"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text"},{"key":"Nonce","value":"1738121552307","type":"text"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text"},{"key":"ConversationId","value":"ORD-1316678114","type":"text"},{"key":"MerchantNumber","value":"1100000001","type":"text"},{"key":"CardHolderName","value":"John Doe","type":"text"}]},"url":"https://api.parakolay.com/v1/Tokens"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 16:59:50 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"cardToken\": null,\n \"signature\": null,\n \"isSucceed\": false,\n \"errorCode\": \"401\",\n \"errorMessage\": \"SignatureMismatch\",\n \"conversationId\": \"1316678114\"\n}"},{"id":"c7db2dda-fe0b-4f65-89c8-331c649a886f","name":"Nonce Expired","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"CardNumber","value":"1234123412341234","type":"text"},{"key":"ExpireMonth","value":"01","type":"text"},{"key":"ExpireYear","value":"24","type":"text"},{"key":"Cvv","value":"123","type":"text"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text"},{"key":"Nonce","value":"1738121552307","type":"text"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text"},{"key":"ConversationId","value":"ORD-1316678114","type":"text"},{"key":"MerchantNumber","value":"1100000001","type":"text"},{"key":"CardHolderName","value":"John Doe","type":"text"}]},"url":"https://api.parakolay.com/v1/Tokens"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 17:00:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"cardToken\": null,\n \"signature\": null,\n \"isSucceed\": false,\n \"errorCode\": \"401\",\n \"errorMessage\": \"HmacTimestampExpired\",\n \"conversationId\": \"1316678114\"\n}"},{"id":"8c35e7ee-ebd1-4c8e-825b-76df248dfaba","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"CardNumber","value":"1234123412341234","type":"text","description":"Kart numarası"},{"key":"ExpireMonth","value":"01","type":"text","description":"Kartın son kullanma tarihi (ay)"},{"key":"ExpireYear","value":"24","type":"text","description":"Kartın son kullanma tarihi (yıl)"},{"key":"Cvv","value":"123","type":"text","description":"Kartın güvenlik kodu"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri sipariş numarası"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası"},{"key":"CardHolderName","value":"John Doe","type":"text","description":"Kart sahibinin adı"}]},"url":"https://api.parakolay.com/v1/Tokens"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Value\": {\n \"Type\": \"https://tools.ietf.org/html/rfc7235#section-3.1\",\n \"Title\": \"Unauthorized\",\n \"Status\": 401,\n \"Detail\": \"Hmac Authentication Error\",\n \"Instance\": null,\n \"Extensions\": {}\n },\n \"Formatters\": [],\n \"ContentTypes\": [],\n \"DeclaredType\": null,\n \"StatusCode\": 401\n}"}],"_postman_id":"45605f6e-ebb0-4e3f-8e4c-3afa40a9fe85"},{"name":"Get Threed Session","event":[{"listen":"test","script":{"id":"bd7b1beb-2ae8-40b0-b540-2012b55540bc","exec":["var jsonData = JSON.parse(responseBody);\r","\r","pm.collectionVariables.set(\"threedSessionId\", jsonData.threeDSessionId);"],"type":"text/javascript","packages":{}}}],"id":"e103d74a-47e6-457c-af6e-0243777981b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"amount\":30,\r\n \"pointAmount\": 0,\r\n \"cardToken\": \"+oc6jxS0ABueLM+QuJnQFrZyV+B4HMHYiMx8yBH/Z90=\",\r\n \"currency\": \"TRY\",\r\n \"paymentType\": \"Auth\",\r\n \"installmentCount\": 1,\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/threeds/getthreedsession","description":"Bu endpoint, 3D Secure işlemleri için oturum bilgisi (threeDSessionId) oluşturmak amacıyla kullanılır. Bu değer, 3D Secure ödeme sürecine başlamadan önce oluşturulmalı ve client tarafında kullanılmalıdır. 3D Secure doğrulama işlemi sırasında, bu session ID işlemin backend tarafından takip edilmesini sağlar.
3D Secure işlem sürecini başlatmak için kullanılan değer
\n"},{"key":"CallbackUrl","value":"https://www.google.com","type":"text","description":"3D doğrulama sonucunun gönderileceği URL
\n"},{"key":"LanguageCode","value":"TR","type":"text","description":"Yanıtın döneceği dil bilgisi (default: TR)
\n"},{"key":"ClientIpAddress","value":"192.1.1.1","type":"text","description":"Müşterinin IP adresi
\n"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı
\n"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası
\n"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri
\n"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri benzersiz değeri
\n"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası
\n"}]},"url":"https://api.parakolay.com/v1/threeds/init3ds","description":"Bu endpoint, 3D Secure doğrulama işlemini başlatmak için kullanılır. Doğrulama sonucunda, kullanıcı tarayıcısı üzerinden kart bankasının 3D Secure doğrulama sayfasına yönlendirilir. Bu işlemin sonunda doğrulama durumu sorgulanabilir ve işlem tamamlanabilir.
\n","urlObject":{"path":["v1","threeds","init3ds"],"host":["https://api.parakolay.com"],"query":[],"variable":[]}},"response":[{"id":"acb25bc0-adfd-463e-9097-e7d3f267cdcc","name":"Successful","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"ThreeDSessionId","value":"e807170c-2237-4db9-8df5-dd0775ec67d8","type":"text","description":"3D Secure işlem sürecini başlatmak için kullanılan değer"},{"key":"CallbackUrl","value":"https://www.google.com","type":"text","description":"3D doğrulama sonucunun gönderileceği URL"},{"key":"LanguageCode","value":"TR","type":"text","description":"Yanıtın döneceği dil bilgisi (default: TR)"},{"key":"ClientIpAddress","value":"192.1.1.1","type":"text","description":"Müşterinin IP adresi"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri benzersiz değeri"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası"}]},"url":"https://api.parakolay.com/v1/threeds/init3ds"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 03:57:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"htmlContent\": \"\\n\\n\\n\\n\\n\\n\\n\",\n \"isSucceed\": true,\n \"errorCode\": \"\",\n \"errorMessage\": \"\",\n \"conversationId\": \"ORD-1316678114\"\n}"},{"id":"16914b33-6c08-4dd5-9829-97221ea0226d","name":"Forbidden","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"ThreeDSessionId","value":"e807170c-2237-4db9-8df5-dd0775ec67d8","type":"text","description":"3D Secure işlem sürecini başlatmak için kullanılan değer"},{"key":"CallbackUrl","value":"https://www.google.com","type":"text","description":"3D doğrulama sonucunun gönderileceği URL"},{"key":"LanguageCode","value":"TR","type":"text","description":"Yanıtın döneceği dil bilgisi (default: TR)"},{"key":"ClientIpAddress","value":"192.1.1.1","type":"text","description":"Müşterinin IP adresi"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri benzersiz değeri"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası"}]},"url":"https://api.parakolay.com/v1/threeds/init3ds"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.3\",\n \"title\": \"Forbidden\",\n \"status\": 403,\n \"detail\": \"ForbiddenAccessException\"\n}"},{"id":"0d428fae-5e89-4786-bebd-a6d7454d3ad2","name":"Signature Mismatch","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"ThreeDSessionId","value":"e807170c-2237-4db9-8df5-dd0775ec67d8","type":"text","description":"3D Secure işlem sürecini başlatmak için kullanılan değer"},{"key":"CallbackUrl","value":"https://www.google.com","type":"text","description":"3D doğrulama sonucunun gönderileceği URL"},{"key":"LanguageCode","value":"TR","type":"text","description":"Yanıtın döneceği dil bilgisi (default: TR)"},{"key":"ClientIpAddress","value":"192.1.1.1","type":"text","description":"Müşterinin IP adresi"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri benzersiz değeri"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası"}]},"url":"https://api.parakolay.com/v1/threeds/init3ds"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Value\": {\n \"Type\": \"https://tools.ietf.org/html/rfc7235#section-3.1\",\n \"Title\": \"Unauthorized\",\n \"Status\": 401,\n \"Detail\": \"Hmac Authentication Error\",\n \"Instance\": null,\n \"Extensions\": {}\n },\n \"Formatters\": [],\n \"ContentTypes\": [],\n \"DeclaredType\": null,\n \"StatusCode\": 401\n}"},{"id":"8b534ae8-611d-4908-a3e8-5f635a651b72","name":"Nonce Expired","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"ThreeDSessionId","value":"e807170c-2237-4db9-8df5-dd0775ec67d8","type":"text","description":"3D Secure işlem sürecini başlatmak için kullanılan değer"},{"key":"CallbackUrl","value":"https://www.google.com","type":"text","description":"3D doğrulama sonucunun gönderileceği URL"},{"key":"LanguageCode","value":"TR","type":"text","description":"Yanıtın döneceği dil bilgisi (default: TR)"},{"key":"ClientIpAddress","value":"192.1.1.1","type":"text","description":"Müşterinin IP adresi"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri benzersiz değeri"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası"}]},"url":"https://api.parakolay.com/v1/threeds/init3ds"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Value\": {\n \"Type\": \"https://tools.ietf.org/html/rfc7235#section-3.1\",\n \"Title\": \"Unauthorized\",\n \"Status\": 401,\n \"Detail\": \"Hmac Authentication Error\",\n \"Instance\": null,\n \"Extensions\": {}\n },\n \"Formatters\": [],\n \"ContentTypes\": [],\n \"DeclaredType\": null,\n \"StatusCode\": 401\n}"},{"id":"f8d3b8e3-6403-4685-b62b-bd653263550c","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"ThreeDSessionId","value":"e807170c-2237-4db9-8df5-dd0775ec67d8","type":"text","description":"3D Secure işlem sürecini başlatmak için kullanılan değer"},{"key":"CallbackUrl","value":"https://www.google.com","type":"text","description":"3D doğrulama sonucunun gönderileceği URL"},{"key":"LanguageCode","value":"TR","type":"text","description":"Yanıtın döneceği dil bilgisi (default: TR)"},{"key":"ClientIpAddress","value":"192.1.1.1","type":"text","description":"Müşterinin IP adresi"},{"key":"PublicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","type":"text","description":"Üye iş yeri anahtarı"},{"key":"Nonce","value":"1738121552307","type":"text","description":"Zaman damgası"},{"key":"Signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","type":"text","description":"Kimlik anahtar değeri"},{"key":"ConversationId","value":"ORD-1316678114","type":"text","description":"Üye iş yeri benzersiz değeri"},{"key":"MerchantNumber","value":"1100000001","type":"text","description":"Üye iş yeri numarası"}]},"url":"https://api.parakolay.com/v1/threeds/init3ds"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Value\": {\n \"Type\": \"https://tools.ietf.org/html/rfc7235#section-3.1\",\n \"Title\": \"Unauthorized\",\n \"Status\": 401,\n \"Detail\": \"Hmac Authentication Error\",\n \"Instance\": null,\n \"Extensions\": {}\n },\n \"Formatters\": [],\n \"ContentTypes\": [],\n \"DeclaredType\": null,\n \"StatusCode\": 401\n}"}],"_postman_id":"5a5d3bfb-185f-4bd8-9abf-eea2b0c4a1fb"},{"name":"Get Threed Session Result","id":"ceb8e0a7-d9ed-4734-838b-321084d81b5e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"threeDSessionId\": \"e807170c-2237-4db9-8df5-dd0775ec67d8\",\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/threeds/getthreedsessionresult","description":"Bu endpoint, 3D Secure doğrulama işleminin sonucunu sorgulamak amacıyla kullanılır. 3D doğrulama işleminin başarılı olduğu durumda (isSucceed = true ve currentStep = VerificationFinished), oluşturulan threeDSessionId değeri ile provizyon isteği yapılabilir.
currentStep değerleri:
SessionIdRequested: 3D session ID oluşturuldu.
VerificationStarted: 3D doğrulama işlemi başlatıldı.
VerificationFinished: 3D doğrulama işlemi tamamlandı.
ProvisionCompleted: 3D doğrulama sonrası provizyon tamamlandı.
Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 30,\r\n \"pointAmount\": 0,\r\n \"cardToken\": \"+oc6jxS0ABueLM+QuJnQFrZyV+B4HMHYiMx8yBH/Z90=\",\r\n \"currency\": \"TRY\",\r\n \"paymentType\": \"Auth\",\r\n \"installmentCount\": 1,\r\n \"threeDSessionId\": \"e807170c-2237-4db9-8df5-dd0775ec67d8\",\r\n \"OriginalOrderId\": \"\",\r\n \"LanguageCode\":\"TR\",\r\n \"MerchantCustomerName\":\"Customer Name\",\r\n \"MerchantCustomerPhoneNumber\":\"905321231212\",\r\n \"CardHolderName\":\"Holder Name\",\r\n \"Description\":\"test\"\r\n }","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/provision","description":"Bu endpoint, finansal işlemleri gerçekleştirmek için kullanılır. İstek, 3D secure işlemler için uygundur. İşlem yapılırken doğrulama sonrası alınan threeDSessionId parametresi gönderilmelidir.
Kredi kartı çekim işlemleri için kullanılan fonksiyonlar. 3DS only.
\n","_postman_id":"587cef67-1efc-41ab-833c-35262fd61486"},{"name":"Returns","item":[{"name":"Reverse","id":"ad3bfd00-fe28-4fd3-a215-b2262280855e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"orderid\": \"00000001234567890123\",\r\n \"LanguageCode\":\"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/reverse","description":"İptal işlemi için işlem ile aynı gün kullanılır.
Parçalı iade yapılamaz. Tüm işlem iptal edilir.
Bu endpoint, işlem gün sonu yapılmadan önce bir finansal işlemi iptal etmek için kullanılır.
\nİptal edilen işlemler, geri alınmış sayılır ve ilgili işlem üzerinden herhangi bir ödeme yapılamaz. Parçalı iade yapılamaz, tüm işlem iptal edilir.
\n","urlObject":{"path":["v1","Payments","reverse"],"host":["https://api.parakolay.com"],"query":[],"variable":[]}},"response":[{"id":"babcc644-7ad4-4898-82f2-564c19e1af4a","name":"Successful","originalRequest":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"orderid\": \"00000001234567890123\",\r\n \"LanguageCode\":\"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/reverse"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 04:17:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"provisionNumber\": \"123456\",\n \"isSucceed\": true,\n \"errorCode\": null,\n \"errorMessage\": null,\n \"conversationId\": \"ORD-1316678114\"\n}"},{"id":"880eaed1-89f8-4717-88d7-c4a72342864f","name":"Not Found","originalRequest":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"orderid\": \"00000001234567890123\",\r\n \"LanguageCode\":\"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/reverse"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 04:17:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"provisionNumber\": null,\n \"isSucceed\": false,\n \"errorCode\": \"1001\",\n \"errorMessage\": \"Geçersiz işlem bilgisi. Lütfen daha sonra tekrar deneyiniz.\",\n \"conversationId\": \"ORD-1316678114\"\n}"}],"_postman_id":"ad3bfd00-fe28-4fd3-a215-b2262280855e"},{"name":"Return","id":"24ebfc4f-5b2c-424f-b350-8126ab29a7a0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"amount\": 35,\r\n \"orderid\": \"00000001234567890123\",\r\n \"languageCode\":\"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/return","description":"Bu endpoint, bir finansal işlemin tamamını veya belirli bir kısmını iade etmek amacıyla kullanılır. İade işlemi, işlem gün sonu gerçekleştikten sonra çağrılabilir.
\nBir işlem parçalı iade edilebilir, ancak toplam iade tutarı işlem tutarını aşamaz.
\n","urlObject":{"path":["v1","Payments","return"],"host":["https://api.parakolay.com"],"query":[],"variable":[]}},"response":[{"id":"a67c09e7-d787-43d9-8117-c86edbff911d","name":"Successful","originalRequest":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"amount\": 35,\r\n \"orderid\": \"00000001234567890123\",\r\n \"languageCode\":\"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/return"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 04:17:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"returnMessage\": \"İade talebinizin onaylanması gerekiyor. Ekibimiz iade talebiyle ilgili işlem yapacaktır.\",\n \"approvalStatus\": \"PendingApproval\",\n \"provisionNumber\": null,\n \"isSucceed\": true,\n \"errorCode\": \"\",\n \"errorMessage\": \"\",\n \"conversationId\": \"ORD-1316678114\"\n}"},{"id":"0442f22b-eda9-4ad6-922e-61932c671036","name":"Not Found","originalRequest":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"amount\": 35,\r\n \"orderid\": \"00000001234567890123\",\r\n \"languageCode\":\"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/return"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 04:17:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"returnMessage\": null,\n \"approvalStatus\": \"None\",\n \"provisionNumber\": null,\n \"isSucceed\": false,\n \"errorCode\": \"1001\",\n \"errorMessage\": \"Geçersiz işlem bilgisi. Lütfen daha sonra tekrar deneyiniz.\",\n \"conversationId\": \"ORD-1316678114\"\n}"}],"_postman_id":"24ebfc4f-5b2c-424f-b350-8126ab29a7a0"}],"id":"cdbc2e91-bb5e-4b56-b283-498ef2fcc887","_postman_id":"cdbc2e91-bb5e-4b56-b283-498ef2fcc887","description":""},{"name":"Informational","item":[{"name":"Inquire","id":"c3359d19-8b6e-47de-acae-3df4bd8000ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"paymentConversationId\": \"123456789\",\r\n \"orderid\": \"00000001234567890123\",\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/inquire","description":"Bu endpoint, yapılan finansal işlemin durumunu sorgulamak için kullanılır. Provision servisi işlem sonucunu genellikle senkron olarak döner. Ancak işlem sonucunun alınamadığı durumlarda, bu endpoint üzerinden işlem durumu doğrulanabilir.
Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"cardToken\": \"+oc6jxS0ABueLM+QuJnQFrZyV+B4HMHYiMx8yBH/Z90=\",\r\n \"currency\": \"TRY\",\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/pointInquiry","description":"Bu endpoint, bir kartın içinde bulunan kullanılabilir puan miktarını sorgulamak için kullanılır. İstek sırasında kartın cardToken değeri ve işlem para birimi belirtilmelidir.
Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"cardToken\": \"\",\r\n \"binNumber\": \"409070\",\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/bin-information","description":"Bu endpoint, bir kartın BIN bilgilerini sorgulamak için kullanılır. Kart numarasının ilk 6 hanesi veya kart token değeri kullanılarak kart tipi, ağı ve marka bilgileri alınabilir.
\n","urlObject":{"path":["v1","Payments","bin-information"],"host":["https://api.parakolay.com"],"query":[],"variable":[]}},"response":[{"id":"71ad95f8-e450-48ef-9c48-909950e21ccb","name":"Successful","originalRequest":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"cardToken\": \"\",\r\n \"binNumber\": \"409070\",\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/bin-information"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 04:13:04 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"binNumber\": \"409070\",\n \"cardBrand\": \"Visa\",\n \"cardNetwork\": \"Bonus\",\n \"cardType\": \"Credit\",\n \"cardSubType\": \"Classic\",\n \"bankCode\": 134,\n \"bankName\": \"DENİZBANK\",\n \"isVirtual\": true,\n \"isSucceed\": true,\n \"errorCode\": \"\",\n \"errorMessage\": \"\",\n \"conversationId\": \"ORD-1316678114\"\n}"},{"id":"ca913ef8-d1af-4f90-bb2c-ad4acd45479a","name":"Not Found","originalRequest":{"method":"POST","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası","type":"text"}],"body":{"mode":"raw","raw":"{ \r\n \"cardToken\": \"\",\r\n \"binNumber\": \"419070\",\r\n \"languageCode\": \"TR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.parakolay.com/v1/Payments/bin-information"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 03 Feb 2025 04:13:46 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=15724800; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"binNumber\": \"419070\",\n \"cardBrand\": \"Undefined\",\n \"cardNetwork\": \"Unknown\",\n \"cardType\": \"Unknown\",\n \"cardSubType\": \"Unknown\",\n \"bankCode\": 0,\n \"bankName\": \"\",\n \"isVirtual\": false,\n \"isSucceed\": true,\n \"errorCode\": \"PFC032\",\n \"errorMessage\": \"Geçersiz işlem bilgisi. Lütfen daha sonra tekrar deneyiniz.\",\n \"conversationId\": \"834124939\"\n}"}],"_postman_id":"ce9453a5-a6ee-4183-b45f-f61bc8b4594d"},{"name":"Installment","id":"833d1305-20bc-483a-a1a7-3688868f6f43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"publicKey","value":"Y+nvUaIDz+Urcg5DMM+LEQ==","description":"Üye iş yeri anahtarı
\n","type":"text"},{"key":"nonce","value":"1738121552307","description":"Zaman damgası
\n","type":"text"},{"key":"signature","value":"+xktvIUAFnxKEXPTB73DedPxE1uHEjgRgwuuVU2N7jc=","description":"Kimlik anahtar değeri
\n","type":"text"},{"key":"conversationId","value":"ORD-1316678114","description":"Üye iş yeri sipariş numarası
\n","type":"text"},{"key":"clientIpAddress","value":"192.1.1.0","description":"Müşteri IP Adresi
\n","type":"text"},{"key":"merchantNumber","value":"1100000001","description":"Üye iş yeri numarası
\n","type":"text"}],"url":"https://api.parakolay.com/v1/Installment","description":"Bu endpoint, bir kredi kartı için kullanılabilir taksit seçeneklerini sorgulamak için kullanılır. Kartın binNumber değeri ve işlem tutarı belirtilerek, işlem tutarına göre bankanın sunduğu uygun taksit seçenekleri alınır.