Başlangıç

Paratika Entegrasyon Portalı'na Hoş Geldiniz Paratika Sanal POS altyapısını kullanarak ödeme almaya başlamak için doğru yerdesiniz. Eğer henüz Paratika üye iş yerlerinden biri değilseniz, www.paratika.com.tr/sanal-pos adresinden başvuru formunu doldurarak satış temsilcilerimizin sizinle iletişime geçmesini sağlayabilirsiniz.

Temsilcimiz, başvuru süreci, ürünlerimiz ve size özel çözümler hakkında detaylı bilgi sunacaktır.

Paratika ile dakikalar içinde online ödeme almaya başlayabilir, güçlü altyapımız ve müşteri destek ekibimizle her adımda yanınızda olduğumuzu hissedebilirsiniz. Hazırsanız, şimdi ilk adımı atın!

Başvuru ve İlk Adımlar

Başvuru ve Aktivasyon Süreci

1. Ön Görüşme ve Bilgilendirme:

Başvurunuzun ardından, satış temsilcimiz sizinle iletişime geçerek ihtiyaçlarınızı dinler ve en uygun çözümü belirler.

1. Online Onboarding Süreci:

Ön anlaşma sağlandıktan sonra size özel oluşturulan Online Onboarding bağlantısı SMS ve e-posta yoluyla iletilir. Bu bağlantı üzerinden:

• Şirket bilgilerinizi ve gerekli belgeleri kolayca yükleyebilir,
• Mobil uygulamamız aracılığıyla KYC (Müşterini Tanı) sürecini tamamlayabilir,
• Dijital sözleşmenizi online olarak onaylayabilirsiniz.

1. Entegrasyon ve Canlı Kullanım:

Tüm süreçler tamamlandığında, Paratika üye iş yeri olarak sanal POS altyapınızı kullanıma açabilir ve entegrasyon dokümanlarımızla birlikte teknik kurulum adımlarına geçebilirsiniz.

Başvurunuz iç ekiplerimizce incelenip onaylandıktan sonra Paratika Admin panellerine giriş yapabileceğiniz kullanıcı bilgileri tarafınıza iletilir. Paratika Sanal POS sistemi 2 ortama sahiptir. Entegrasyon ortamımızı, sanal pos ve sisteminiz arasındaki bağlantıyı kurarken kullanabilir ve daha sonrasında test etmek amacıyla işlem geçirmede kullanabilirsiniz. VPOS ortamı ise canlı üretim ortamı olup; Entegrasyon ortamında sisteminiz ve sanal pos arasındaki bağlantının tüm kontrolleri yapıldıktan sonra, gerçek işlemler için kullanılır.

Paratika Sanal POS sistemini birçok farklı kullanım modeli ile kullanabilirsiniz. En kolay ve teknik bilgi gerektirmeyen kullanım yöntemi ParatikLink olup bir websiteniz olmasına ihtiyaç duymazsınız. ParatikLink sekmesinde anlatılan adımları izleyerek panel üzerinden müşterilerinize bir ödeme linki oluşturabilir, bu linki müşterinizin cep telefonuna veya e-posta adresine yönlendirebilir ve kolayca ödeme alabilirsiniz.

İkinci bir yöntem olarak hazır E-Ticaret Altyapıları ile çalışabilir ve teknik bilgi gerektiren entegrasyon adımlarını atlayarak bu altyapı sağlayıcıların Paratika sistemleri ile haberleşmek için geliştirdiği eklentileri kullanarak sanal POS ve web siteniz arasındaki bağlantıyı kurabilirsiniz. Seçmiş olduğunuz E-Ticaret altyapısında sitenizi oluşturduktan sonra rehberde izlenen adımları takip ederek kolaylıkla Paratika Sanal POS servisi bağlantısını kurabilirsiniz.

Son olarak kendi altyapısı ile ilerlemek isteyen müşterilerimiz ise Paratika API'sini kullanarak sisteme entegre olmalıdır ve Entegrasyon Modelleri sekmesinde anlatılan 3 modelden birini kullanarak web sitesi ve sanal pos servisi arasındaki bağlantı kurulmalıdır.

Hangi şekilde implementasyon yapılacağından bağımsız olarak izlenmesi gereken ilk adım, aşağıda belirtilen yönlendirmeleri takip ederek admin paneline erişmek ve implementasyonda kullanılacak olan API kullanıcı adı ve şifresini oluşturmaktır.

📌 Canlı ve Entegrasyon ortamları için ayrı API kullanıcıları oluşturulmalıdır.

Merchant Api User rolündeki kullanıcınızı oluşturduktan sonra, Bilgilerim sekmesine giderek üye işyeri numaranızı bulabilirsiniz.

Bu sayede hazır E-Ticaret Altyapılarında veya Ortak Ödeme Sayfası, Direct Post, API gibi diğer entegrasyon modellerimizden birini kullanarak kendi altyapınız ile kuracağınız iletişimde kullanılacak 3 önemli anahtarı elde etmiş olursunuz.

Bu süreçte ve takıldığınız tüm noktalarda <destek@paratika.com.tr> adresinden yardım alabileceğinizi lütfen unutmayınız.

Hızlı Linkler

Paratika Admin Paneli Erişim Linkleri

Paratika API POST Linkleri

Ortak Ödeme Sayfası (HPP) Yönlendirme Linkleri

Direct Post - 2D MOTO (Non3D) Yönlendirme Linki

Direct Post - 3D Yönlendirme Linki

📌 Paratika sağlam ve güvenli bir iletişim protokolü üstüne inşa edilmiştir. Paratika API, standart HTTP(s) Post istekleri ile birlikte gönderilen bir talimatlar dizisidir, bakınız HTTPS Post istekleri. Sunucu tarafında, Verisign tarafından sağlanan sertifika kullanılmaktadır. SSL şifrelemesi sayesinde sunucularımızın sizinle iletişim kurması ve verilerinizin şifrelenmiş şekilde iletilmesi garanti edilmektedir. İstemci SSL sertifikasına ihtiyaç duyulmamaktadır. Bir istek alındığında şifreleme seviyesi kontrol edilir. Doğrudan TLSv1.2 ve üstü desteklenir.

ParatikLink ile Ödeme

ParatikLink, tek bir panelden oluşturacağınız linki kolay ödeme için müşterileriniz ile paylaşmanızı sağlar. Böylelikle, PCI-DSS güvenliğinde açılan ödeme sayfasından ödemelerinizi kolay ve hızlıca alırsınız.

Yazılım bilgisi gerektirmeden ödeme alabilmek için kullanabileceğiniz link ile ödeme yönteminde, SMS ya da e-posta olarak müşterilerinize iletilen ödeme bağlantısı vasıtasıyla uzaktan kolayca ödeme alabilirsiniz.

ParatikLink Oluşturma

Admin panelinizi kullanarak veya API üzerinden de kolayca ParatikLink oluşturabilirsiniz. Admin panelinizi kullanarak ParatikLink oluşturmak için aşağıdaki adımları izleyebilirsiniz.

Oluşturduğunuz bağlantıyı kopyalayarak müşterileriniz ile kendiniz paylaşabileceğiniz gibi panel üzerinden otomatik olarak SMS veya e-posta tetiklenmesini de sağlayabilirsiniz. Oluşturduğunuz link müşteriniz tarafından açıldığında size özel sunulmuş olan tüm kart aileleri ve onların taksit imkânlarını kullanarak müşterinizden ödeme alabilirsiniz.

E-Ticaret Altyapıları

Paratika, e-ticaret dünyasına adım atmak isteyen girişimciler ve işletmeler için hızlı, güvenli ve kullanıcı dostu çözümler sunar. Hazır e-ticaret altyapıları ile tam uyumlu çalışan Paratika entegrasyon pluginleri sayesinde, teknik bilgiye ihtiyaç duymadan dakikalar içinde online mağazanızı kurabilirsiniz.

Paratika’nın sunduğu kolay ve hızlı kurulum avantajı ile satışa hemen başlayabilir, Visa, MasterCard, Troy gibi tüm kart ailelerinden ödeme alabilirsiniz. Tek çekim veya farklı taksit seçenekleri ile müşterilerinize esnek ödeme imkanları sunarak satışlarınızı artırabilirsiniz.

Ayrıca Paratika’nın gelişmiş raporlama, sahtecilik önleme (fraud detection) ve güvenli ödeme altyapısı sayesinde hem sizin hem de müşterilerinizin işlemleri her zaman güvende olur.

İster küçük bir işletme sahibi olun, ister büyük bir e-ticaret operasyonunu yönetin — Paratika entegrasyon çözümleriyle dijital mağazanız için ihtiyaç duyduğunuz ödeme altyapısını zahmetsizce kurabilirsiniz.

Wordpress WooCommerce

WordPress sitenizde WooCommerce Plugin’i kullanılarak e-ticaret mağazası yaratılması ve Paratika Ödeme Sistemi entegrasyonu için aşağıdaki adımları takip edebilirsiniz. Rehberdeki adımları takip etmeden önce çalışır bir Wordpress tabanlı web siteniz olmalıdır.

Eklentiler menüsünden WooCommerce Plugin aratılır ve kurulur.

Eklenti kurulduktan sonra Aktifleştir butonu tıklanır ve mağaza kurulum adımları takip edilerek sanal mağaza yaratılır.

Mağaza İsmi, Sektör gibi bilgiler doldurulduktan sonra Tema Seçimi yapılır.

İlk ürün eklenerek mağaza aktifleştirilir.

Yayınla butonuna tıklanır ve ürün mağazamızda aktif hale gelir.

Bu aşamada E-Ticaret sitemiz ilk ürünü yaratılmış hali ile hazırdır. Bir sonraki adım ise, ödeme alabilmemiz için, e-ticaret sitemiz ile Paratika bağlantısını kurmaktır.

Sanal POS bağlantısının ilk adımı olarak Eklentiler > Yeni Ekle bölümüne tıklanır ve WooCommerceSanalPos.zip dosyası açılan alana ZIP formatında yüklenir.

Ardından WooCommerce –> Ayarlar –> Ödemeler adımları takip edilir ve Sanal POS uygulaması WooCommerce Ödeme Ayarları sayfasında etkinleştirilir.

Kurulumu Tamamla butonuna tıklanır ve Yöntem Ekle sekmesi açılır.

Seçeneklerden Paratika seçilir.

Daha sonra POS Ayarları sekmesi açılır ve Paratika’dan alınan kullanıcı bilgileri girilir.

Bu adımlarla gerekli kurulumlar tamamlanmış olur ve mağazanız üzerinden test satışlarınıza başlayabilirsiniz. Testlerinizin ardından canlı ortam bilgilerinizi girmeyi ve Test Modu'nu kapatmayı unutmayınız.

Böylelikle WordPress altyapısında çalışan web sitemizi WooCommerce eklentisi kullanarak bir sanal mağazaya çevirir ve Paratika Sanal POS hizmeti ile bağlantısını kurarak kredi kartı ile ödeme almaya hazır hâle getiririz.

Keyifli satışlar dileriz.

Shopify

Shopify mağazanızı Paratika Sanal POS ile entegre etmek artık çok daha kolay ve hızlı! Detaylı adımlarla hazırlanmış video rehberimizi takip ederek, Shopify Uygulama Mağazası’nda yer alan Paratika entegrasyon eklentisi aracılığıyla mağazanızı Paratika ödeme altyapısına zahmetsizce bağlayabilirsiniz.

Kurulumu sadece birkaç adımda tamamlayarak, güvenli ve kesintisiz bir şekilde ödeme almaya başlayabilirsiniz. Entegrasyon sonrası, müşterileriniz için geliştirilmiş kullanıcı deneyimi ve güvenli altyapı sayesinde dönüşüm oranlarınızı artırabilirsiniz.

Paratika Shopify entegrasyon eklentisi, PCI-DSS güvenlik standartlarına uygun olarak geliştirilen ödeme sayfası ile birlikte gelir. Böylece herhangi bir ek yazılım geliştirmeye ihtiyaç duymadan;

• Anında taksit seçeneklerini müşterilerinize sunabilir,
• Kampanya ve ödeme kuruluşu destekli puan sistemlerini aktif hale getirebilir,
• Satışlarınızı daha cazip hale getirebilirsiniz.

Ayrıca Paratika’nın sunduğu kapsamlı raporlama araçları ve güçlü altyapısı ile tüm ödeme işlemlerinizin takibini tek panel üzerinden kolayca gerçekleştirebilirsiniz.

Dijital mağazanızı büyütmek ve ödeme süreçlerinizi profesyonelce yönetmek için Paratika - Shopify entegrasyonunu hemen şimdi keşfedin!

Entegrasyon Modelleri

Paratika ile kendi web siteniz veya mobil uygulamanız arasında sorunsuz bir ödeme entegrasyonu sağlamak için ihtiyacınıza en uygun modeli seçebilirsiniz. Aşağıda, Paratika’nın sunduğu farklı entegrasyon yöntemlerini bulabilirsiniz:

Ortak Ödeme Sayfası (HPP - Hosted Payment Page / Browser Redirect)

Bu entegrasyon modelinde, ödeme işlemleri Paratika tarafından sağlanan güvenli ve hazır bir ödeme sayfası üzerinden gerçekleştirilir. Müşteriniz kredi kartı bilgilerini bu sayfada girer, taksit seçeneklerini görüntüler ve varsa puanlarını kullanabilir.

• Müşterinizin alışveriş sepeti bilgilerini kendi sitenizde oluşturursunuz.
• Ardından Paratika’dan bir SESSIONTOKEN alırsınız.
• Bu token ile müşterinizi Paratika’nın barındırdığı ödeme sayfasına yönlendirirsiniz.
• Ödeme işleminin sonucu, daha önce tanımlamış olduğunuz RETURNURL adresinize bildirilir.

Teknik geliştirme maliyeti en düşük entegrasyon yöntemidir ve PCI-DSS uyumluluğu açısından önemli avantajlar sağlar.

Detaylı bilgi için Ortak Ödeme Sayfası - HPP sayfasını inceleyebilirsiniz.

Direct POST Modelleri (Browser Redirect)

Bu entegrasyon tipi, ödeme sayfasını kendi sunucularında barındırmak isteyen işletmeler için idealdir. Müşteri kredi kartı bilgilerini işletmenizin oluşturduğu ödeme formu üzerinden girer ve işlem Paratika'ya iletilir.

a) Direct POST - MOTO (2D)

Kredi kartı bilgileri alınır, 3D Secure adımı uygulanmaz. Sanal POS üzerinden manuel işlem yapılmasına benzer.

b) Direct POST - 3D

Kredi kartı bilgileri alınır ve 3D Secure doğrulama süreci başlatılır.

Bu modellerde süreç şu şekilde işler:

• Sepet bilgileri ile birlikte Paratika’dan bir SESSIONTOKEN alınır.
• Müşteri kredi kartı bilgilerini, sizin tarafınızdan oluşturulan form üzerinden girer.
• Tarayıcı üzerinden, işlem türüne uygun olarak Direct POST (2D veya 3D) adresine yönlendirilir.

Bu modellerde PCI-DSS gerekliliklerine uygunluk sağlanmalı ve güvenlik önlemleri dikkatle uygulanmalıdır.

Detaylı bilgi için Direct POST sayfasını inceleyebilirsiniz.

API Entegrasyonu (Server to Server)

En gelişmiş entegrasyon modeli olan API yöntemi, tüm işlemlerin sunucular arası (server to server) olarak gerçekleştirilmesini sağlar. Kullanıcının tarayıcısı Paratika tarafına yönlendirilmeden işlem yapılır.

• Backend sisteminizden doğrudan Paratika API’sine istek yapılır.
• Ödeme sonuçları anlık olarak API üzerinden alınır ve işlem sonlanır.

Bu model, tam kontrol isteyen ve ödeme akışını tamamen kendi sistemleri içinde tutmak isteyen kurumlar için önerilir.

Detaylı bilgi için API Entegrasyonu sayfasını inceleyebilirsiniz.

Her bir entegrasyon modelinin sunduğu esneklik ve kontrol düzeyi farklıdır. İhtiyacınıza en uygun çözüm için teknik dokümantasyonumuzu inceleyebilir veya Paratika teknik destek ekibiyle iletişime geçebilirsiniz.

Ortak Ödeme Sayfası - HPP

(Browser Redirect)

Hangi entegrasyon modelini tercih ederseniz edin — ister HPP (Ortak Ödeme Sayfası), ister Direct POST - MOTO, ister Direct POST - 3D Secure — tüm süreçlerin başlangıç noktası, müşterinin satın alacağı ürünlerin bir sepet mantığıyla hazırlanması ve bu sepet üzerinden bir SESSIONTOKEN oluşturulmasıdır.

Başlangıç: Panel Erişimi Bilgileri

Başvuru ve İlk Adımları tamamladıktan sonra:

• Üye İşyeri ID’nizi
• API Kullanıcı Adınızı
• API Kullanıcı Şifrenizi

temin etmiş olmanız gerekir. Bu bilgiler, API üzerinden Paratika sistemine güvenli bağlantı kurmak için kullanılacaktır.

Sepet Oluşturma ve SESSIONTOKEN Alma

Kendi web sitenizde veya mobil uygulamanızda müşterinizin alışveriş sepeti oluşturulduktan sonra, ödeme adımına geçmek isteyen müşteri için, bu sepet bilgilerini kullanarak Paratika sisteminde bir işlem başlatmanız gerekir. Bunun için SESSIONTOKEN talebinde bulunulur.

HPP Entegrasyonu Özelinde: SESSIONTOKEN adresinde ayrıntılı olarak belirtildiği gibi, bazı kritik parametreler şunlardır:

• MERCHANTPAYMENTID: Sipariş numarasını temsil eder. Her işlem için benzersiz (unique) bir değer üretilerek gönderilmelidir.
• ORDERITEMS: Sepetteki ürünlerin listesini içerir. JSON formatında hazırlanmalı, gönderim öncesinde encode edilmelidir.
• EXTRA: Eğer işlemle ilgili ek bilgiler gönderilecekse, bu alan da yine encode edilerek iletilmelidir.

SESSIONTOKEN Talebi

Sepet ve müşteri bilgileriyle hazırladığınız SESSIONTOKEN isteğini gönderdiğinizde, başarılı bir yanıt aldığınızda dönen response içinde bir SESSIONTOKEN değeri elde edersiniz. Bu token, ödeme sürecinin ilerleyen adımlarında kullanılacaktır.

Ortak Ödeme Sayfasına Yönlendirme (HPP Kullanımı)

SESSIONTOKEN oluşturulduktan sonra, müşteriyi ödeme işlemi için Paratika'nın ortak ödeme sayfasına yönlendirebilirsiniz. Bu işlem şu şekilde yapılır:

<form action="https://entegrasyon.paratika.com.tr/payment/SESSIONTOKEN" method="post">
  <input type="submit" value="Ödeme Sayfasına Git" />
</form>

Burada SESSIONTOKEN, almış olduğunuz token değeri ile dinamik olarak değiştirilmelidir.

Ortak Ödeme Sayfası (HPP) Yönlendirme Linkleri

Bu yönlendirme sayesinde, müşteriniz güvenli Paratika ödeme sayfasına geçiş yapar ve kredi kartı bilgilerini güvenli ortamda girerek ödeme işlemini tamamlar.

Ödeme sonucunda müşteriniz önce Paratika ortak ödeme sayfasına geri dönecek.

Daha sonrasında ise SESSIONTOKEN yaratımı esnasında vermiş olduğunuz RETURNURL adresine işlem sonucu ile beraber geri yönlendirilecektir.

İşte bu aşamada web siteniz üzerinde gelen cevabı yorumlayarak müşterinize oluşturulmuş siparişini veya başarısız ödeme hakkında bilgilendirme sayfanızı gösterebilirsiniz.

Direct POST

(Browser Redirect)

Direct POST - MOTO (2D) ve Direct POST - 3D Secure entegrasyon modelleri, kart bilgilerinin girildiği ödeme sayfalarının üye iş yeri tarafından tasarlandığı ve host edildiği modellerdir. Bu modellerde, HPP (Barındırılan Ödeme Sayfası) kullanan müşterilerin aksine, ödeme adımında müşteriye gösterilecek sayfa doğrudan üye iş yerinin altyapısında çalışır.

Temel Adımlar: Sepet ve SESSIONTOKEN

Hangi entegrasyon modeli kullanılırsa kullanılsın, süreç her zaman sepet oluşturulması ve SESSIONTOKEN alınmasıyla başlar.

• Sepet Oluşturma:

Müşteri, web sitenizde veya mobil uygulamanızda alışverişini tamamlayıp ödeme adımına geçtiğinde, alınacak ürünler bir sepet mantığında toplanır.

• SESSIONTOKEN Talebi:

Sepet ve müşteri bilgilerini kullanarak Paratika sistemine bir SESSIONTOKEN isteği gönderirsiniz.

Önemli Parametreler:

• MERCHANTPAYMENTID: Sipariş numarasını temsil eder. Her işlem için benzersiz (unique) bir değer gönderilmelidir.
• ORDERITEMS: Sepetteki ürünleri listeleyen JSON formatındaki veri. Gönderilmeden önce encode edilmelidir.
• EXTRA: Ek bilgi gönderilecekse, bu alan da encode edilmelidir.

İstek gönderildiğinde başarılı bir yanıtla birlikte SESSIONTOKEN alınır.

Kart Bilgisi Toplama ve Direct POST İşlemi

SESSIONTOKEN oluşturulduktan sonra:

1. Müşteri, üye iş yerinin host ettiği kendi ödeme sayfasına yönlendirilir.
2. Müşteri kart bilgilerini bu sayfada doldurur.
3. Ardından, form aracılığıyla kart bilgileri ve SESSIONTOKEN bilgisi birlikte Direct POST yöntemiyle Paratika'ya gönderilir.

POST adresleri:

Direct Post - 2D MOTO (Non3D) Yönlendirme Linki

Örnek 2D Ödeme Sayfası Kodu

<!DOCTYPE html>
<html>
  <head>
    <title>Sample POST Form</title>
    <meta charset="utf-8">
    <script>
      function hideCardPANData() {
        if (document.getElementById('isPayWithCardToken').checked) {
          document.getElementById('cardPANData').style.display = 'none';
          document.getElementById('cardTokenContainer').style.display = 'block';
        } else {
          document.getElementById('cardTokenContainer').style.display = 'none';
          document.getElementById('cardPANData').style.display = 'block';
        }
      }
    </script>
    <style type="text/css">
      form {
        display: table;
      }

      p {
        display: table-row;
      }

      label {
        display: table-cell;
      }

      input {
        display: table-cell;
      }
    </style>
  </head>
  <body onload="hideCardPANData();">
    <form action="https://vpos.paratika.com.tr/merchant/post/sale/[SECURE_SESSION_TOKEN]" method="post">
      <div>
        <label for="isPayWithCardToken">Pay with Card Token</label>
        <input type="checkbox" onclick="hideCardPANData();" name="isPayWithCardToken" id="isPayWithCardToken" autocomplete="off" maxlength="32" />
      </div>
      <div class="container">
        <div id="cardPANData">
          <p>
            <label for="cardOwner">Card Owner Name</label>
            <input type="text" name="cardOwner" id="cardOwner" autocomplete="off" maxlength="32" />
          </p>
          <p>
            <label for="pan">Card Number (PAN) </label>
            <input type="text" id="pan" name="pan" autocomplete="off" maxlength="19" />
          </p>
          <p>
            <label for="expiryMonth">Expiration Date</label>
            <select name="expiryMonth" id="expiryMonth">
              <option value="01">January</option>
              <option value="02">February</option>
              <option value="03">March</option>
              <option value="04">April</option>
              <option value="05">May</option>
              <option value="06">June</option>
              <option value="07">July</option>
              <option value="08">August</option>
              <option value="09">September</option>
              <option value="10">October</option>
              <option value="11">November</option>
              <option value="12">December</option>
            </select>
            <select name="expiryYear" id="expiryYear">
              <option value="2016">2016</option>
              <option value="2017">2017</option>
              <option value="2018">2018</option>
              <option value="2019">2019</option>
              <option value="2020">2020</option>
              <option value="2021">2021</option>
              <option value="2022">2022</option>
              <option value="2023">2023</option>
              <option value="2024">2024</option>
              <option value="2025">2025</option>
              <option value="2026">2026</option>
              <option value="2027">2027</option>
              <option value="2028">2028</option>
              <option value="2029">2029</option>
              <option value="2030">2030</option>
              <option value="2031">2031</option>
              <option value="2032">2032</option>
              <option value="2033">2033</option>
              <option value="2034">2034</option>
            </select>
          </p>
          <p>
            <label for="cvv">Security Code (CVV)</label>
            <input type="input" name="cvv" id="cvv" autocomplete="off" maxlength="4" />
          </p>
          <p>
            <label for="saveCard">Save Card</label>
            <input type="checkbox" name="saveCard" id="saveCard" value="YES" />
          </p>
          <p>
            <label for="cardName">Card Name</label>
            <input type="text" name="cardName" id="cardName" />
          </p>
          <p>
            <label for="installmentCount">Installment Count</label>
            <input type="text" name="installmentCount" id="installmentCount" />
          </p>
          <input type="hidden" value="" name="points" id="points" />
          <input type="hidden" value="" name="paymentSystem" id="paymentSystem" />
        </div>
        <div id="cardTokenContainer">
          <p>
            <label for="cardToken">>Card Token</label>
            <input type="text" name="cardToken" id="cardToken" autocomplete="off" maxlength="64" />
          </p>
          <p>
            <label for="installmentCount">Installment Count</label>
            <input type="text" name="installmentCount" id="installmentCount" />
          </p>
        </div>
        <input type="submit" value="Submit" />
    </form>
  </body>
</html>

Direct Post - 3D Yönlendirme Linki

Örnek 3D Ödeme Sayfası Kodu

<!DOCTYPE html>
<html>
  <head>
    <title>Sample POST Form</title>
    <meta charset="utf-8">
    <script>
      function hideCardPANData() {
        if (document.getElementById('isPayWithCardToken').checked) {
          document.getElementById('cardPANData').style.display = 'none';
          document.getElementById('cardTokenContainer').style.display = 'block';
        } else {
          document.getElementById('cardTokenContainer').style.display = 'none';
          document.getElementById('cardPANData').style.display = 'block';
        }
      }
    </script>
    <style type="text/css">
      form {
        display: table;
      }

      p {
        display: table-row;
      }

      label {
        display: table-cell;
      }

      input {
        display: table-cell;
      }
    </style>
  </head>
  <body onload="hideCardPANData();">
    <form action="https://vpos.paratika.com.tr/paratika/api/v2/post/sale3d/[SECURE_SESSION_TOKEN]" method="post">
      <div>
        <label for="isPayWithCardToken">Pay with Card Token</label>
        <input type="checkbox" onclick="hideCardPANData();" name="isPayWithCardToken" id="isPayWithCardToken" autocomplete="off" maxlength="32" />
      </div>
      <div class="container">
        <div id="cardPANData">
          <p>
            <label for="cardOwner">Card Owner Name</label>
            <input type="text" name="cardOwner" id="cardOwner" autocomplete="off" maxlength="32" />
          </p>
          <p>
            <label for="pan">Card Number (PAN)</label>
            <input type="text" id="pan" name="pan" autocomplete="off" maxlength="19" />
          </p>
          <p>
            <label for="expiryMonth">Expiration Date</label>
            <select name="expiryMonth" id="expiryMonth">
              <option value="01">January</option>
              <option value="02">February</option>
              <option value="03">March</option>
              <option value="04">April</option>
              <option value="05">May</option>
              <option value="06">June</option>
              <option value="07">July</option>
              <option value="08">August</option>
              <option value="09">September</option>
              <option value="10">October</option>
              <option value="11">November</option>
              <option value="12">December</option>
            </select>
            <select name="expiryYear" id="expiryYear">
              <option value="2016">2016</option>
              <option value="2017">2017</option>
              <option value="2018">2018</option>
              <option value="2019">2019</option>
              <option value="2020">2020</option>
              <option value="2021">2021</option>
              <option value="2022">2022</option>
              <option value="2023">2023</option>
              <option value="2024">2024</option>
              <option value="2025">2025</option>
              <option value="2026">2026</option>
              <option value="2027">2027</option>
              <option value="2028">2028</option>
              <option value="2029">2029</option>
              <option value="2030">2030</option>
              <option value="2031">2031</option>
              <option value="2032">2032</option>
              <option value="2033">2033</option>
              <option value="2034">2034</option>
            </select>
          </p>
          <p>
            <label for="cvv">Security Code (CVV)</label>
            <input type="input" name="cvv" id="cvv" autocomplete="off" maxlength="4" />
          </p>
          <p>
            <label for="saveCard">Save Card</label>
            <input type="checkbox" name="saveCard" id="saveCard" value="YES" />
          </p>
          <p>
            <label for="cardName">Card Name</label>
            <input type="text" name="cardName" id="cardName" />
          </p>
          <p>
            <label for="installmentCount">Installment Count</label>
            <input type="text" name="installmentCount" id="installmentCount" />
          </p>
          <input type="hidden" value="" name="points" id="points" />
          <input type="hidden" value="" name="paymentSystem" id="paymentSystem" />
        </div>
      </div>
      <div id="cardTokenContainer">
        <p>
          <label for="cardToken">Card Token</label>
          <input type="text" name="cardToken" id="cardToken" autocomplete="off" maxlength="64" />
        </p>
        <p>
          <label for="installmentCount">Installment Count</label>
          <input type="text" name="installmentCount" id="installmentCount" />
        </p>
      </div>
      <input type="submit" value="Submit" />
    </form>
  </body>
</html>

Ödeme Sonuçlarının Alınması

İşlem tamamlandıktan sonra:

• Paratika, ödeme sonucunu (başarılı/başarısız) RETURNURL adresinize POST yöntemi ile gönderir.
• Gelen POST içeriğinde:
• responseCode: 00 ve
• responseMsg: Approved

bilgileri varsa ödeme başarılı olmuş demektir.

Bu adımda işlemin durumuna göre müşteri bilgilendirilmeli ve başarılı işlemlerde sipariş tamamlanmalıdır.

API Entegrasyonu

(Server to Server)

Paratika Sanal POS API’si, iki farklı ortamda hizmet vermektedir. Bu ortamlardan biri entegrasyon amaçlı kullanılırken, diğeri canlı (prodüksiyon) ortamıdır.

Aşağıda her ortam için kullanılacak API ana linkleri belirtilmiştir:

Paratika API POST Linkleri

Önemli: Paratika API’si yalnızca POST methodu ile gönderilen isteklere cevap verir.

API Kimlik Doğrulama Bilgileri

API'yi kullanabilmek için her istekle birlikte üç temel kimlik bilgisi gönderilmelidir:

• Üye İşyeri Numarası → MERCHANT
• API Kullanıcı Adı (E-posta Adresi) → MERCHANTUSER
• API Kullanıcı Şifresi → MERCHANTPASSWORD

Bu bilgileri nasıl temin edebileceğinizi, Başvuru ve İlk Adımlar bölümünde detaylı olarak açıkladık.

API İstekleri bölümünde detaylıca anlatılan değişik istek tiplerini kullanarak Paratika uygulaması ile iletişim kurabilir, DirectPost yöntemi ile kurduğunuz entegrasyonda müşterinize göstermek için gerekli bilgileri (taksit sayıları gibi) alabilir, veya doğrudan server-to-server iletişim ile Satış, Ön otorizasyon, Son Otorizasyon gibi işlemlerinizi gerçekleştirebilirsiniz.

Pazaryeri Modeli

Marketplace

Paratika Pazaryeri (Marketplace) modeli, alıcı ve satıcı arasında aracı (pazaryeri sahibi) rolü üstlenen üye iş yerlerimiz tarafından kullanılmaktadır. Pazaryeri modeliyle çalışan üye iş yerleri, kendi bünyelerinde alt satıcı kullanıcıları oluşturur ve satış işlemleri sırasında bu alt satıcılar adına işlem yapar.

Üye iş yeri, Paratika API’si üzerinden satış işlemi gönderirken; normal satış işlemine ek olarak:

• Satılmakta olan ürünün hangi alt satıcıya ait olduğunu,
• Bu ürün için alt satıcıya aktarılacak tutarı

bize iletmelidir.

Aktarım bilgileri iki şekilde paylaşılabilir:

• Tutar Bazlı: Belirli bir miktar (örnek: 100 TL)
• Oran Bazlı: Belirli bir yüzde oranı (örnek: %15)

Ayrıca pazaryeri sahibi üye iş yerleri, Paratika Sanal POS maliyetlerinin kendilerine mi, yoksa satış yapan alt satıcılara mı yansıtılacağını seçebilirler.

Pazaryeri Süreç Adımları

Pazaryeri modeli de diğer modellerde olduğu gibi aşağıdaki adımlar izlenerek çalışır:

1. Ürünler web sitesinde bir sepette toplanır.
2. Sepet bilgileri kullanılarak SESSIONTOKEN oluşturulur.
3. Ekstra pazaryeri parametreleri ile birlikte satış işlemi başlatılır.

SESSIONTOKEN Oluşturma - Genel Bilgiler

• MERCHANTPAYMENTID: Sipariş numarasıdır ve her zaman eşsiz (unique) bir değer olmalıdır.
• ORDERITEMS: Sepetteki ürünlerin listesidir. JSON formatında hazırlanıp, gönderilmeden önce encode edilmelidir.
• EXTRA: Ek bilgiler gönderilecekse yine JSON formatında encode edilerek gönderilir.

Pazaryeri Modeli: Tutar Bazlı Komisyon Kullanımı

Tutar bazlı pazaryeri modelinde, SESSIONTOKEN oluştururken üç ekstra parametre eklenir:

1. ORDERITEMS içinde:

• sellerId: Ürünün hangi alt satıcıya ait olduğunu belirtir.
• sellerCommissionAmount: Ürün için pazaryeri sahibine aktarılacak komisyon tutarını belirtir.

1. Ana POST body içinde:

• TOTALSELLERCOMMISSIONAMOUNT: Sepetteki ürünlerin toplam komisyon tutarıdır. (Tüm sellerCommissionAmount değerlerinin toplamı)

Örnek Senaryo:

• Ürün Değeri: 1000 TL
• Satıcı: satici-1
• Belirlenen Komisyon Tutarı: 600 TL
• Alt Satıcıya Aktarılacak Tutar: 400 TL

Burada, 1000 TL üzerinden hesaplanan Paratika Sanal POS komisyonunun kime yansıtılacağı (pazaryeri sahibi mi, alt satıcı mı) üye iş yerinin tercihindedir. Bu değişikliği yapmak için destek ekibimize talep ileterek gerekli düzenlemenin yapılmasını sağlayabilirsiniz.

Pazaryeri Modeli: Oran Bazlı Komisyon Kullanımı

Oran bazlı pazaryeri modelinde, SESSIONTOKEN oluştururken yalnızca bir ekstra parametre eklenir:

• sellerId: Ürünün hangi alt satıcıya ait olduğunu belirtir.

Komisyon oranları, üye iş yerinin satıcı tanımlama sürecinde belirlenir. Her alt satıcı için farklı bir oran panel üzerinden tanımlanabilir.

Örnek Senaryo:

• Ürün Değeri: 1000 TL
• Satıcı: satici-2
• Belirlenen Komisyon Oranı: %10

Bu işlem sonucunda:

• Pazaryeri sahibine aktarılacak tutar: 100 TL
• Alt satıcıya aktarılacak tutar: 900 TL

Paratika Sanal POS komisyonu yine üye iş yerinin seçimine göre ilgili tarafa yansıtılabilir. Bu değişikliği yapmak için destek ekibimize talep ileterek gerekli düzenlemenin yapılmasını sağlayabilirsiniz.

Önemli Notlar

• Komisyon tutarları veya oranları, satış öncesinde net şekilde belirlenmelidir.
• ORDERITEMS ve EXTRA alanları her zaman JSON formatında ve encode edilmiş olarak gönderilmelidir.
• API entegrasyon sürecinde entegrasyon ortamı kullanılarak tüm senaryolar önceden denenmelidir.

Satıcı API Aksiyonları

Pazaryeri modelinde çalışan firmalarımız, alt satıcı bilgilerini panelden ekleyebildikleri gibi API aracılığı ile de ekleme, güncelleme ve sorgulama işlemlerini gerçekleştirebilirler. Eklenen her satıcının Paratika tarafında bir onay sürecine gireceğini ve onaylandıktan sonra bu satıcı adına işlem gönderebileceğinizi lütfen unutmayın.

Satıcı Ekleme (SELLERADD)

SELLERADD aksiyonu, pazaryeri yapısında yeni bir satıcının sisteme tanımlanmasını sağlar. Zorunlu alanların yanında TCKN, VKN ve farklı para birimlerine ait IBAN bilgileri gibi opsiyonel bilgiler de gönderilebilir. Satıcı, tanımlandıktan sonra üye işyeri altında ödeme alabilir ve hakediş süreçlerine dahil edilir.

Örnek Kullanım Amacı

Yeni bir satıcıyı sisteme alırken IBAN, ödeme günleri ve komisyon bilgileri ile birlikte ilk tanım bu servis üzerinden yapılır.

SELLERADD isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Satıcı Güncelleme (SELLEREDIT)

SELLEREDIT işlemi, sistemde kayıtlı olan bir satıcının bilgilerinin güncellenmesini sağlar. Bu işlemde SELLERID zorunludur ve sadece gönderilen alanlar güncellenir.

Güncellenebilen Alanlar

• İsim, soyisim
• E-posta, telefon
• Satıcı durumu (STATUS)
• TCKN / VKN
• IBAN ve yabancı para IBAN’ları
• Ödeme günü ve vade bilgileri
• Komisyon bilgileri

Kullanım Amacı

Satıcının IBAN değişikliği, iletişim bilgisi güncellemesi veya statü değişiklikleri (aktif/pasif vb.) için kullanılır.

SELLEREDIT isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Satıcı Sorgulama (QUERYSELLER)

QUERYSELLER aksiyonu, üye işyerine bağlı tüm satıcıların veya belirli bir SELLERID’ye ait satıcının detaylarının sorgulanmasını sağlar.

Filtreleme Parametreleri

• SELLERID: Belirli bir satıcıyı sorgulamak için
• STATUS: Satıcı durumuna göre filtreleme
• ONBEHALFOFMERCHANT: Alt üye işyeri senaryoları için

Cevap İçeriği

Sorgu sonucunda satıcıya ait aşağıdaki bilgiler döner:

• Satıcı kimlik ve iletişim bilgileri
• Satıcı durumu
• IBAN ve hesap sahibi bilgileri
• Bağlı olduğu üye işyeri bilgileri

Genel Kullanım Senaryosu

SELLERADD ile satıcı sisteme tanımlanır, SELLEREDIT ile bilgiler güncellenir ve QUERYSELLER ile satıcı listesi veya detayları sorgulanır. Bu üç servis birlikte pazaryeri satıcı yönetimi, hakediş ve ödeme süreçlerinin temelini oluşturur.

QUERYSELLER isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Manuel POS

Manuel POS, müşterinize ödeme linki göndermek yerine doğrudan kendi ödeme ekranınız üzerinden tahsilat yapmanıza imkân tanıyan bir arayüzdür. Link ile ödeme yönteminden farkı, müşteriye bir bağlantı gönderilmeden ödeme sürecinin doğrudan sizin tarafınızdan yönetilmesidir.

Manuel POS Erişimi

1. Panele giriş yaptıktan sonra, ana menüde yer alan "Manuel POS" butonuna tıklayarak manuel ödeme ekranına ulaşabilirsiniz.

Manuel POS Kullanımı

Manuel POS ekranında aşağıdaki bilgileri doldurmanız gerekir:

• Sipariş Bilgileri: Satılacak ürün veya hizmetin detayları.
• Müşteri Bilgileri: Alıcıya ait ad, soyad, e-posta ve iletişim bilgileri gibi bilgiler.

Gerekli alanlar doğru bir şekilde doldurulduktan sonra ödeme ekranına geçilir.

Ödeme İşlemi

Açılan ödeme sayfası, PCI-DSS standartlarına uygun güvenlik protokolleri ile korunmaktadır. Bu güvenli ödeme formu üzerinden müşteriden kredi kartı bilgileri alınarak tahsilat işlemi güvenli bir şekilde tamamlanır.

Özetle:

• Müşteriye link göndermenize gerek yoktur.
• Ödeme sürecini doğrudan siz yönetirsiniz.
• PCI-DSS uyumlu altyapı ile güvenli tahsilat sağlanır.

API İstekleri

Paratika Sanal POS API’si, iki farklı ortamda hizmet vermektedir. Bu ortamlardan biri entegrasyon amaçlı kullanılırken, diğeri canlı (prodüksiyon) ortamıdır.

Aşağıda her ortam için kullanılacak API ana linkleri belirtilmiştir:

Paratika API POST Linkleri

Önemli: Paratika API’si yalnızca POST methodu ile gönderilen isteklere cevap verir.

API Kimlik Doğrulama Bilgileri

API'yi kullanabilmek için her istekle birlikte üç temel kimlik bilgisi gönderilmelidir:

• Üye İşyeri Numarası → MERCHANT
• API Kullanıcı Adı (E-posta Adresi) → MERCHANTUSER
• API Kullanıcı Şifresi → MERCHANTPASSWORD

Bu bilgileri nasıl temin edebileceğinizi, Başvuru ve İlk Adımlar bölümünde detaylı olarak açıkladık.

API İstekleri bölümünde detaylıca anlatılan değişik istek tiplerini kullanarak Paratika uygulaması ile iletişim kurabilir, DirectPost yöntemi ile kurduğunuz entegrasyonda müşterinize göstermek için gerekli bilgileri (taksit sayıları gibi) alabilir, veya doğrudan server-to-server iletişim ile Satış, Ön otorizasyon, Son Otorizasyon gibi işlemlerinizi gerçekleştirebilirsiniz.

Oturum Anahtarı

• Session Token

Session Token

Paratika ödeme sistemine entegre olmanın ilk adımı, SESSIONTOKEN oluşturulmasıdır. Tüm entegrasyon modelleri – ister Ortak Ödeme Sayfası (HPP), ister Direct POST ya da API tabanlı olsun – bu temel işlem üzerinden başlar.

Web sitenizde ya da mobil uygulamanızda müşterinizin sepetini oluşturduktan sonra, siparişe ait müşteri ve sepet bilgileri ile birlikte Paratika sistemine bir SESSIONTOKEN isteği gönderirsiniz. Bu istek sayesinde:

• Paratika tarafında ilgili sepet ve işlem bilgileri tanımlanır,
• Güvenli bir işlem oturumu başlatılır,
• Takip eden adımlarda kullanılacak ödeme süreci için zemin hazırlanmış olur.

SESSIONTOKEN, ödeme akışınızın geri kalan kısmını yönlendiren benzersiz bir referans anahtardır ve tüm entegrasyon modellerinin temelini oluşturur.

SESSIONTOKEN isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Finansal İşlemler

• Sale: Server-to-Server Ödeme: SALE API Kullanımı
• PreAuth: Ön Otorizasyon (Pre-Authorization) İşlemi
• PostAuth: Son Otorizasyon (Post-Authorization) İşlemi
• İptal (Void): İptal (Void) İşlemi
• İade - Refund: Ücret İadesi (Refund) İşlemi

Sale

Server-to-Server Ödeme: SALE API Kullanımı

Paratika'nın SALE API servisi ile uygulamanız ve Paratika ödeme sistemi arasında server-to-server iletişim kurarak doğrudan ödeme alabilirsiniz.

Süreç Akışı

1. Alışveriş Sepeti Oluşturma:

Öncelikle, müşterinizin satın alacağı ürünler ile bir alışveriş sepeti oluşturmalısınız.

1. SESSIONTOKEN Alma:

Sepet bilgilerini kullanarak Paratika sisteminden bir SESSIONTOKEN talep etmelisiniz. (Detaylar için: Session Token)

1. SALE API Çağrısı Yapma:

• Alınan SESSIONTOKEN ve müşteriden toplanan kart bilgileri ile Paratika'nın SALE API servisine istek yapılır.
• İstek tamamen backend (server-side) üzerinden, doğrudan Paratika sistemine gönderilir.
• Böylece ödeme işlemi kullanıcı tarayıcısına bağlı kalmadan güvenli şekilde tamamlanır.

Önemli Notlar

• SALE API yalnızca POST metodunu destekler.
• İstek yapılırken yetkilendirme için:
• Üye İş Yeri Numarası (MERCHANT)
• API Kullanıcı Adı (MERCHANTUSER)
• API Şifresi (MERCHANTPASSWORD)

bilgileri kullanılmalıdır.

• Kart verileri PCI-DSS uyumluluğuna dikkat edilerek korunmalı ve işlenmelidir.

Kısaca:

• Web veya mobil uygulamanızdan sunucunuz aracılığıyla doğrudan ödeme yapılır.
• Kullanıcı deneyimi hızlıdır; kullanıcı ödeme için farklı bir sayfaya yönlendirilmez.
• Tam kontrol ve esneklik sağlar.

SALE isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

PreAuth

Ön Otorizasyon (Pre-Authorization) İşlemi

Ön Otorizasyon işlemi, müşterinin kredi kartı üzerinde belirli bir tutar için bloke konulmasını sağlar. Bu işlem sonucunda karttan doğrudan bir tahsilat yapılmaz; yalnızca belirtilen tutar, müşterinin kart kullanım limitinden düşülerek bloke edilir.

Ön otorizasyon işlemi ile oluşturulan bloke, bankanın politikalarına bağlı olarak değişkenlik göstermektedir. Bloke süresi bazı bankalarda üç gün gibi kısa bir süre olabilirken, bazı durumlarda birkaç aya kadar uzayabilmektedir.

Üye iş yerlerinin finansal risklerini en aza indirmek adına, ön otorizasyon onayı alınmış işlemlerde:

• Ürün veya hizmet teslimatlarının mümkün olan en kısa sürede gerçekleştirilmesi,
• Teslimat sonrası Son Otorizasyon (Capture) işleminin ivedilikle yapılması

tavsiye edilmektedir.

Bu yaklaşım, bloke süresi sona ermeden tahsilatın güvence altına alınmasını sağlar ve olası gelir kayıplarının önüne geçer.

PREAUTH isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

PostAuth

Son Otorizasyon (Post-Authorization) İşlemi

Son Otorizasyon (Post-Authorization) işlemi, daha önce Ön Otorizasyon (Pre-Authorization) yoluyla rezerve edilen tutarın, müşterinin kredi kartından tahsil edilmesini sağlar. Bu işlem, önceden bloke edilen tutarın gerçek satış işlemi olarak tamamlanması anlamına gelir.

Son Otorizasyon sırasında, aşağıdaki kurallar dikkate alınmalıdır:

• Ön Otorizasyon tutarından daha yüksek bir tahsilat talep edilirse, işlem kart düzenleyici tarafından reddedilebilir.
• Daha düşük bir tutar talep edilmesi halinde, yalnızca belirtilen daha küçük tutar müşterinin kartından tahsil edilir ve kalan bakiye üzerindeki bloke serbest bırakılır.

Son Otorizasyon işlemi, Ön Otorizasyon gerçekleştirilmesini takiben belirli bir süre içinde tamamlanmalıdır. Bu süre, kartı çıkaran bankanın politikalarına bağlı olarak 3 gün ile 75 gün arasında değişiklik gösterebilir.

İşlemlerin güvenliği ve finansal akışın kesintisiz devamı için, ön otorizasyon sonrasında mümkün olan en kısa sürede Son Otorizasyon işleminin gerçekleştirilmesi önerilmektedir.

POSTAUTH isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

İptal (Void)

İptal (Void) İşlemi

İptal işlemi (Void), başta satış ve ön otorizasyon olmak üzere, gerçekleştirilen diğer işlemleri geriye dönük olarak iptal etmek amacıyla kullanılır.

Bir işlemin başarıyla iptal edilebilmesi için, söz konusu işlemin kartı düzenleyen banka (Issuer) tarafında gerçekleştirilen Gün Sonu Mutabakatı (End of Day Settlement) sürecine dâhil olmamış olması gerekir.

Gün Sonu Mutabakatı, bir iş gününün sonunda yapılan ve o gün içerisinde gerçekleşen tüm işlemlerin toplu olarak bankalar arasında mutabakata varıldığı süreçtir. Bu süreç tamamlandığında, ödeme tutarı, kart sahibinin hesabından çekilerek üye iş yerinin banka hesabına aktarılır.

Eğer iptal talebinde bulunulan işlem, mutabakat sürecinde tamamlanmışsa, iptal isteği başarısız olur ve sistem tarafından bir hata kodu döndürülür. Bu durumda, işlemi iptal etmek yerine, iade (refund) işlemi başlatmanız gerekecektir.

Özetle:

• Mutabakat öncesi: İşlem iptal edilebilir (Void).
• Mutabakat sonrası: İşlem iade edilmelidir (Refund).

VOID isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

İade - Refund

Ücret İadesi (Refund) İşlemi

Ücret iadesi işlemi, sistemde mevcut bir siparişe ait bakiyenin müşterinin kredi kartına kısmen veya tamamen iade edilmesini sağlar. Bir ödeme işleminin iadesini gerçekleştirebilmek için, ilgili işlemin işlem numarasına (MERCHANTPAYMENTID) ihtiyaç vardır. Bu numara, rapor ekranları veya API sorgulamaları üzerinden temin edilebilir.

Eğer bir siparişin tüm tutarı iade edilirse, siparişin ödeme bakiyesi sıfırlanır.

Önemli Notlar:

• İade işlemi yalnızca gün sonu mutabakatı tamamlanmış işlemler için gerçekleştirilebilir.
• Eğer ilgili işlem henüz gün sonu mutabakatına dahil edilmemişse, iade yerine iptal (void) işlemi uygulanmalıdır.

Bu kurgu, işlem akışlarının doğru yönetilmesi ve muhasebe kayıtlarının düzenli tutulması açısından büyük önem taşır.

REFUND isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Sorgulama Servisleri

• İşlem Sorgulama: QUERYTRANSACTION Servisi
• Taksit Bilgisi Sorgulama: QUERYINSTALLMENT Servisi
• Kayıtlı Kart Bilgisi Sorgulama: QUERYCARD Servisi
• BIN Bilgisi Sorgulama: QUERYBIN Servisi
• Üye İş Yeri (Merchant) Komisyon Sorgulama: QUERYMERCHANTCOMMISSION Servisi
• Kart Sahibi (Customer) Komisyon Sorgulama: QUERYCUSTOMERCOMMISSION Servisi
• Üye İş Yeri Mutabakat Raporu Sorgulama: QUERYMERCHANTRECONCILIATION Servisi
• Satıcı (Seller) Mutabakat Raporu Sorgulama: QUERYSELLERRECONCILIATION Servisi

İşlem Sorgulama

QUERYTRANSACTION Servisi

İşlem Sorgulama (QUERYTRANSACTION) servisi, belirli bir sipariş numarası (MerchantPaymentID) veya işlem numarası (PGTranID) üzerinden ilgili ödeme işleminin detaylarına erişim sağlar. Bu servis aracılığıyla, söz konusu işleme ait:

• Ödeme durumu (başarılı, başarısız, beklemede vb.),
• Taksit sayısı,
• Uygulanan faiz oranı ve diğer ödeme detayları

görüntülenebilir.

Bankaların ödeme işlemlerine yanıt verme süresi azami 90 saniyeye kadar sürebilmektedir. Eğer üye iş yeri olarak kendi tarafınızda bu sürenin altında bir timeout değeri belirlediyseniz, işlem sonucunu kesinleştirmek için QUERYTRANSACTION servisini entegre etmeniz büyük önem taşır.

Bu servis, bankadan yanıt alınamayan veya gecikmeli yanıt alınan durumlarda, işlemin Paratika Ödeme Sistemi üzerindeki güncel durumunun sorgulanmasına ve bu sayede ERP veya diğer iş sistemlerinizin doğru şekilde güncellenmesine olanak tanır.

İş süreçlerinin kesintisiz devamı ve ödeme akışının sağlıklı bir şekilde yönetilmesi için QUERYTRANSACTION servisi kullanımının entegrasyonlarda zorunlu olarak değerlendirilmesi önerilmektedir.

QUERYTRANSACTION isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Taksit Bilgisi Sorgulama

QUERYINSTALLMENT Servisi

QUERYINSTALLMENT servisi, üye iş yerinin kullanımına açık olan ve sistemde tanımlı tüm taksit seçeneklerini sorgulamak için kullanılır. Bu servis, özellikle ödeme sayfasında kart bilgisi girilmeden önce veya BIN bazlı taksit seçeneklerini göstermek amacıyla tercih edilir.

Servis çağrısı sonucunda;

• İlgili ödeme sistemleri (vPOS / banka)
• Her ödeme sistemi için geçerli taksit sayıları
• Taksitlere ait kart sahibi müşteriye yansıttığınız ek komisyon oranları

bilgileri dönülür.

QUERYINSTALLMENT servisi, esnek ödeme altyapısı kurmak isteyen üye iş yerleri için kritik bir servistir. Doğru parametrelerle çağrıldığında, kart sahibine en uygun taksit seçeneklerinin hızlı ve güvenilir şekilde sunulmasını sağlar.

QUERYINSTALLMENT isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Kayıtlı Kart Bilgisi Sorgulama

QUERYCARD Servisi

QUERYCARD servisi, bir kart sahibine (müşteri) ait sistemde daha önce kaydedilmiş kartların sorgulanması veya belirli bir CARDTOKEN değerine ait kart detaylarının alınması veya belirli bir müşteriye (CUSTOMER) ait kayıtlı kartların sorgulanması amacıyla kullanılır.

Bu servis sayesinde;

• Bir müşteriye (CUSTOMER) ait tüm kayıtlı kartlar listelenebilir
• Belirli bir kart token’ına (CARDTOKEN ) ait detaylı kart bilgileri görüntülenebilir
• Customer veya CardToken parametreleri gönderilmez ise üye iş yerine ait tüm müşterilerin kaydedilmiş kartları listenebilir.

• CARDTOKEN gönderilirse, sadece ilgili karta ait bilgiler döndürülür.
• CARDTOKEN gönderilmezse, CUSTOMER parametresi ile müşteriye ait tüm kayıtlı kartlar listelenir.
• Kart numarası (PAN) tam haliyle hiçbir zaman dönülmez, maskeleme uygulanır.
• CUSTOMER alanı üye iş yeri tarafında tekil (unique) olmalıdır.

QUERYCARD servisi, PCI-DSS uyumlu şekilde kart verilerinin tokenize edilerek güvenli biçimde yönetilmesini sağlar. Kayıtlı kart deneyimi sunmak isteyen üye iş yerleri için temel ve kritik bir servistir.

QUERYCARD isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

BIN Bilgisi Sorgulama

QUERYBIN Servisi

QUERYBIN servisi, kredi veya banka kartına ait BIN (Bank Identification Number) bilgilerini sorgulamak için kullanılır. Bu servis sayesinde kartın hangi bankaya ait olduğu, kart tipi, kart ağı, sanal kart durumu ve özel kart segment bilgileri öğrenilebilir.

QUERYBIN servisi;

• Kart bilgisi girilmeden önce BIN bazlı yönlendirme
• Taksit, kampanya ve ödeme yöntemi uygunluk kontrolü
• Kayıtlı kart (token) üzerinden kart bilgisi çözümleme

amaçlarıyla kullanılır.

• BIN veya CARDTOKEN parametrelerinden en az biri zorunludur.
• CARDTOKEN gönderilmesi durumunda, sistem ilgili karttan BIN bilgisini çözer.
• Kart numarasının tamamı hiçbir zaman sistem dışına çıkarılmaz.
• 6 haneli veya 8 haneli BIN desteklenmektedir.

QUERYBIN servisi, ödeme akışının erken aşamasında kartın özelliklerini tespit ederek doğru yönlendirme ve kullanıcı deneyimi sağlamak için kritik öneme sahiptir. Taksit, kampanya ve özel kart senaryolarında temel bir yapı taşıdır.

📌 BIN bilgileri bankalar tarafından güncellenebilir veya değiştirilebilir. Bu nedenle, söz konusu bilgilerin doğruluğu ve güncelliği Paratika’nın sorumluluğunda değildir. Destek için <destek@paratika.com.tr> adresi ile iletişime geçebilirsiniz.

QUERYBIN isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Üye İş Yeri (Merchant) Komisyon Sorgulama

QUERYMERCHANTCOMMISSION Servisi

QUERYMERCHANTCOMMISSION servisi, üye iş yerinin Paratika sisteminde tanımlı olan komisyon oranlarını sorgulamak için kullanılır.

Bu servis ile;

• Üye iş yerinin varsayılan komisyon oranları
• Ödeme sistemi (vPOS) bazlı özel komisyonlar
• Taksit bazlı komisyon kırılımları
• Para birimi bazlı gelişmiş komisyon tanımları
• Ödeme vadesi ve ödeme günleri

tek bir çağrı ile alınabilir.

Kullanım Senaryoları

• Üye iş yeri komisyon oranlarının backend’den dinamik alınması
• Taksit maliyeti hesaplama
• Ödeme sistemi bazlı kâr/zarar analizi
• Çoklu para birimi ile çalışan üye iş yerleri

QUERYMERCHANTCOMMISSION servisi, üye iş yerinin tüm komisyon yapılarını merkezi ve tutarlı şekilde sunar. Özellikle çoklu vPOS, çoklu para birimi ve karmaşık komisyon modelleri kullanan üye iş yerleri için kritik bir servistir.

QUERYMERCHANTCOMMISSION isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Kart Sahibi (Customer) Komisyon Sorgulama

QUERYCUSTOMERCOMMISSION Servisi

QUERYCUSTOMERCOMMISSION servisi, üye iş yerinin müşterilerine yansıttığı müşteri maliyet komisyon (customer cost commission) şemasını sorgulamak için kullanılır.

Bu servis ile;

• Müşteriye yansıtılan taksitli ödeme komisyon oranları
• Varsayılan (DEFAULT) müşteri komisyonları
• Ödeme sistemi (vPOS) bazlı özel müşteri komisyonları
• Belirli bir tarih itibarıyla geçerli olan komisyon şeması

tek bir çağrı ile elde edilebilir.

Aktivasyon tarihi gönderilmezse güncel (aktif) müşteri komisyon şeması döndürülür.

QUERYMERCHANTCOMMISSION ile Farkı

Kullanım Senaryoları

• Ödeme ekranında müşteriye taksitli fiyat farkını göstermek
• Taksitli satışlarda toplam tutar hesaplama
• Kampanya ve promosyon dönemlerinde müşteri maliyet kontrolü

QUERYCUSTOMERCOMMISSION servisi, müşteri tarafında şeffaf ve doğru fiyatlama yapılmasını sağlar. Özellikle taksitli ödeme sunan üye iş yerleri için kullanıcı deneyimi ve mevzuat uyumu açısından kritik öneme sahiptir.

QUERYCUSTOMERCOMMISSION isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Panel Üzerinden Kart Sahibi (Customer) Komisyon Oranı Girişi

Panel üzerinden kart sahibi (customer) komisyon girişi yapmak için üst menüden Komisyon Yönetimi → Müşteri Maliyet Yansıtma Yönetimi alanına girilir. Açılan ekranda oluşturulacak komisyon şablonunun hangi tarihten itibaren geçerli olacağı Aktivasyon Tarihi alanından seçilir.

Alt kısımda yer alan tabloda her bir taksit sayısı için müşteri tarafından ödenecek komisyon oranı Kart Sahibine Maliyeti alanına girilir. Bu alana yazılan oran, ödeme sırasında komisyonun müşteriye yansıtılmasını ifade eder.

Tüm oranlar girildikten sonra Kaydet butonuna basılarak şablon kaydedilir. Kaydedilen bu müşteri komisyonları, ödeme sayfasında uygulanır ve aynı zamanda QUERYCUSTOMERCOMMISSION API çağrısı ile sorgulanabilir hale gelir.

Üye İş Yeri Mutabakat Raporu Sorgulama

QUERYMERCHANTRECONCILIATION Servisi

QUERYMERCHANTRECONCILIATION aksiyonu kullanılarak üye işyerlerine ait mutabakat (reconciliation) raporları sorgulanır.

Bu servis aracılığıyla:

• Üye işyerine ait finansal işlem raporları alınır.
• Merchant kullanıcıları yalnızca kendi üye işyeri verilerini görüntüleyebilir.
• Tarih, işlem tipi, sipariş numarası, onay kodu gibi birçok kritere göre filtreleme yapılabilir.

Tarih Formatları

Tüm tarih alanları aşağıdaki formatta gönderilmelidir:

dd-MM-yyyy HH:mm:ss

Örnek:

25-12-2025 23:59:59

Sayfalama (Pagination)

Büyük veri setleri için OFFSET ve LIMIT parametreleri kullanılır.

• OFFSET: Kaçıncı kayıttan başlanacağını belirtir
• LIMIT: Maksimum döndürülecek kayıt sayısı

Örnek:

• İlk sayfa: OFFSET=0, LIMIT=1000
• İkinci sayfa: OFFSET=1000, LIMIT=1000

Notlar

• Tarih filtreleri birlikte kullanılmalıdır (STARTDATE & ENDDATE önerilir).
• Merchant kullanıcıları yalnızca kendi işlemlerini görüntüleyebilir.
• LIMIT değeri sistem performansı için mümkün olduğunca düşük tutulmalıdır.

QUERYMERCHANTRECONCILIATION isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Satıcı (Seller) Mutabakat Raporu Sorgulama

QUERYSELLERRECONCILIATION Servisi

QUERYSELLERRECONCILIATION aksiyonu kullanılarak satıcılara (seller) ait mutabakat (reconciliation) raporları sorgulanır.

Bu servis özellikle Pazaryeri modelinde çalışan üye işyerleri için tasarlanmıştır.

Bu servis ile:

• Satıcı bazlı finansal işlem raporları elde edilir.
• Pazaryeri üye işyerleri yalnızca kendi satıcı verilerini görüntüleyebilir.
• İşlemler tarih, işlem tipi, sipariş numarası ve onay kodu gibi kriterlerle filtrelenebilir.

Tarih Formatları

Tüm tarih alanları aşağıdaki formatta gönderilmelidir:

dd-MM-yyyy HH:mm:ss

Örnek:

01-08-2025 00:00:00

Sayfalama (Pagination)

Yüksek hacimli raporlar için OFFSET ve LIMIT parametreleri kullanılmalıdır.

• OFFSET: Başlangıç kayıt numarası
• LIMIT: Maksimum kayıt sayısı

Örnek kullanım:

• Sayfa 1 → OFFSET=0, LIMIT=1000
• Sayfa 2 → OFFSET=1000, LIMIT=1000

Notlar

• STARTDATE ve ENDDATE birlikte kullanılması önerilir.
• Satıcı ödeme tarihleri epoch (timestamp) formatında dönebilir.
• LIMIT değeri performans açısından kontrollü kullanılmalıdır.

QUERYSELLERRECONCILIATION isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Tekrarlı Ödeme İşlemleri

Tekrarlı ödeme planları, belirli bir tutarın önceden tanımlanmış sıklık ve tekrar sayısına göre otomatik olarak tahsil edilmesini sağlar. Bu yapı özellikle abonelik, üyelik, taksitli hizmet bedelleri ve periyodik ödemeler için kullanılır.

API üzerinde bu işlemler aşağıdaki aksiyonlar ile gerçekleştirilir:

• RECURRINGPLANADD – Tekrarlı ödeme planı oluşturma
• RECURRINGPLANEDIT – Mevcut tekrarlı ödeme planını veya ödemeyi güncelleme
• QUERYRECURRINGPLAN – Tekrarlı ödeme planı sorgulama

Tekrarlı Ödeme Planı Ekleme

Aksiyon

RECURRINGPLANADD

Bu aksiyon, belirli bir tutar için farklı zamanlarda çalışacak planlanmış ödemeler grubunu oluşturmak için kullanılır.

RECURRINGPLANADD isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Tekrarlı Ödeme Planı Güncelleme

Aksiyon

RECURRINGPLANEDIT

Bu aksiyon ile;

• Tekrarlı ödeme planının durumu
• Kart bilgileri
• Ödeme tutarı
• Ödeme sistemi
• Tekil bir tekrarlı ödemenin başlangıç tarihi veya tutarı

güncellenebilir.

RECURRINGPLANEDIT isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

Tekrarlı Ödeme Planı Sorgulama

Aksiyon

QUERYRECURRINGPLAN

QUERYRECURRINGPLAN isteği aşağıdaki istek alanlarını beklemektedir.

POST https://entegrasyon.paratika.com.tr/paratika/api/v2

• RECURRINGPLANCODE ve CUSTOMER alanları sistem genelinde tekil olmalıdır.

Tarım Kart Entegrasyonu

Tarım Kart işlemleri; DenizBank, İş Bankası, Kuveyt Türk, Şekerbank, TEB ve VakıfBank tarafından sunulan tarımsal kartlar ile yapılan, ödemesi ileri tarihli (ötelemeli) satış işlemlerini kapsamaktadır.

Tarım Kart ile işlem gerçekleştirebilmek için öncelikle satış temsilciniz ile iletişime geçerek üye işyerinizin “Tarım Üye İşyeri” olarak tanımlanması gerekmektedir. Bu tanımlama tamamlandıktan sonra:

• HPP (Hosted Payment Page)
• Web Servis (API)

entegrasyonları üzerinden Tarım Kart işlemleri gerçekleştirilebilir.

📌 Desteklenen öteleme ay seçenekleri banka bazında değişiklik gösterebilir. Kullanılabilir öteleme süreleri için <destek@paratika.com.tr> adresi ile iletişime geçilmelidir.

Satış İşlemi (SALE)

Satış işlemi, müşterinin Tarım Kartı ile gerçekleştirdiği ve ödemesi belirlenen vade sonunda tahsil edilen işlemdir. Bankaya göre aşağıdaki EXTRA parametreleri gönderilmelidir.

DenizBank

DenizBank Tarım Kart işlemleri için aşağıdaki parametreler zorunludur:

• DenizbankAgriculture.AgricultureTxnFlag → Sabit olarak T gönderilmelidir
• DenizbankAgriculture.PaymentFrequency → Öteleme ay sayısı
• DenizbankAgriculture.MaturityPeriod → Öteleme ay sayısı

EXTRA: {
  "DenizbankAgriculture.PaymentFrequency": "3",
  "DenizbankAgriculture.MaturityPeriod": "3",
  "DenizbankAgriculture.AgricultureTxnFlag": "T"
}

İş Bankası

İş Bankası Tarım Kart işlemlerinde:

• IMCKOD → Ürün tipi
• FDONEM → Öteleme ay sayısı

IMCKOD aşağıdaki değerlerden biri olarak gönderilmelidir:

EXTRA: {
  "IMCKOD": "5",
  "FDONEM": "1"
}

Kuveyt Türk

Kuveyt Türk Tarım Kart işlemlerinde:

• KUVEYTURK.DEFERRINGCOUNT → Öteleme ay sayısı

EXTRA: {
  "KUVEYTURK.DEFERRINGCOUNT": "3"
}

Şekerbank

Şekerbank Hasat Kart işlemleri için aşağıdaki alanlar gönderilmelidir:

EXTRA: {
  "HASATKARTSATIS": "",
  "VADEKODU": "01",
  "VADEADEDI": "5",
  "URUNKODU": "B0",
  "PLASIYERNO": "123456",
  "FATURANO": "0000012345"
}

TEB

TEB Harman Kart işlemleri için herhangi bir ekstra parametre gönderilmesine gerek yoktur.

VakıfBank

VakıfBank Tarım Kart işlemleri için:

• TransactionType → TKSale
• MaturityPeriod → Öteleme ay sayısı
• Frequency → Öteleme ay sayısı

EXTRA: {
  "VakifbankAgriculture.TransactionType": "TKSale",
  "VakifbankAgriculture.CustomInstallments": {
    "VakifbankAgriculture.MaturityPeriod": "2",
    "VakifbankAgriculture.Frequency": "2"
  }
}

Satış İşlemi – Örnek İstek

ACTION:SALE
MERCHANT:[MERCHANT]
MERCHANTUSER:[MERCHANTUSER]
MERCHANTPASSWORD:[MERCHANTPASSWORD]
AMOUNT:100
CURRENCY:TRY
MERCHANTPAYMENTID:[BENZERSIZ_SIPARIS_NUMARASI]
CUSTOMER:[CUSTOMER]
CUSTOMEREMAIL:[CUSTOMEREMAIL]
CUSTOMERNAME:[CUSTOMERNAME]
CUSTOMERPHONE:[CUSTOMERPHONE]
CUSTOMERIP:[CUSTOMERIP]
CARDPAN:4410777076266435
CARDEXPIRY:08.27
CARDCVV:000
NAMEONCARD:[NAMEONCARD]
EXTRA:{"IMCKOD":"5","FDONEM":"1"}

Satış İşlemi – Örnek Cevap

{
  "action": "SALE",
  "merchant": "10005448",
  "amount": 100.00,
  "currency": "TRY",
  "pgTranReturnCode": "00",
  "responseCode": "00",
  "responseMsg": "Approved"
}

Oturum (SESSIONTOKEN)

Tarım Kart işlemleri HPP entegrasyonunda da desteklenmektedir. Oturum anahtarı;

• Tarayıcı bazlı
• API bazlı

entegrasyonlarda kullanılabilir.

Oturum anahtarı aşağıdaki koşullarda aynı MERCHANTPAYMENTID ile tekrar kullanılabilir:

• İşlem henüz tamamlanmamışsa
• Oturum süresi dolmamışsa
• Tutar, müşteri, para birimi gibi ana değişkenler değişmemişse

Oturum – Örnek İstek

ACTION:SESSIONTOKEN
SESSIONTYPE:PAYMENTSESSION
MERCHANT:[MERCHANT]
MERCHANTUSER:[MERCHANTUSER]
MERCHANTPASSWORD:[MERCHANTPASSWORD]
RETURNURL:https://test.merchantsafeunipay.com/merchant/index.jsp
MERCHANTPAYMENTID:[MERCHANTPAYMENTID]
AMOUNT:150
CURRENCY:TRY
CUSTOMER:[CUSTOMER]
CUSTOMEREMAIL:[CUSTOMEREMAIL]
CUSTOMERIP:[CUSTOMERIP]
EXTRA:{"IMCKOD":"5","FDONEM":"4"}

İade (REFUND)

Tarım Kart işlemlerinde iade işlemleri için ekstra parametre gönderilmesine gerek yoktur.

İptal (VOID)

Tarım Kart işlemlerinde iptal işlemleri için ekstra parametre gönderilmesine gerek yoktur.

Alışveriş Kredisi Entegrasyonu

Alışveriş Kredisi İşlemleri

Alışveriş Kredisi, müşterilerin sepet tutarını banka veya finans kuruluşları aracılığıyla kredi başvurusu yaparak ödeyebilmelerini sağlayan bir ödeme yöntemidir. Paratika üzerinden Alışveriş Kredisi işlemleri iki farklı entegrasyon modeli ile sunulmaktadır:

1️⃣ Ortak Ödeme Sayfası (HPP – Hosted Payment Page)

2️⃣ Direct POST (Direct Post)

Ortak Ödeme Sayfası (HPP) ile Alışveriş Kredisi

Ortak ödeme sayfasını (HPP) kullanan üye işyerleri, ödeme linki oluşturma ekranında Alışveriş Kredisi seçeneğini aktif ederek bu ödeme yöntemini son kullanıcılarına ek bir geliştirme yapmadan sunabilirler.

• Alışveriş Kredisi seçeneği, HPP üzerinde diğer ödeme yöntemleriyle birlikte listelenir.
• Müşteri, ödeme sayfasında Alışveriş Kredisi’ni seçerek ilgili banka / finans kuruluşunun kredi başvuru adımlarına yönlendirilir.
• Kredi başvuru ve sonuç süreci Paratika ve ilgili banka altyapıları üzerinden yönetilir.

📌 HPP entegrasyonunda Alışveriş Kredisi için üye işyerinin ayrıca Direct POS geliştirmesi yapmasına gerek yoktur. Alışveriş Kredisi özelliğinin hesabınızda aktive edilmesi için Satış Temsilciniz ile iletişime geçilmesi gerekmektedir.

Direct POST ile Alışveriş Kredisi

Bu entegrasyon modeli, kendi ödeme sayfasını geliştiren ve yöneten üye işyerleri için tasarlanmıştır. Paratika bu modelde son kullanıcıya yönelik görsel arayüz (HPP) sunmaz.

Direct POST modelinin temel özellikleri:

• Ödeme ekranları üye işyeri tarafından tasarlanır ve yönetilir.
• Üye işyeri, kendi bünyesinde tasarladığı ödeme sayfası üzerinden müşterilerine; ister kredi kartı bilgilerini girebilecekleri bir ödeme formu, isterse Paratika aracılığıyla aktif edilmiş Alışveriş Kredisi ödeme yöntemlerini alternatif olarak sunabilir.
• İşlem, doğrudan Paratika sistemlerine HTTP POST yöntemiyle iletilir.

SESSIONTOKEN Oluşturma

Alışveriş Kredisi işlemlerinde Direct POS kullanılabilmesi için, aşağıdaki parametreler ile SESSIONTOKEN oluşturulması gerekmektedir.

Zip Alışveriş Kredisi için örnek Extra Parametreleri:

Zip.type:"cellphone"
Zip.type:"tablet"
Zip.type:"computer"
Zip.type:"sku"

Sessiontoken extra:
EXTRA:{"ZIP_LOAN":"YES", "Zip.items":[{"Zip.name": "iPhone 12 Pro Max 128GB Mavi Cep Telefonu", "Zip.type": "cellphone", "Zip.quantity": 1, "Zip.amount": 800.0}, {"Zip.name": "Samsung Galaxy Tab S9 Tablet", "Zip.type": "tablet", "Zip.quantity": 1, "Zip.amount": 300.0}, {"Zip.name": "Apple Macbook Pro", "Zip.type": "computer", "Zip.quantity": 1, "Zip.amount": 100.0}, {"Zip.name": "Tişört", "Zip.type": "sku", "Zip.quantity": 1, "Zip.amount": 50.0}]}

NKolay Alışveriş Kredisi için Extra Parametreleri:

NKOLAY_LOAN - NKolay alışveriş kredisi için aşağıdaki alanlar kullanılmalıdır ve tüm alanlar gereklidir. NKOLAY_LOAN parametresi "YES" gönderilmesi gerekmektedir.
NKolay.categoryId:1   NKolay.categoryName:Bilgisayar
NKolay.categoryId:2   NKolay.categoryName:Tablet
NKolay.categoryId:3   NKolay.categoryName:Cep Telefonu
NKolay.categoryId:4   NKolay.categoryName:Altın

Sessiontoken extra:
EXTRA:{"NKOLAY_LOAN":"YES", "NKolay.identityNumber":"45461453248", "NKolay.products": [{"NKolay.name": "phone","NKolay.categoryId": 3,"NKolay.categoryName": "Cep Telefonu", "NKolay.quantity": 1,"NKolay.totalPrice": 800}]}

Alışveriş Kredisi – Direct POS Akış Adımları

Adım 1 Üye işyeri, işlem ve sipariş bilgilerini içeren oturum anahtarı (Session Token) isteğini Paratika’ya gönderir.

Adım 2 SESSIONTOKEN isteği işlenir ve tüm veriler geçerli ise oturum anahtarı üye işyerine döndürülür.

Adım 3 Üye işyeri, aldığı sessionToken bilgisi ile kendi web sayfasında veya uygulamasında ödeme/kredi başvuru formunu oluşturur.

Adım 4 Müşteri, üye işyeri sayfasında yer alan formu doldurarak kredi başvurusunu başlatır. Formdaki tüm alanlar doğrudan Paratika sistemlerine POST edilir.

Adım 5 Paratika, gelen işlem ve kredi başvuru bilgilerini ilgili banka veya ödeme kuruluşuna iletir.

Adım 6 Müşteri, banka veya finans kuruluşu tarafından sunulan adımları tamamlayarak kredi başvurusunu sonuçlandırır.

Adım 7 Banka / ödeme kuruluşu kredi sonucunu Paratika’ya iletir ve işlem sonucu üye işyerine bildirilir.

Direct POST – Test HTML Formu

Aşağıdaki örnek HTML formunda yer alan alanların gönderilmesi zorunludur.

📌 paymentSystem alanı, kullanılacak Alışveriş Kredisi sağlayıcısını ifade eder ve destek ekibinden talep edilmelidir. 📧 Destek İletişim: destek@paratika.com.tr

<!DOCTYPE html>
<html>
  <head>
    <title>Sample POST Form</title>
    <meta charset="utf-8">
    <style type="text/css">
      form { display: table; }
      p { display: table-row; }
      label { display: table-cell; }
      input { display: table-cell; }
    </style>
  </head>

  <body>
    <form action="https://vpos.paratika.com.tr/payment/startonlineshoppingloan" method="post">
      <input type="text" name="sessionToken" value="[SESSIONTOKEN]" />
      <input type="text" name="paymentSystem" value="ZIP" />
      <input type="submit" value="Submit" />
    </form>
  </body>
</html>

Test Kartları