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	EN: Timeout occurred while waiting for device response! TR: Cihaz yanıtı beklenirken zaman aşımı oluştu!
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	EN: Invalid token! TR: Geçersiz token!
SYSTEM_ERROR	100311	EN: Access token expired! TR: Token kullanım süresi dolmuştur!
SYSTEM_ERROR	380102	EN: You do not have access to the information of this auth device! TR: Auth device bilgisine erişim hakkı yoktur!

"Device Error" Error Messages

Hata Grubu	Hata Kodu	Hata Mesajı
DEVICE_ERROR	380201	EN: Terminal is currently busy, please wait for the previous operation to complete TR: Terminal şu anda meşgul bir önceki işlemin bitmesini bekleyin
DEVICE_ERROR	380202	EN: Techpos application could not be started. Please try again. TR: Techpos uygulaması başlatılamadı. Lütfen tekrar deneyin.
DEVICE_ERROR	380203	EN: Null response received from Techpos application TR: Techpos uygulamasından boş (null) yanıt alındı
DEVICE_ERROR	380204	EN: Error occurred during refresh token and user session has been terminated TR: Refresh token sırasında hata oluştu ve kullanıcı oturumu sonlandırıldı
DEVICE_ERROR	380205	EN: Response message to be sent from device could not be created TR: Cihazdan gönderilecek yanıt mesajı oluşturulamadı

Validation Error Messages

Hata Grubu	Hata Kodu	Hata Mesajı
VALIDATION_ERROR	380104	EN: Device request validation error! Details: {0} TR: Request doğrulama hatası! Detaylar: {0}
VALIDATION_ERROR	380105	EN: Operation {0} is not supported for device modal: {1} TR:{0} işlemi {1} model cihazda desteklenmemektedir
VALIDATION_ERROR	380111	EN: Either transactionReferenceId or paymentId must be provided. TR: TransactionReferenceId veya PaymentId sağlanmalıdır.

"Business Error" Error Messages

Hata Grubu	Hata Kodu	Hata Mesajı
BUSINESS_ERROR	380101	En: Auth Device not found! For username: {0} TR: Auth Device bulunamadı! username: {0}
BUSINESS_ERROR	380107	En: Payment not found with paymentId: {0} TR: Ödeme bulunamadı paymentId: {0}
BUSINESS_ERROR	380108	En: Payment not found with id: {0} TR: Ödeme bulunamadı id: {0}
BUSINESS_ERROR	380109	En: Payment not found with orderId: {0} TR: Ödeme bulunamadı orderId: {0}
BUSINESS_ERROR	380112	En: The amount you want to cancel/refund is not available in your account. Please check your balance information. TR: İptal/iade yapmak istediğiniz tutar hesabınızda yoktur. Lütfen bakiye bilgilerinizi kontrol ediniz.