Last Payment Detail Info

This service returns the details of the member’s most recent payment. It must be called using the accessToken obtained from the Access Token Retrieval Service.

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}}

Request Parameter

Parameter	Type	Required	Description
sessionToken	String	Yes	This is the session key information that the Member pays in the same payment type.
memberIdentifier	String	Yes	Member unique key information. This key is used for member information in payment transactions.
locale	String	No	Used to set the language of the texts returned as a result of iyzico request. The default value is en. can be used as en.
conversationId	String	No	A value that you can send during the request and receive at the end can be used to match request/response. The most common use case is the merchant's order number.

Request

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

Response

200

{
    "status": "success",
    "locale": "en",
    "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
}

400

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

Response Parameters

Parameter	Type	Description
status	String	Service response result (success / failure).
locale	String	Specifies the language of the returned response.
systemTime	Long	Response system unix timestamp value.
conversationId	String	If set, conversation ID to match request and response.
cardHolderName	String	Name and Surname of the Cardholder. Returns when payment is made with the card.
cardAssociation	String	Returns when payment is made by card. Valid values are VISA, MASTER_CARD, AMERICAN_EXPRESS, TROY
errorCode	String	If the operation was failed, this is the code that indicates the error.
errorMessage	String	If the operation is failed, this is a message detailing the error, with language support according to the locale parameter.
cardFamily	String	Returns when payment is made by card. Returns card family information. Valid values Bonus, Axess, World, Maximum, Paraf, CardFinans, Advantage
binNumber	String	Returns when payment is made by card. First 8 digits of the card.
lastFourDigits	String	Returns when payment is made by card. Last 4 digits of the card.
cardBankName	String	Returns when payment is made by card. Card Bank Name.
cardType	String	Returns when payment is made by card. If the payment card is a local card, it returns the card type information. It takes the values DEBIT_CARD and CREDIT_CARD.
expireMonth	String	Returns when payment is made by card. Expiry date is returned on a month basis.
expireYear	String	Returns when payment is made by card. Returns the expire date in years.
expired	boolean	Returns when payment is made by card. Card expire information takes true and false values. Returns true if the card has expired.
willExpireSoon	boolean	Returns when payment is made by card. This is the expiration information of the card in this month. takes true and false values. Returns true if the card will expire within this month.
paymentType	String	Specifies the payment type. It can return FUND or CARD_PAYMENT. FUND Balance Payment CARD_PAYMENT: Card Payment
sessionToken	String	It is the session key information that the Member pays in the same payment type.
token	String	Unique value created for checkout form. It is generated for each transaction and returned to the merchant.
paymentId	Stirng	The ID of the payment must be kept by the merchant. It is used for payment cancellation and communication with iyzico.