> 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/pazaryeri-modeli.md).

# Pazaryeri Modeli

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.
2. **Ana POST body** içinde:
   * `TOTALSELLERCOMMISSIONAMOUNT`: Sepetteki ürünlerin toplam komisyon tutarıdır. (Tüm `sellerCommissionAmount` değerlerinin toplamı)

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

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

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

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

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

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