---
title: "iyzico ile Öde (PWI) Başlatma"
method: POST
path: "/payment/pay-with-iyzico/initialize"
tags: ["Pay with iyzico"]
---

# iyzico ile Öde (PWI) Başlatma

`POST /payment/pay-with-iyzico/initialize`

## Request

- Base URL: `https://sandbox-api.iyzipay.com`
- URL: `https://sandbox-api.iyzipay.com/payment/pay-with-iyzico/initialize`
- Auth: none declared. Required headers: `Authorization`, `Content-Type`
- TypeScript: <https://skmtc.dev/iyzico/apis/bin-and-installment/docs/payment/pay-with-iyzico/initialize/post.ts> (a function with typed inputs; its response is checked against the schema)

PWI oturumunu başlatır; yönlendirme için token ve sayfa URL’i döner.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- PwiInitializeRequest
  - `locale` 'tr' | 'en': Dil kodu. Varsayılan; tr
  - `conversationId` string: İstek/yanıt eşleştirme ID’si.
  - `price` unknown, required
  - `basketId` string, required: Sepet ID’si.
  - `paymentGroup` 'PRODUCT' | 'LISTING' | 'SUBSCRIPTION': Ödeme grubu.
  - `callbackUrl` string, required: İşlem sonrası yönlenecek URL.
  - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP' | 'NOK' | 'CHF', required: Para birimi. Varsayılan TRY.
  - `paidPrice` unknown, required
  - `paymentChannel` 'WEB' | 'MOBILE' | 'MOBILE_WEB' | 'MOBILE_IOS' | 'MOBILE_ANDROID' | 'MOBILE_WINDOWS' | 'MOBILE_TABLET' | 'MOBILE_PHONE': Ödeme kanalı.
  - `enabledInstallments` integer[]: Sunulacak taksit seçenekleri.
  - `buyer` PwiBuyer, required: Alıcı Bilgileri
    - `id` string, required: Müşteri ID’si.
    - `name` string, required: Ad.
    - `surname` string, required: Soyad.
    - `identityNumber` string, required: Kimlik numarası (TCKN).
    - `email` string, required: E-posta.
    - `gsmNumber` string, required: Cep telefonu.
    - `registrationAddress` string, required: Kayıtlı adres.
    - `city` string, required: Şehir.
    - `country` string, required: Ülke.
    - `ip` string, required: IP adresi.
    - `zipCode` string: Posta kodu.
    - `registrationDate` string: Kayıt tarihi (YYYY-MM-DD hh:mm:ss).
    - `lastLoginDate` string: Son giriş tarihi (YYYY-MM-DD hh:mm:ss).
  - `shippingAddress` PwiAddress, required: Fatura Adresi
    - `address` string, required: Adres.
    - `contactName` string, required: İlgili kişi adı.
    - `city` string, required: Şehir.
    - `country` string, required: Ülke.
    - `zipCode` string: Posta kodu.
  - `billingAddress` PwiAddress, required: Fatura Adresi
    - `address` string, required: Adres.
    - `contactName` string, required: İlgili kişi adı.
    - `city` string, required: Şehir.
    - `country` string, required: Ülke.
    - `zipCode` string: Posta kodu.
  - `basketItems` PwiBasketItem[], required: Sepetteki ürünler.
    - `id` string, required: Ürün ID.
    - `price` unknown, required
    - `name` string, required: Ürün adı.
    - `category1` string, required: Ana kategori.
    - `category2` string: Alt kategori (opsiyonel).
    - `itemType` 'PHYSICAL' | 'VIRTUAL', required: Ürün tipi.
    - `subMerchantKey` string: Hizmeti veren alt üye işyerine ait, alt üye işyeri anahtarı bilgisi. Standart iş modelinde gönderilmez. Sadece pazaryeri iş modelinde gönderilmesi gerekmektedir.
    - `subMerchantPrice` string: Alt üye işyerine aktarılacak tutar. Standart iş modelinde gönderilmez. Sadece pazaryeri iş modelinde gönderilmesi gerekmektedir.

## Response `200`

Başarılı yanıt (PWI başlatıldı)

- PwiInitializeResponse
  - `status` 'success' | 'failure': Yapılan isteğin sonucunu bildirir.
  - `locale` 'tr' | 'en': Yanıt dili.
  - `systemTime` integer: Zaman damgası (epoch ms).
  - `conversationId` string: İstek ile eşleşen ID.
  - `token` string: iyzico ile ödeme için oluşturulan tekil değer. Her istek için özel üretilir ve işyerine dönülür Ödemenin sonucunu öğrenmek için gereklidir.
  - `tokenExpireTime` integer: Token geçerlilik süresi; 1800 saniye
  - `payWithIyzicoPageUrl` string: Yönlenecek ödeme sayfası URL’i.
  - `signature` string: Yanıt imzası (hash).

## Other responses

- `400`: Hatalı istek / doğrulama hatası

---

[API](https://skmtc.dev/iyzico/apis/bin-and-installment.md) - [All operations](https://skmtc.dev/iyzico/apis/bin-and-installment/llms.txt) - [OpenAPI document](https://skmtc.dev/iyzico/apis/bin-and-installment/revisions/46976ce5eed9?raw)