{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"d0bb88a7-9e3c-43ee-8cb0-64dd0b1e7c19","name":"Parakolay Sanal Pos API Dokümantasyonu","description":"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.\n\n#### **Ortamlar ve URL'ler**\n\n- **Test Ortamı URL**: `https://api-test.parakolay.com`\n    \n- **Üretim Ortamı URL**: `https://api.parakolay.com`\n    \n\n---\n\n# 🚀 **SDK Bağlantıları ve Örnek Entegrasyonlar**\n\nParakolay 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.\n\nAşağıdaki GitHub bağlantılarından ihtiyacınız olan SDK’yi seçebilir ve projenize dahil edebilirsiniz.\n\n**Hı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.\n\n#### **Mevcut SDK’lar ve GitHub Bağlantıları**\n\n| **Programlama Dili** | **GitHub Bağlantısı** |\n| --- | --- |\n| **Node.js** | [https://github.com/parakolay/Parakolay-NodeJS-SDK](https://github.com/parakolay/Parakolay-NodeJS-SDK) |\n| **C# (.NET)** | [https://github.com/parakolay/Parakolay-DotNet-SDK](https://github.com/parakolay/Parakolay-DotNet-SDK) |\n| **PHP** | [https://github.com/parakolay/Parakolay-PHP-SDK](https://github.com/parakolay/Parakolay-PHP-SDK) |\n| **Flutter (Dart)** | [https://github.com/parakolay/Parakolay-Dart-SDK](https://github.com/parakolay/Parakolay-Dart-SDK) |\n\n#### **Katkıda Bulunma ve Geri Bildirim**\n\nSDK’ları geliştirmek veya hata bildirmek isterseniz, **Pull Request** oluşturabilir veya **GitHub Issues** üzerinden geri bildirimde bulunabilirsiniz.\n\n---\n\n# 👨‍💻 Açık Kaynak CMS Eklentileri\n\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.\n\n## 🟦 WordPress - WooCommerce\n\n- 📦 **İndir (.zip):** [woocommerce-parakolay-payment.zip](https://github.com/parakolay/Acik_Kaynak_CMS/blob/main/woocommerce-parakolay-payment.zip)\n    \n\n### 🔧 Kurulum\n\n1. WordPress yönetim panelinize giriş yapın.\n    \n2. **Eklentiler → Yeni Ekle** bölümüne gidin.\n    \n3. **Eklenti Yükle** butonuyla `.zip` dosyasını seçin ve yükleyin.\n    \n4. Eklentiyi etkinleştirin.\n    \n5. Parakolay API anahtarınızı ayarlar sayfasından girin.\n    \n\n## 🟧 OpenCart\n\n- 📦 **v3 İndir (.zip):** [parakolay-opencart-3.ocmod.zip](https://github.com/parakolay/Acik_Kaynak_CMS/blob/main/parakolay-opencart-3.ocmod.zip)\n    \n- 📦 **v4 İndir (.zip):** [parakolay-opencart-4.ocmod.zip](https://github.com/parakolay/Acik_Kaynak_CMS/blob/main/parakolay-opencart-4.ocmod.zip)\n    \n\n### 🔧 Kurulum\n\n1. OpenCart yönetim panelinize giriş yapın.\n    \n2. **Extensions → Installer** menüsünden `.zip` dosyasını yükleyin.\n    \n3. **Extensions → Modifications** bölümünden değişiklikleri etkinleştirin.\n    \n4. Gerekli 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  \n\n---\n\n# 🔖 Kimlik Doğrulama\n\nAPI’ye erişim için her çağrı sırasında bir **public key**, **nonce** ve **signature** gereklidir.\n\nHer API çağrısında, bu değerlerin HTTP header veya body ile gönderilmesi gereklidir.\n\n- **Public Key**: Üye iş yerinin açık anahtarı.\n    \n- **Nonce**: Zaman damgası.\n    \n- **Signature**: SHA256 algoritmasıyla üretilen imza.\n    \n\n### **🗝️ Public ve Private Key Bilgisi**\n\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.\n\n- **Public Key ve Private Key Nereden Alınır?**\n    \n    - Bu bilgiler **Merchant Paneli**'nin \"Bilgilerim\" sekmesinde yer alır.\n        \n    - **Private 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.\n        \n\n---\n\n# **🛟 Nonce nedir? ConversationID nedir?**\n\n#### **🔢 Nonce Nedir?**\n\n**Nonce**, 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.\n\n**Kullanımı:**\n\n- API çağrılarında **zaman damgası** olarak kullanılır.\n    \n- **Signature (İmza) hesaplamasında** bir parametre olarak dahil edilir.\n    \n- Aynı isteğin tekrar gönderilmesini engeller.\n    \n\n#### **💬 ConversationID Nedir?**\n\n**ConversationID**, 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.\n\n**Kullanımı:**\n\n- API isteği ile birlikte gönderilir.\n    \n- API yanıtında döndürülerek, **istek ve yanıtın eşleşmesi** sağlanır.\n    \n- Genellikle **sipariş numarası** olarak kullanılır.\n    \n\n---\n\n# 🔐 **Signature (İmza) Nedir?**\n\n**Signature**, 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.\n\n### **📌 API İsteklerinde Signature Kullanımı**\n\n**Tüm API isteklerinde aşağıdaki değerler header alanında gönderilmelidir:**\n\n|  | **Açıklama** |\n| --- | --- |\n| **publicKey** | Üye işyerine ait açık anahtar. |\n| **nonce** | Milisaniye cinsinden geçerli zaman damgası. |\n| **signature** | HMAC-SHA256 algoritması ile oluşturulmuş imza değeri. |\n| **conversationId** | API çağrısını takip edebilmek için üye işyeri tarafından belirlenen benzersiz değer (genellikle sipariş numarası). |\n| **merchantNumber** | Üye işyerine atanmış benzersiz kimlik numarası. |\n| **clientIpAddress** | API çağrısını yapan kullanıcının IP adresi. |\n\n**‼️ Bu veriler olmadan yapılan API çağrıları doğrulanamaz ve işleme alınmaz.**\n\n### **📌 Signature (İmza) Oluşturma Süreci**\n\nSignature oluşturulurken şu adımlar izlenmelidir:\n\n1️⃣ Public Key ve Nonce birleştirilerek ilk veri seti oluşturulur.  \n2️⃣ Bu veri, üye işyerine sağlanan Private Key ile HMAC-SHA256 algoritması kullanılarak hashlenir → 1. Seviye güvenlik verisi elde edilir.  \n3️⃣ Bu aşamada elde edilen veri, Private Key, ConversationId ve Nonce ile tekrar hashlenerek Signature üretilir.  \n4️⃣ Signature, her API isteğinde header içinde sunucuya gönderilir.\n\n## **🧑‍💻 Signature Kodları**\n\n``` csharp\n    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 ```\n\n``` javascript\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\n ```\n\n``` php\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\n ```\n\n``` dart\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\n ```\n\n---\n\n## **Sık Karşılaşılan Sorunlar**\n\n- **Hata Mesajı: \"Invalid Signature\"**\n    \n    - Signature değerinizin doğru oluşturulduğundan ve Nonce değerinizin güncel olduğundan emin olun.\n        \n- **Hata Mesajı: \"Authentication Failed\"**\n    \n    - Public Key veya Private Key bilgilerinin doğru olduğundan emin olun.\n        \n- **Hata Mesajı: \"Endpoint Not Found\"**\n    \n    - API URL’nizin doğru yazıldığından emin olun (örneğin, `https://api-test.parakolay.com`).\n        \n\n---\n\n# **💵 İşlem sırası nasıl olmalı?**\n\n## **📌 Ödeme Akışı (3D Secure ile)**\n\n1️⃣ **v1/tokens – Kart Token Oluşturma**\n\n- Kullanıcının kart bilgileriyle **kart token’ı** oluşturulur.\n    \n- Token, ödeme işlemlerinde **kart bilgilerini taşımadan işlem yapmayı** sağlar.\n    \n\n2️⃣ **v1/threeds/getthreedsession – 3D Secure Oturumu Başlatma**\n\n- Kullanıcı için **3D Secure oturumu açılır**.\n    \n- **Bankanın yönlendireceği doğrulama ekranı** için gerekli bilgiler oluşturulur.\n    \n\n3️⃣ **v1/threeds/init3ds – 3D Secure İşlemi Başlatma**\n\n- Kullanıcının yönlendirileceği **3D doğrulama html formu oluşturulur.**\n    \n- Kullanıcı bu html aracılığıyla **banka tarafındaki ekranlara yönlendirilir**.\n    \n\n4️⃣ **Kullanıcı 3DS Formunda İşlemi Onaylar**\n\n- Kullanıcı, **bankanın doğrulama sayfasına yönlendirilir**.\n    \n- Kullanıcı **şifresini girerek işlemi onaylar**.\n    \n\n5️⃣ **Callback URL ile 3D Sonuç Alınır**\n\n- Kullanıcı işlemi tamamladıktan sonra, **üye işyerinin belirttiği Callback URL’ye döner**.\n    \n- **‼️ Callback URL çağırılırken GET methodu ile istek gönderilecektir.**\n    \n- 3D Secure sonucu, **v1/threeds/getthreedsessionresult** servisi ile kontrol edilir.\n    \n\n6️⃣ **v1/Payments/provision Servisi ile Çekim Yapılır – Ödeme Tamamlama**\n\n- **Provision servisi çağrılarak ödeme tahsilatı gerçekleştirilir.**\n    \n- İşlem sonucu başarılı olursa, sipariş tamamlanır.\n    \n- **‼️ Provision servisi çağrılmayan işlemlerde kart sahibinden çekim gerçekleştirilmez.**\n    \n\n### **📡 Ödeme Akış Diyagramı**\n\n<img src=\"https://content.pstmn.io/54aa417b-f5dc-4b70-b316-69e98ada61c6/VW50aXRsZWQgZGlhZ3JhbS0yMDI1LTAxLTI5LTA0MzMxNS5wbmc=\">\n\n---\n\n# ⚠️ Hata Yönetimi ve Yanıt Kodları\n\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.\n\n#### **Hata Kodları ve Açıklamaları**\n\n| Hata Kodu | Açıklama (TR) | Açıklama (EN) |\n| --- | --- | --- |\n| **0001** | Geçersiz üye iş yeri bilgisi. Lütfen daha sonra deneyiniz. | Invalid merchant information. Please try again later. |\n| **0002** | Yurtdışı kartlarından taksit yapılamaz. | Not allowed international card instalment! |\n| **0003** | Üye iş yeri durumu işlem almak için uygun değildir. | Invalid merchant status. Please try again later. |\n| **0004** | Geçersiz işlem türü denenmektedir. | Invalid transaction type. Please try again later. |\n| **0005** | Üye iş yerine ait POS bulunamadı. | VPOS not found. Please try again later. |\n| **0006** | POS bankası bulunamadı. | Acquire bank not found. Please try again later. |\n| **0007** | Geçersiz tutar bilgisi mevcuttur. Bilgileri kontrol ederek tekrar deneyiniz. | Invalid amount information. Please check the information and try again. |\n| **0008** | Geçersiz ödeme tipi mevcuttur. | Invalid payment type. Please check the information and try again. |\n| **0009** | Oturum bilgisi geçersizdir. | Invalid session information. Please try again later. |\n| **0010** | Aylık tutar limitini aştınız. | Monthly limit amount exceeded. Please try again later. |\n| **0011** | Aylık işlem limitini aştınız. | Monthly limit count exceeded. Please try again later. |\n| **0012** | Günlük işlem limitini aştınız. | Daily limit count exceeded. Please try again later. |\n| **0013** | Günlük tutar limitini aştınız. | Daily limit amount exceeded. Please try again later. |\n| **0014** | Tam 3DS doğrulama yapılmadığı için işleme izin verilmemektedir. | Half Secure not allowed. |\n| **0015** | Oturum bilgisi bulunamadı. | Session not found. Please try again later. |\n| **0016** | Yurtdışı kartlarında işlem yapılamaz. | International card not allowed. |\n| **0017** | 3DS işlemde tutar uyuşmazlığı mevcuttur. | 3DS validation amount mismatch. Please check the information and try again. |\n| **0018** | 3DS işlemde kart oturum uyuşmazlığı mevcuttur. | 3DS validation card token mismatch. Please check the information and try again. |\n| **0019** | 3DS işlem oturumu son bulmuştur. | 3DS session expired. Please check the information and try again. |\n| **0020** | 3DS işlemde para birimi uyuşmazlığı mevcuttur. | 3DS validation currency mismatch. Please check the information and try again. |\n| **0021** | 3DS işlemde işlem türü uyuşmazlığı mevcuttur. | 3DS validation transaction type mismatch. Please check the information and try again. |\n| **0022** | Kart token zaman aşımına uğramıştır. | Card token expired. Please check the information and try again. |\n| **0023** | Taksitli işlem yapılamaz. | Installment not allowed. |\n| **0024** | 3DS harici işlem yapılamaz. | NonSecure not allowed. |\n| **0025** | Ön provizyon işlemi yapılamaz. | PreAuthorization not allowed. |\n| **0026** | İşlem daha önceden iade edilmiştir. | Transaction already refunded. |\n| **0027** | Geçersiz iade tutarı mevcuttur. | Invalid return amount. Please try again later. |\n| **0028** | Başarılı 3DS doğrulama yapılamadı. | No successful 3DS verification found. Please try again later. |\n| **0029** | Token bilgisi bulunamamıştır. | Token information could not be found. Please try again later. |\n| **0030** | Link bulunamadı. | Link not found. |\n| **0031** | Link kullanım süresi bitti. | Link expired. |\n| **0032** | Link kullanım limitine ulaştı. | Link max limit count exceeded. |\n| **0033** | Ad Soyad bilgisi zorunludur. | Name and surname information cannot be empty. |\n| **0034** | Adres bilgisi zorunludur. | Address information cannot be empty. |\n| **0035** | Sipariş not bilgisi zorunludur. | Order note information cannot be empty. |\n| **0036** | Telefon numarası bilgisi zorunludur. | Phone number cannot be empty. |\n| **0037** | E-posta adres bilgisi zorunludur. | E-mail address cannot be empty. |\n| **0038** | Genel toplam komisyonsuz tutardan küçük veya eşit olamaz. | The grand total cannot be less than or equal to the commission-free amount. |\n| **0039** | Karta ait puan bilgisi bulunmamaktadır. | There is no score information for the card. |\n| **0040** | Pos maliyet bilgisi bulunamadı. | Pricing profile item could not be found. Please try again later. |\n| **0041** | İşlem banka tarafında zaman aşımına uğramıştır. | Bank has timed out. Please try again later. |\n| **0042** | İşlem fraud kontrollerini geçememiştir. | The transaction did not pass fraud checks. |\n| **0043** | Sipariş numarası önceden kullanılmıştır. | The order number has already been used. |\n| **0044** | HPP yetkisi bulunmamaktadır. | There is no HPP authority. |\n| **0045** | İade yetkisi bulunmamaktadır. | There is no return authority. |\n| **0046** | İptal yetkisi bulunmamaktadır. | There is no reverse authority. |\n| **0047** | İşlem iptal edilemez. | Transaction is not reversible. |\n| **0048** | İşlem iade edilemez. | Transaction is not returnable. |\n| **0049** | İşlem iade edilemez. | Transaction is not returnable. |\n| **0050** | İşlem blokeli olduğundan iade edilemez. İade için blokeyi çözüp tekrar deneyiniz. | The transaction is blocked and cannot be refunded. For a refund, unblock it and try again. |\n| **0051** | Tek çekim işlemden komisyon alınamaz. | Cannot take commission on advance provision. |\n| **0052** | Komisyonlu işlemde taksit tutarı bilgisi gönderilemez. | Installment amount cannot be set on provision with commission. |\n| **0053** | Tek çekim ve komisyonsuz işlemde taksit listesi boş olmalı. | Installment list must be empty on advance and commission-free provision. |\n| **0054** | Günlük iade tutarı toplam işlem tutarından büyük olamaz. Daha sonra tekrar deneyiniz. | The daily refund amount cannot be greater than the total transaction amount. Try again later. |\n| **1001** | Geçersiz işlem bilgisi. Lütfen daha sonra tekrar deneyiniz. | Invalid transaction information. Please try again later. |\n| **1002** | Girilen kart bilgileri hatalıdır. Lütfen tekrar deneyiniz. | The card information entered is incorrect. Please try again. |\n| **1003** | Sistem Hatası. | System Error. |\n| **5000** | İşlem başarılı gerçekleşti. | The transaction was successful. |\n| **5001** | İşlem onaylanmadı. Lütfen daha sonra tekrar deneyiniz. | The transaction has not been approved. Please try again later. |\n| **5002** | İşlem onaylanmadı. Lütfen bankanız ile iletişime geçiniz. | The transaction has not been approved. Please contact your bank. |\n| **5003** | Karta el koyulmuştur. Lütfen bankanız ile iletişime geçiniz. | The card has been confiscated. Please contact your bank. |\n| **5004** | Girilen kredi kartının geçerlilik süresi bitmiştir. Lütfen bankanız ile iletişime geçiniz. | The validity period of the entered credit card has expired. Please contact your bank. |\n| **5005** | Belirtilen kredi kartının limiti bu işlem için yeterli değildir. | The specified credit card limit is not sufficient for this transaction. |\n| **5006** | Kartınız e-ticaret işlemlerine kapalıdır. Lütfen bankanız ile iletişime geçiniz. | Your card is closed to e-commerce transactions. Please contact your bank. |\n| **5007** | Belirtilen kredi kartının sanal limiti bu işlem için yeterli değildir. | The virtual limit of the specified credit card is not sufficient for this transaction. |\n| **5008** | Kartınız kapalıdır. Lütfen bankanız ile iletişime geçiniz. | Your card is closed. Please contact your bank. |\n| **5009** | 3DS şifresi doğrulanamadı. Lütfen tekrar deneyiniz. | Failed to verify 3DS Secure password. Please try again. |\n| **5010** | Kredi kartınızın 3DS tanımı bulunmamaktadır. Lütfen bankanız ile iletişime geçiniz. | Your credit card does not have a 3DS definition. Please contact your bank. |\n| **5011** | Kredi kartı blokesi mevcuttur. Banka ile iletişime geçiniz. | Credit card blocking is available. Contact the bank. |\n| **5012** | Girilen güvenlik kodu hatalıdır. Lütfen daha sonra tekrar deneyiniz. | The security code entered is incorrect. Please try again later. |\n\n#### **🔄 Timeout Yönetimi**\n\nBazı durumlarda, **Parakolay, banka veya ağ kaynaklı gecikmeler nedeniyle** API yanıtını zamanında veremeyebilir.  \nBöyle bir senaryoda **backend sisteminizde timeout yönetimi** uygulamak önerilir.\n\n📌 **Önerilen Çözüm:**\n\n1. **Belirsiz İşlemleri Yönetme**\\*_İşlem beklenenden uzun sürüyorsa \\*__\\\\_**işlem durumunu sorgulamak için** `/v1/Payments/inquire` servisini kullanın.\n    \n2. **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.\n    \n3. **Yönetici Paneli Üzerinden Kontrol**  \n    Belirsiz işlemleri API ile yönetmenin yanı sıra, \\*_Merchant Paneli’nden de işlemlerin durumu manuel olarak kontrol edilebilir.__\\*_\n    \n\n---\n\n# **💳 Test Kart Bilgileri**\n\n| **Banka Adı** | **Kart Ağı** | **Kart Numarası** | **SKT (Son Kullanma Tarihi)** | **CVV** | **3D Secure Şifresi** |\n| --- | --- | --- | --- | --- | --- |\n| **Vakıfbank** | World | 4119790166544284 | 04/24 | 961 | 123456 veya Yes |\n|  | World | 4938460158754205 | 11/24 | 715 | 123456 veya Yes |\n|  | Bilinmeyen Kart | 4836123449601980 | 06/29 | 741 | 123456 veya Yes |\n| **Ziraat Bankası** | BankKart | 4446763125813623 | 12/26 | 000 | \\- |\n| **Türkiye Finans Katılım Bankası** | Bonus | 6060433087290190 | 12/30 | 001 | \\- |\n|  | Bonus | 4799150896081734 | 12/30 | 001 | \\- |\n|  | Bonus | 5377193762823307 | 12/30 | 001 | \\- |\n| **DenizBank** | Bonus | 5200190011811433 | 12/30 | 001 | \\- |\n|  | Bonus | 4090700100360047 | 12/30 | 001 | \\- |\n|  | Bonus | 5167400000496745 | 12/30 | 001 | \\- |\n| **INGBANK** | Bonus | 5269737320050521 | 12/30 | 001 | \\- |\n| **Garanti** | Bonus | 5209882483498019 | 12/30 | 001 | \\- |\n| **Akbank** | Axess | 4256691944867646 | 12/30 | 001 | \\- |\n| **BurganBank** | Bilinmeyen Kart | 4985170000702810 | 12/30 | 001 | \\- |\n| **İş Bankası** | Maximum | 4508034508034509 | 12/30 | 001 | \\- |\n| **HalkBank** | Paraf | 9792100000000001 | 12/30 | 001 | \\- |\n| **QNB FinansBank** | CardFinans | 4155650100416111 | 01/50 | 715 | \\- |\n|  | CardFinans | 5456165456165454 | 12/30 | 001 | \\- |\n|  | Bilinmeyen Kart | 9792023757123604 | 12/30 | 001 | \\- |\n| **HSBC** | Advantage | 4282405990002166 | 12/30 | 001 | \\- |\n| **Akbank** | Axess | 9792072000017956 | 12/30 | 001 | \\- |\n| **KuveytTürk** | SaglamKart | 5188961939192544 | 06/25 | 929 | \\- |\n\n---\n\n## **🆘 Destek ve İletişim**\n\nHerhangi bir sorun ya da teknik destek talebinizde aşağıdaki bilgilerden bizimle iletişime geçebilirsiniz:\n\n- **E-posta**: [destek@parakolay.com](https://mailto:destek@parakolay.com)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"28017874","team":5246551,"collectionId":"d0bb88a7-9e3c-43ee-8cb0-64dd0b1e7c19","publishedId":"2sAY4rF56g","public":true,"publicUrl":"https://docs.parakolay.com","privateUrl":"https://go.postman.co/documentation/28017874-d0bb88a7-9e3c-43ee-8cb0-64dd0b1e7c19","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":"Parakolay API, ödeme entegrasyonlarınızı hızlı ve güvenli hale getirmenizi sağlar. 3D Secure, kart saklama, iade, iptal ve çekim işlemlerini kolayca yönetin. HMAC-SHA256 imzalama yöntemiyle güvenli API çağrıları yapın. Detaylı dökümantasyon ve örnek kodlarla hemen entegre olun! ????"},{"name":"title","value":"Parakolay Sanal Pos API Dokümantasyonu – Güvenli Ödeme Entegrasyonu ve 3D Secure İşlemleri"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/ea215b10-8d5b-4c4d-821b-241cd781e7fd/QXNzZXQgMUAzeC5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/ea215b10-8d5b-4c4d-821b-241cd781e7fd/QXNzZXQgMUAzeC5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-01-29T05:10:46.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Parakolay Sanal Pos API Dokümantasyonu – Güvenli Ödeme Entegrasyonu ve 3D Secure İşlemleri","description":"Parakolay API, ödeme entegrasyonlarınızı hızlı ve güvenli hale getirmenizi sağlar. 3D Secure, kart saklama, iade, iptal ve çekim işlemlerini kolayca yönetin. HMAC-SHA256 imzalama yöntemiyle güvenli API çağrıları yapın. Detaylı dökümantasyon ve örnek kodlarla hemen entegre olun! ????"},"logos":{"logoLight":"https://content.pstmn.io/ea215b10-8d5b-4c4d-821b-241cd781e7fd/QXNzZXQgMUAzeC5wbmc=","logoDark":"https://content.pstmn.io/ea215b10-8d5b-4c4d-821b-241cd781e7fd/QXNzZXQgMUAzeC5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/19f667b483e13912a85ba0a32f06bb543a04a010f15dfb2626ec6cbe30bd9e85","favicon":"https://parakolay.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://docs.parakolay.com/view/metadata/2sAY4rF56g"}