Access Token Alma

Tokenization ödeme tetiklenebilmesi ve son ödeme bilgilerinin alınabilmesi için accessToken ihtiyaç bulunmaktadır. Bu servise yapılacak sorgu ile accessToken bilgisine ulaşılmaktadır.

Oluşturulan accessToken'ın 5 dakikalık süresi bulunmaktadır. Bu süre aşıldığı taktirde yeni token oluşturulmalıdır.

Access Token Alma

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

Headers

Name	Value
Content-Type	application/json
Authorization	Authorization

İstek Parametreleri

Parametre	Tip	Açıklama
sessionToken	String	Member'ın aynı ödeme tipinde ödeme yaptığı session key bilgisidir.
memberIdentifier	String	Member unique key bilgisidir. Bu key, ödeme işlemlerinde member bilgisi için kullanılır.
locale	String	iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir. en olarak kullanılabilir.
conversationId	String	İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir. En yaygın kullanış biçimi üye iş yerinin sipariş numarasıdır.

Örnek İstek

{
    "sessionToken": "{{sessionToken}}",
    "memberIdentifier": "{{memberIdentifier}}",
    "locale": "tr",
    "conversationId": "test"
}

Örnek Yanıt

200

{
    "status": "success",
    "locale": "tr",
    "systemTime": 1749027862133,
    "conversationId": "test",
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiItIiwic2NvcGUiOlsidGhpcmRQYXJ0eVNlc3Npb24iXSwic2Vzc2lvblRva2VuIjoiZDUzZWRiNzItNTNmMy00NmY0LTk5NWQtNDM1NzBhOTdiZDg4IiwiZXhwIjoxNzQ5MDI4MjIyLCJhdXRob3JpdGllcyI6WyJwd2lfdHBfc2Vzc2lvbl9jYXJkX2F1dGgiLCJwd2lfdHBfc2Vzc2lvbl9pbml0M2RzX2F1dGgiLCJwd2lfdHBfc2Vzc2lvbl9sYXN0X3BheW1lbnRfcmV0cmlldmUiLCJwd2lfdHBfc2Vzc2lvbl9mdW5kX2F1dGgiXSwianRpIjoiMTUwODdmNTgtZGE4Yy00OTFhLWFjN2QtYmYyODI2ODNmMGRlIiwiY2xpZW50X2lkIjoidGhpcmRQYXJ0eVNlc3Npb25DbGllbnQifQ.YC5McE1SdXrPeCpljrMU1X3kzc3FV7I8DoZ5G0qcS30"
}

400

{
    "status": "failure",
    "errorCode": "260016",
    "errorMessage": "Session token bulunamadı.",
    "locale": "tr",
    "systemTime": 1749027045713
}

Yanıt Parametreleri

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.
accessToken	String	Member için servisler aracılığıyla ödeme tetikleyebileceği bearer token bilgisidir.
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.