iyzico ile Öde (PWI)

iyzico ile Öde (Pay With Iyzico) yöntemi, son kullanıcıyı iyzico tarafından sunulan iyzico cüzdan hesabına yönlendirerek işlemi tamamlamanızı sağlar.

Bu yöntem, hızlıca entegrasyon yapmak isteyen ve kullanıcı arayüzünü iyzico’ya bırakmak isteyen iş ortakları için idealdir. API-API Pay With iyzico kullanımı için bu servis kullanılmalıdır.

iyzico ile Öde Başlatma

POST https://api.iyzipay.com/v1/pay-with-iyzico/third-party-session/pwi/init

Headers

Name

Value

Content-Type

application/json

Authorization

Authorization

İstek Parametreleri

Parametre

Tip

Zorunluluk

Açıklama

paidPrice

Decimal

Evet

Tahsil edilecek nihai tutar.

enabledInstallments

Integer

Hayır

Taksit bilgisi, tek çekim için 1 gönderilmelidir. Geçerli değerler: 1, 2, 3, 6, 9, 12

locale

String

Hayır

iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.

price

Decimal

Evet

Ödeme sepet tutarı. Kırılım tutarlar toplamı, sepet tutarına eşit olmalı.

conversationId

String

Hayır

İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.

paymentGroup

String

Hayır

Ödeme grubu, varsayılan PRODUCT. Geçerli değerler enum içinde sunulmaktadır: PRODUCT, LISTING, SUBSCRIPTION

callbackUrl

String

Evet

Ö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.

currency

String

Evet

Para birimi. Default değeri TRY’dir. Kullanılabilen diğer değerler ise USD, EUR, GBP’dir.

basketId

String

Hayır

Üye işyeri sepet id’si.

buyerId

String

Evet

Üye işyeri tarafındaki alıcıya ait id bilgisi.

buyerName

String

Evet

Üye işyeri tarafındaki alıcıya ait ad.

buyerSurname

String

Evet

Üye işyeri tarafındaki alıcıya ait soyadı.

identityNumber

String

Evet

Alıcıya ait TCKN bilgisi.

email

String

Evet

Ü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.

gsmNumber

String

Hayır

Üye işyeri tarafındaki alıcıya ait GSM numarası.

registrationAddress

String

Evet

Üye işyeri tarafındaki alıcıya ait kayıt adresi.

city

String

Evet

Üye işyeri tarafındaki alıcıya ait şehir bilgisi.

country

String

Evet

Üye işyeri tarafındaki alıcıya ait ülke bilgisi.

IP

String

Hayır

Üye işyeri tarafındaki alıcıya ait IP adresi.

zipCode

String

Evet

Üye işyeri tarafındaki alıcıya ait posta kodu.

address(shippingAddress)

String

Evet

Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.

contactName(shippingAddress)

String

Evet

Üye işyeri tarafındaki teslimat adresi ad soyad bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.

city(shippingAddress)

String

Evet

Üye işyeri tarafındaki teslimat adresi şehir bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.

country(shippingAddress)

String

Evet

Üye işyeri tarafındaki teslimat adresi ülke bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.

zipCode(shippingAddress)

String

Evet

Üye işyeri tarafındaki teslimat adresi posta kodu.

address(billingAddress)

String

Evet

Alıcıya ait fatura adres bilgisi.

contactName(billingAddress)

String

Evet

Alıcıya ait fatura ad soyad bilgisi.

city(billingAddress)

String

Evet

Alıcıya ait fatura şehir bilgisi.

country(billingAddress)

String

Evet

Alıcıya ait fatura ülke bilgisi.

basketItemId

String

Evet

Üye işyeri tarafındaki sepetteki ürüne ait id. Not: Bir ödeme isteğine maksimum 500 basketItem eklenebilir.

basketItemPrice

String

Evet

Ü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.

basketItemName

String

Evet

Üye işyeri tarafındaki sepetteki ürüne ait ismi.

basketItemCategory1

String

Evet

Üye işyeri tarafındaki sepetteki ürüne ait 1. kategori.

basketItemCategory2

String

Hayır

Üye işyeri tarafındaki sepetteki ürüne ait 2. kategori.

basketItemItemType

String

Evet

Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL

PWI Başlatma Örnek İsteği

{
    "paidPrice": 1.0,
    "locale": "tr",
    "enabledInstallments": [ 
        1,
        2,
        3,
        6,
        9,
        12
    ],
    "price": 1.0,
    "conversationId": "2224",
    "paymentGroup": "PRODUCT",
    "callbackUrl": "https://merchant-callback.com",
    "currency": "TRY",
    "basketId": "B67832",
    "buyer": {
        "id": "BY789",
        "name": "John",
        "surname": "Doe",
        "identityNumber": "74300864711",
        "email": "sandboxtest0@gmail.com",
        "gsmNumber": "+9055555555",
        "registrationAddress": "Adres",
        "city": "Istanbul",
        "country": "Turkey",
        "ip": "buyer Ip",
        "zipCode": "34580"
    },
    "shippingAddress": {
        "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10",
        "contactName": "Jane Doe",
        "city": "Istanbul",
        "country": "Turkey",
        "zipCode": "34580"
    },
    "billingAddress": {
        "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10",
        "contactName": "Jane Doe",
        "city": "Istanbul",
        "country": "Turkey",
        "zipCode": "34580"
    },
    "basketItems": [
        {
            "id": "BI101",
            "price": 1.0,
            "name": "Binocular",
            "category1": "Collectibles",
            "itemType": "PHYSICAL"
        }
    ]
}

Örnek Yanıt

{
    "status": "success",
    "locale": "tr",
    "systemTime": 1749027773192,
    "conversationId": "2224",
    "token": "d9d9fc30-8178-4ca9-8f93-1b150f465da6",
    "signature": "a53e433a982bc9f927aed4e0383d083bd48de9cff343490ba7477f9964cfbfb1",
    "payWithIyzicoPageUrl": "https://sandbox-ode.iyzico.com/sdk?token=d9d9fc30-8178-4ca9-8f93-1b150f465da6&lang=tr",
    "tokenExpireTime": 600,
    "tokenExpireDate": 1749028373178
}

{
    "status": "failure",
    "errorCode": "5062",
    "errorMessage": "Gönderilen tutar tüm kırılımların toplam tutarına eşit olmalıdır",
    "locale": "tr",
    "systemTime": 1749021703678
}

Yanıtta Dönebilecek Parametreler

Parametre Adı

Tip

Açıklama

status

String

İstek sonucunu ifade eder. success yada failure değerleri dönebilmektedir.

locale

String

Dönen yanıtın dilini ifade eder.

systemTime

Long

Dönen sonucun o anki unix timestamp değeridir.

conversationId

String

İstek esnasında gönderilen değer dönmektedir.

token

String

Her ödeme formu isteği için oluşturulan unique değerdir.

payWithIyzicoPageUrl

String

Son kullanıcının yönlendireleceği pay with iyzico sayfa urlidir.

tokenExpireTime

Long

Token'ın sona erme süresidir.

tokenExpireDate

Long

Epoch zaman diliminde token'ın expire olacağı tarih bilgisi.

errorCode

String

İşlem hatalıysa, bu hataya dair belirtilen koddur.

errorMessage

String

İşlem hatalıysa, bu hataya dair detay belirtilen mesajdır, locale parametresine göre dil desteği sunar.

Last updated 2 days ago