Session Expire

This service is used to terminate an active session. To finalize the session termination, the sessionToken and the corresponding memberIdentifier must be provided.

After the service call, the session is set to a passive (PASSIVE) status. Following this, any checks performed via the session retrieval service will return the session status as PASSIVE.

Once the session is marked as passive, no further payment transactions can be performed using that session. This ensures that incomplete or abandoned sessions are properly managed and that the payment flow remains secure and controlled.

Session Expire

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

Headers

Name	Value
Content-Type	application/json
Authorization	Authorization

Request

{
    "locale": "tr",
    "conversationId": "123456789",
    "sessionToken": "f2f06a82-6480-4d2b-811d-93168ddce577",
    "memberIdentifier": "702831f3-1cc6-4b25-ad2b-878afc64f408"
}

Request Parameters

Paremetre	Tip	Zorunluluk	Açıklama
sessionToken	string	Evet	Token value of the session to be expired.
memberIdentifier	string	Evet	Unique key information of the member associated with the session.
locale	string	Hayır	Language value sent in the request. Can be EN or TR.
conversationId	string	Hayır	A value sent within the request and returned in the response, used to match request and response.

Response

200

{
    "status": "success",
    "locale": "en",
    "systemTime": 1775484679584,
    "conversationId": "test",
    "sessionToken": "0636d0cf-b54e-4896-b3f2-91f69e9c6b11",
    "memberIdentifier": "702831f3-1cc6-4b25-ad2b-878afc64f408"
}

400

{
    "status": "failure",
    "errorCode": "260030",
    "errorMessage": "Session is already invalidated at 4/6/26, 5:11 PM.",
    "locale": "en",
    "systemTime": 1775484702256,
    "conversationId": "test"
}

Response Parameters

Parametre İsmi	Tip	Açıklama
status	String	Indicates the result of the request. Returns success if successful, failure if unsuccessful.
systemTime	Long	The Unix timestamp of the response time.
errorCode	String	The error code returned if the transaction fails.
errorMessage	String	The error message returned if the transaction fails. It is localized based on the locale parameter.
conversationId	String	If sent in the request, it is returned in the response unchanged. It is only returned in failed responses.
locale	String	The locale value sent in the request is returned. The default value is tr. It is only returned in failed responses.