Error Codes

The general error structure of the services and the error groups that may be returned are as follows.

Error Groups

Hata Grubu
Açıklama

TIMEOUT_ERROR

While waiting for a response from the device, if it does not return within a certain time, a timeout occurs and this error group is returned.

SYSTEM_ERROR

If a system error occurs while waiting for a response from the device, if there is a problem with the sent token information, if there is a temporary issue in the system, or if an unexpected situation arises, this error group is returned.

BANK_ERROR

If the transaction receives an error on the bank side (other than authCode 00), this error group is returned.

DEVICE_ERROR

If an error is returned from the device, this error group is returned.

PAYMENT_ERROR

If an error is received from iyzico Payment services, this error group is returned.

BUSINESS_ERROR

If a situation that should not occur in terms of business logic has occurred, this error group is returned.

VALIDATION_ERROR

If there is a problem with the sent request, this error group is returned.

Error Messages

Hata Grubu
Hata Kodu
Hata Mesajı

TIMEOUT_ERROR

380103

BANK_ERROR

The error message returned from the bank is being forwarded.

PAYMENT_ERROR

The error message received from the payment service is being transmitted.

"System Error" Error Messages

Hata Grubu
Hata Kodu
Hata Mesajı

SYSTEM_ERROR

100310

SYSTEM_ERROR

100311

SYSTEM_ERROR

380102

"Device Error" Error Messages

Hata Grubu
Hata Kodu
Hata Mesajı

DEVICE_ERROR

380201

DEVICE_ERROR

380202

DEVICE_ERROR

380203

DEVICE_ERROR

380204

DEVICE_ERROR

380205

Validation Error Messages

Hata Grubu
Hata Kodu
Hata Mesajı

VALIDATION_ERROR

380104

VALIDATION_ERROR

380105

VALIDATION_ERROR

380111

"Business Error" Error Messages

Hata Grubu
Hata Kodu
Hata Mesajı

BUSINESS_ERROR

380101

BUSINESS_ERROR

380107

BUSINESS_ERROR

380108

BUSINESS_ERROR

380109

BUSINESS_ERROR

380112

Last updated