.svg?alt=media&token=17ec6f8f-ac20-4c93-8c47-630298706a48)
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.
ÖNEMLİ NOT : callBackUrl adresi mutlaka SSL içermelidir.
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.
PWI Başlatma
POST https://api.iyzipay.com/payment/pay-with-iyzico/initialize
Request Body
price*
Decimal
Ödeme sepet tutarı. Kırılım tutarlar toplamı, sepet tutarına eşit olmalı.
contactName(BillingAddress)*
String
Contact name of billing address
registrationAddress(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait kayıt adresi.
ip(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait IP adresi.
email(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait e-posta bilgisi. E-posta adresi alıcıya ait geçerli ve erişilebilir bir adres olmalıdır.
country(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait ülke bilgisi.
city(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait şehir bilgisi.
identityNumber(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası.
surname(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait soyad.
name(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait ad.
id(Buyer)*
String
Üye işyeri tarafındaki alıcıya ait ad.
currency*
String
Para birimi. Default değeri TL’dir. Kullanılabilen diğer değerler ise USD, EUR, GBP ve IRR’dir.
paidPrice*
Decimal
İndirim, vergi, taksit komisyonları gibi değerlerin dahil edildiği tutar.
zipCode(BillingAddress)
String
Üye işyeri tarafındaki fatura adresi posta kodu.
zipCode(ShippingAddress)
String
Üye işyeri tarafındaki teslimat adresi posta kodu.
zipCode(Buyer)
String
Üye işyeri tarafındaki alıcıya ait posta kodu.
category1(BasketItems)
String
Üye işyeri tarafındaki sepetteki ürüne ait kategori 1.
name(BasketItems)*
String
Üye işyeri tarafındaki sepetteki ürüne ait ismi.
price(BasketItems)*
Decimal
Üye işyeri tarafındaki sepetteki ürüne ait tutar. 0 ve 0’dan küçük olamaz, tutarlar toplamı sepet tutarına (price) eşit olmalıdır.
itemType(BasketItems)*
String
Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL
id(BasketItems)*
String
Üye işyeri tarafındaki sepetteki ürüne ait id. Not: Bir ödeme isteğine maksimum 500 basketItem eklenebilir.
address(ShippingAddress)*
String
Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.
country(ShippingAddress)*
String
Üye işyeri tarafındaki teslimat adresi ülke bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.
city(ShippingAddress)*
String
Üye işyeri tarafındaki teslimat adresi şehir bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.
contactName(ShippingAddress)*
String
Üye işyeri tarafındaki teslimat adresi ad soyad bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.
address(BillingAddress)*
String
Address details of billing address
country(BillingAddress)*
String
Country name of billing address
city(BillingAddress)*
String
City name of billing address
paymentGroup
String
Ödeme grubu, varsayılan PRODUCT. Geçerli değerler enum içinde sunulmaktadır: PRODUCT, LISTING, SUBSCRIPTION
basketId
String
Üye işyeri sepet id’si.
conversationId
String
İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.
locale
String
iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
lastLoginDate(Buyer)
String
Üye işyeri tarafındaki alıcıya ait son giriş tarihi. Tarih formatı 2015- 09-17 23:45:06 şeklinde olmalıdır.
registrationDate(Buyer)
String
Üye işyeri tarafındaki alıcıya ait kayıt tarihi. Tarih formatı 2015-09- 17 23:45:06 şeklinde olmalıdır.
gsmNumber(Buyer)
String
Üye işyeri tarafındaki alıcıya ait GSM numarası.
category2(BasketItems)
String
Üye işyeri tarafındaki sepetteki ürüne ait kategori 2.
paymentSource
String
Ödeme kanalı. Geçerli değerler SHOPIFY, MAGENTO, PRESTASHOP, WOOCOMMERCE, OPENCART
callbackUrl*
String
Ödeme akışında üye işyerine başarılı ve hatalı sonucu bildirmek üzere alınan URL adresi. Geçerli bir ssl sertifikasına sahip olmalıdır.
enabledInstallments
Integer
Taksit bilgisi, tek çekim için 1 gönderilmelidir. Geçerli değerler: 1, 2, 3, 6, 9.
PWI Başlatma Dönen Parametreler
Hizmetten döndürülecek parametreler aşağıdaki gibidir.
payWithIyzicoPageUrl
string
iyzico ile ödeme sayfasının eşsiz linki. Son kullanıcının ödeme yapması için yönlendirilmesi gereken adres.
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 zorunlu bir alandır. Varsayılan olarak 1800 saniye geçerliliği vardır.
tokenExpireTime
Integer
iyzico ile ödeme için üretilmiş olan token ve link değerinin geçerlilik süresi.
status
string
Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner.
errorCode
string
İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage
string
İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.
errorGroup
string
İşlem hatalıysa, bu hataya dair belirtilen gruptur.
locale
string
İstekte belirtilen locale değeri geri dönülür, varsayılan değeridir.
systemTime
integer
Dönen sonucun o anki unix timestamp değeridir.
conversationId
string
İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.
Last updated
