> 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/api-istekleri/oturum-anahtari/session-token.md).

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

***