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

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.net/iyzico/apis/bin-and-installment.md) · [All operations](https://skmtc.net/iyzico/apis/bin-and-installment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iyzico/bin-and-installment/versions/46976ce5eed9/schema)