Session Sorgulama

Bu servis, gerçekleştirilen işlem sonrasında, oluşturulan session'ın güncel durumunun görüntülenmesi için kullanılmaktadır. Sorgulanacak session için, başlatılan ödeme akışına ait bilgiler, ödeme formuna ait checkoutFormToken ve ilgili işleme ait paymentId parametreleri gönderilerek sorgulanabilir.

Servis çıktısında doğrudan ödeme detayları yerine; session’a ait bilgiler dönmektedir. Bu kapsamda sessionToken, memberIdentifier, sessionStatus ve paymentType gibi alanlar üzerinden oturumun durumu ve kullanıcıya ait bilgiler takip edilebilir.

Özellikle ödeme akışı tamamlandıktan sonra, session’ın son durumunun kontrol edilmesi ve kullanıcıya ait oturum bilgilerinin elde edilmesi amacıyla bu servisin kullanılması önerilmektedir. Böylece ödeme süreci, client tarafındaki yönlendirmelere bağımlı kalmadan güvenli bir şekilde izlenebilir.

Session Sorgulama

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

Headers

Name	Value
Content-Type	application/json
Authorization	Authorization

Örnek İstek

{
  "locale": "tr",
  "conversationId": "123456789",
  "checkoutFormToken": "ab468ec8-c4ab-4449-b15b-69782f7786c6",
  "paymentId": "29414275"
}

İstek Parametreleri

Paremetre	Tip	Zorunluluk	Açıklama
checkoutFormToken	string	Evet	Yapılan işleme ait ödeme formunun token değeri.
locale	string	Hayır	İstek için gönderilen dil değeri. EN ve TR değerini alabilir.
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.
paymentId	string	Evet	Gerçekleştirilen ödeme işlemine ait, ödeme numarası değeri.

Örnek Yanıt

200

{
    "status": "success",
    "locale": "tr",
    "systemTime": 1775471642206,
    "sessionInfo": {
        "sessionToken": "f2f06a82-6480-4d2b-811d-93168ddce577",
        "sessionStatus": "PASSIVE",
        "memberIdentifier": "702831f3-1cc6-4b25-ad2b-878afc64f408",
        "paymentType": "CARD_PAYMENT"
    }
}

400

Dönüş Parametreleri

Paremetre	Tip	Açıklama
status	string	Gönderilen isteğin sonucu.
locale	string	İstekte gönderilen dil değeri.
systemTime	Long	İşlem zamanı (epoch ms).
sessionToken	string	Member'ın yaptığı ödeme işlemine ait session key bilgisidir.
sessionStatus	string	Kullanıcıya ait session durumudur. ACTIVE veya PASSIVE değerlerini alır.
memberIdentifier	string	Member unique key bilgisidir.
paymentType	string	Ödeme tipini belirtir. FUND veya CARD_PAYMENT değerlerini dönebilir. FUND: Bakiye Ödemesi CARD_PAYMENT: Kart Ödemesi