Son Ödeme Bilgisi Alma

Member'a ait son ödeme bilgisinin detaylarının dönüldüğü servistir. Access Token Sorgulama Servisinden den elde edilen accessToken ile gelinmelidir.

Retrieve Last Payment Info

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

Headers

Name

Value

Content-Type

application/json

Authorization

Authorization

access-token

{{accessToken}}

İ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": "conversationId"
}

Örnek Yanıt

{
    "status": "success",
    "locale": "tr",
    "systemTime": 1749032543970,
    "conversationId": "conversationId",
    "card": {
        "cardHolderName": "John Doe",
        "cardAssociation": "MASTER_CARD",
        "cardFamily": "Advantage",
        "binNumber": "55047200",
        "lastFourDigits": "0003",
        "cardBankName": "HSBC",
        "cardType": "CREDIT_CARD",
        "expireMonth": "05",
        "expireYear": "2026",
        "expired": false,
        "willExpireSoon": false
    },
    "paymentType": "CARD_PAYMENT",
    "sessionToken": "f403ef2f-fb08-4111-afd6-495811ef6b25",
    "token": "e54b957b-a153-410c-8761-79c9bd4ff44f",
    "paymentId": 24259238
}

{
    "status": "failure",
    "errorCode": "100311",
    "errorMessage": "Access token expired",
    "systemTime": 1748550662680
}

Yanıt Parametreleri

Parametre

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.

cardHolderName

String

Kart Sahibinin Adı Soyadı Bilgisidir. Kart ile ödeme yapıldığında döner.

cardAssociation

String

Kart ile ödeme yapıldığında döner. Geçerli değerler VISA, MASTER_CARD, AMERICAN_EXPRESS, TROY'dur

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.

cardFamily

String

Kart ile ödeme yapıldığında döner. Kart ailesi bilgisini döner. Geçerli değerler Bonus, Axess, World, Maximum, Paraf, CardFinans, Advantage

binNumber

String

Kart ile ödeme yapıldığında döner. Kartın ilk 8 hanesi.

lastFourDigits

String

Kart ile ödeme yapıldığında döner. Kartın son 4 hanesi.

cardBankName

String

Kart ile ödeme yapıldığında döner. Kart Bankası Adı.

cardType

String

Kart ile ödeme yapıldığında döner. Eğer ödeme yapılan kart yerel bir kart ise, kart tipi bilgisini döner. DEBIT_CARD ve CREDIT_CARD değerlerini alır.

expireMonth

String

Kart ile ödeme yapıldığında döner. Son geçerlilik tarihi ay bazında döner.

expireYear

String

Kart ile ödeme yapıldığında döner. Son geçerlilik tarihi yıl bazında döner.

expired

boolean

Kart ile ödeme yapıldığında döner. Kartın expire bilgisi true ve false değerlerini alır. Kartın expire olmuşsa true döner.

willExpireSoon

boolean

Kart ile ödeme yapıldığında döner. Kartın bu ay içerisinde expire olma bilgisidir. true ve false değerlerini alır. Eğer bu ay içerisinde expire olacaksa true gelir.

paymentType

String

Ödeme tipini belirtir. FUND veya CARD_PAYMENT değerlerini dönebilir. FUND: Bakiye Ödemesi CARD_PAYMENT: Kart Ödemesi

sessionToken

String

Member'ın aynı ödeme tipinde ödeme yaptığı session key bilgisidir.

token

String

Checkout form için oluşturulan tekil değer. Her işlem için özel üretilir ve işyerine dönülür.

paymentId

Stirng

Ödemeye ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödemenin iptali ve iyzico ile iletişimde kullanılır.

Last updated 24 days ago