> For the complete documentation index, see [llms.txt](https://docs.paratika.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paratika.com.tr/entegrasyon/alisveris-kredisi-entegrasyonu.md).

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

<figure><img src="/files/1EL3Ldpn0TLz4880pSpt" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/HbKtIGUgoKghFFgbG2Id" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/8exFMauMEKLGy3Or6YDs" alt=""><figcaption></figcaption></figure>

***

### 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`

```html
<!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>
```

***