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

| Parametre                                                                                                                                                  | Açıklama                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MERCHANT                                                                                                                                                   | Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir.                                                                                                           |
| MERCHANTUSER                                                                                                                                               | Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir.                                                                                                              |
| MERCHANTPASSWORD                                                                                                                                           | Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir.                                                                                                                     |
| ACTION                                                                                                                                                     | Bu istek tipi için **SESSIONTOKEN** olarak gönderilmelidir.                                                                                                                                  |
| SESSIONTYPE                                                                                                                                                | Bu istek tipi için **PAYMENTSESSION** olarak gönderilmelidir.                                                                                                                                |
| RETURNURL                                                                                                                                                  | Ödeme işleminin bitişinden sonra, browser redirect bir entegrasyon modeli (Ortak Ödeme Sayfası HPP veya Direct Post) ile ödeme aldıysanız, işlem sonucunun size geri döndürüleceği adrestir. |
| MERCHANTPAYMENTID                                                                                                                                          | Sipariş numarasıdır ve unique bir değer gönderilmelidir.                                                                                                                                     |
| AMOUNT                                                                                                                                                     | İşlem tutarı gönderilmelidir.                                                                                                                                                                |
| CURRENCY                                                                                                                                                   | İşlem para birimi gönderilmelidir.                                                                                                                                                           |
| ORDERITEMS                                                                                                                                                 | <p>Sepet bilgileri gönderilmelidir. Örnek olarak:<br><br>\[                                                                                                                                  |
| <br>{                                                                                                                                                      |                                                                                                                                                                                              |
| <br>"productCode": "T00D3AITCC",                                                                                                                           |                                                                                                                                                                                              |
| <br>"name": "Galaxy Note 3",                                                                                                                               |                                                                                                                                                                                              |
| <br>"description": "Description of Galaxy Note 3",                                                                                                         |                                                                                                                                                                                              |
| <br>"quantity": 2,                                                                                                                                         |                                                                                                                                                                                              |
| <br>"amount": 449.99                                                                                                                                       |                                                                                                                                                                                              |
| <br>},                                                                                                                                                     |                                                                                                                                                                                              |
| <br>{                                                                                                                                                      |                                                                                                                                                                                              |
| <br>"productCode": "B00D9AVYBM",                                                                                                                           |                                                                                                                                                                                              |
| <br>"name": "Samsung Galaxy S III",                                                                                                                        |                                                                                                                                                                                              |
| <br>"description": "Samsung Galaxy S III (S3) Triband White (Boost Mobile)",                                                                               |                                                                                                                                                                                              |
| <br>"quantity": 1,                                                                                                                                         |                                                                                                                                                                                              |
| <br>"amount": 149.95                                                                                                                                       |                                                                                                                                                                                              |
| <br>}                                                                                                                                                      |                                                                                                                                                                                              |
| <br>]<br><br>Encoded olarak gönderilmelidir.<br><br>Buradaki ürün veya ürünlerin toplam tutarı (amount) ana istek gövdesindeki AMOUNT ile uyuşmalıdır.</p> |                                                                                                                                                                                              |
| CUSTOMER                                                                                                                                                   | Müşteriniz için unique bir değer gönderilmelidir. Kendi sistemlerinizde oluşturduğunuz unique bir müşteri numarası veya TCKN gibi.                                                           |
| CUSTOMERNAME                                                                                                                                               | Müşteri adı gönderilmelidir.                                                                                                                                                                 |
| CUSTOMEREMAIL                                                                                                                                              | Müşteri e-posta adresi gönderilmelidir.                                                                                                                                                      |
| CUSTOMERPHONE                                                                                                                                              | Müşteri telefon numarası gönderilmelidir.                                                                                                                                                    |
| CUSTOMERIP                                                                                                                                                 | Müşteri IP adresi gönderilmelidir.                                                                                                                                                           |
| BILLTOADDRESSLINE                                                                                                                                          | Fatura adres bilgileri gönderilmelidir.                                                                                                                                                      |
| BILLTOCITY                                                                                                                                                 | Fatura adres - Şehir bilgisi                                                                                                                                                                 |
| BILLTOCOUNTRY                                                                                                                                              | Fatura adres - Ülke bilgisi                                                                                                                                                                  |
| BILLTOPOSTALCODE                                                                                                                                           | Fatura adres - Posta kodu bilgisi                                                                                                                                                            |
| BILLTOPHONE                                                                                                                                                | Fatura adres - Telefon numarası bilgisi                                                                                                                                                      |
| SHIPTOADDRESSLINE                                                                                                                                          | Kargo adres bilgileri gönderilmelidir.                                                                                                                                                       |
| SHIPTOCITY                                                                                                                                                 | Kargo adres - Şehir bilgisi                                                                                                                                                                  |
| SHIPTOCOUNTRY                                                                                                                                              | Kargo adres - Ülke bilgisi                                                                                                                                                                   |
| SHIPTOPOSTALCODE                                                                                                                                           | Kargo adres - Posta kodu bilgisi                                                                                                                                                             |
| SHIPTOPHONE                                                                                                                                                | Kargo adres - Telefon numarası bilgisi                                                                                                                                                       |

***

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

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.paratika.com.tr/entegrasyon/api-istekleri/oturum-anahtari/session-token.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.