# PWI Başlatma Aşağıda belirtilen talebi yaptıktan sonra, müşterilerinizin iyzico ile Ödeme'ye yönlendirileceği benzersiz bir sayfa olan `payWithIyzicoPageUrl` değerini alacaksınız. Müşterileriniz, ödeme işlemini tamamladıktan sonra iyzico ile Öde başlatma talebinde belirttiğiniz callBackUrl'ye otomatik olarak yönlendirilecektir. Oluşturulan bağlantıyı ödeme sayfanızda düğme, bağlantı veya div olarak görüntüleyebilirsiniz. Bağlantı ile alınan token bu aşamada veya müşteri ödeme işlemine devam ederse callBackUrl'e gönderildiğinde saklanabilir. Lütfen oluşturulan bağlantı ve token değerlerinin 30 dakika boyunca geçerli olduğunu unutmayın. Bu süre içinde herhangi bir ödeme alınmazsa tokenin süresi dolar. {% hint style="info" %} **ÖNEMLİ NOT :** callBackUrl adresi mutlaka SSL içermelidir. {% endhint %} Bu özellikleri dahil ederek, işlemlerinin başarısı veya başarısızlığı hakkında gerçek zamanlı geri bildirim ile müşterilerinize sorunsuz bir ödeme deneyimi sağlayabilirsiniz. ## iyzico ile Öde (PWI) Başlatma > PWI oturumunu başlatır; yönlendirme için token ve sayfa URL’i döner. ```json {"openapi":"3.0.3","info":{"title":"Pay with iyzico (PWI)","version":"1.0.0"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/pay-with-iyzico/initialize":{"post":{"summary":"iyzico ile Öde (PWI) Başlatma","description":"PWI oturumunu başlatır; yönlendirme için token ve sayfa URL’i döner.","tags":["Pay with iyzico"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PwiInitializeRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt (PWI başlatıldı)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PwiInitializeResponse"}}}},"400":{"description":"Hatalı istek / doğrulama hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve imzalı base64 hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"}}},"schemas":{"PwiInitializeRequest":{"type":"object","required":["price","basketId","callbackUrl","currency","paidPrice","buyer","billingAddress","shippingAddress","basketItems"],"properties":{"locale":{"type":"string","enum":["tr","en"],"description":"Dil kodu. Varsayılan; tr"},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si."},"price":{"type":"decimal","description":"Sepet toplamı."},"basketId":{"type":"string","description":"Sepet ID’si."},"paymentGroup":{"type":"string","enum":["PRODUCT","LISTING","SUBSCRIPTION"],"description":"Ödeme grubu."},"callbackUrl":{"type":"string","description":"İşlem sonrası yönlenecek URL."},"currency":{"type":"string","enum":["TRY","USD","EUR","GBP","NOK","CHF"],"description":"Para birimi. Varsayılan TRY."},"paidPrice":{"type":"decimal","description":"Tahsil edilecek tutar."},"paymentChannel":{"type":"string","enum":["WEB","MOBILE","MOBILE_WEB","MOBILE_IOS","MOBILE_ANDROID","MOBILE_WINDOWS","MOBILE_TABLET","MOBILE_PHONE"],"description":"Ödeme kanalı."},"enabledInstallments":{"type":"array","items":{"type":"integer","enum":[1,2,3,6,9,12]},"description":"Sunulacak taksit seçenekleri."},"buyer":{"$ref":"#/components/schemas/PwiBuyer"},"shippingAddress":{"$ref":"#/components/schemas/PwiAddress","description":"Teslimat Adresi. Sepetteki ürünlerden en az bir tanesi PHYSICAL ise zorunludur. Tüm ürünler VIRTUAL ise gönderilmesi gerekmez."},"billingAddress":{"$ref":"#/components/schemas/PwiAddress"},"basketItems":{"type":"array","description":"Sepetteki ürünler.","minItems":1,"items":{"$ref":"#/components/schemas/PwiBasketItem"}}}},"PwiBuyer":{"type":"object","description":"Alıcı Bilgileri","required":["id","name","surname","identityNumber","email","gsmNumber","registrationAddress","city","country","ip"],"properties":{"id":{"type":"string","description":"Müşteri ID’si."},"name":{"type":"string","description":"Ad."},"surname":{"type":"string","description":"Soyad."},"identityNumber":{"type":"string","description":"Kimlik numarası (TCKN)."},"email":{"type":"string","description":"E-posta."},"gsmNumber":{"type":"string","description":"Cep telefonu."},"registrationAddress":{"type":"string","description":"Kayıtlı adres."},"city":{"type":"string","description":"Şehir."},"country":{"type":"string","description":"Ülke."},"ip":{"type":"string","description":"IP adresi."},"zipCode":{"type":"string","description":"Posta kodu."},"registrationDate":{"type":"string","description":"Kayıt tarihi (YYYY-MM-DD hh:mm:ss)."},"lastLoginDate":{"type":"string","description":"Son giriş tarihi (YYYY-MM-DD hh:mm:ss)."}}},"PwiAddress":{"type":"object","description":"Fatura Adresi","required":["address","contactName","city","country"],"properties":{"address":{"type":"string","description":"Adres."},"contactName":{"type":"string","description":"İlgili kişi adı."},"city":{"type":"string","description":"Şehir."},"country":{"type":"string","description":"Ülke."},"zipCode":{"type":"string","description":"Posta kodu."}}},"PwiBasketItem":{"type":"object","required":["id","price","name","category1","itemType"],"properties":{"id":{"type":"string","description":"Ürün ID."},"price":{"type":"decimal","description":"Ürün fiyatı."},"name":{"type":"string","description":"Ürün adı."},"category1":{"type":"string","description":"Ana kategori."},"category2":{"type":"string","description":"Alt kategori (opsiyonel)."},"itemType":{"type":"string","description":"Ürün tipi.","enum":["PHYSICAL","VIRTUAL"]},"subMerchantKey":{"type":"string","description":"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":{"type":"string","description":"Alt üye işyerine aktarılacak tutar. Standart iş modelinde gönderilmez. Sadece pazaryeri iş modelinde gönderilmesi gerekmektedir."}}},"PwiInitializeResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili.","enum":["tr","en"]},"systemTime":{"type":"integer","description":"Zaman damgası (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."},"token":{"type":"string","description":"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":{"type":"integer","description":"Token geçerlilik süresi; 1800 saniye"},"payWithIyzicoPageUrl":{"type":"string","description":"Yönlenecek ödeme sayfası URL’i."},"signature":{"type":"string","description":"Yanıt imzası (hash)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"Hata/başarı bilgisi."},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","description":"Yanıt dili.","enum":["tr","en"]},"systemTime":{"type":"integer","description":"Zaman damgası (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."}}}}}} ``` #### Örnek Kodlar
PHP
Java
.NET
Postman