# Error Codes

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

### Error Groups

<table data-full-width="false"><thead><tr><th>Hata Grubu</th><th>Açıklama</th></tr></thead><tbody><tr><td><code>TIMEOUT_ERROR</code></td><td>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.</td></tr><tr><td><code>SYSTEM_ERROR</code></td><td>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.</td></tr><tr><td><code>BANK_ERROR</code></td><td>If the transaction receives an error on the bank side (other than authCode 00), this error group is returned.</td></tr><tr><td><code>DEVICE_ERROR</code></td><td>If an error is returned from the device, this error group is returned.</td></tr><tr><td><code>PAYMENT_ERROR</code></td><td>If an error is received from iyzico Payment services, this error group is returned.</td></tr><tr><td><code>BUSINESS_ERROR</code></td><td>If a situation that should not occur in terms of business logic has occurred, this error group is returned.</td></tr><tr><td><code>VALIDATION_ERROR</code></td><td>If there is a problem with the sent request, this error group is returned.</td></tr></tbody></table>

### Error Messages

<table data-full-width="false"><thead><tr><th width="199.796875">Hata Grubu</th><th width="140.98046875">Hata Kodu</th><th>Hata Mesajı </th></tr></thead><tbody><tr><td><code>TIMEOUT_ERROR</code></td><td>380103</td><td><pre><code>EN:
Timeout occurred while waiting for device response!

TR:
Cihaz yanıtı beklenirken zaman aşımı oluştu! </code></pre><p></p></td></tr><tr><td><code>BANK\_ERROR</code></td><td></td><td>The error message returned from the bank is being forwarded.</td></tr><tr><td><code>PAYMENT\_ERROR</code></td><td></td><td>The error message received from the payment service is being transmitted.</td></tr></tbody></table>

### "System Error" Error Messages

<table><thead><tr><th>Hata Grubu</th><th>Hata Kodu</th><th>Hata Mesajı</th></tr></thead><tbody><tr><td><code>SYSTEM_ERROR</code></td><td>100310</td><td><pre><code>EN:
Invalid token!

TR:
Geçersiz token! </code></pre></td></tr><tr><td><code>SYSTEM\_ERROR</code></td><td>100311</td><td><pre><code>EN:
Access token expired!

TR:
Token kullanım süresi dolmuştur! </code></pre></td></tr><tr><td><code>SYSTEM\_ERROR</code></td><td>380102</td><td><pre><code><strong>EN: </strong><strong>You do not have access to the information of this auth device! </strong><strong> </strong><strong>TR: </strong>Auth device bilgisine erişim hakkı yoktur! </code></pre></td></tr></tbody></table>

### "Device Error" Error Messages

<table><thead><tr><th>Hata Grubu</th><th>Hata Kodu</th><th>Hata Mesajı</th></tr></thead><tbody><tr><td><code>DEVICE_ERROR</code></td><td>380201</td><td><pre><code>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 </code></pre></td></tr><tr><td><code>DEVICE\_ERROR</code></td><td>380202</td><td><pre><code>EN:
Techpos application could not be started. Please try again.

TR:
Techpos uygulaması başlatılamadı. Lütfen tekrar deneyin. </code></pre></td></tr><tr><td><code>DEVICE\_ERROR</code></td><td>380203</td><td><pre><code>EN:
Null response received from Techpos application

TR:
Techpos uygulamasından boş (null) yanıt alındı </code></pre></td></tr><tr><td><code>DEVICE\_ERROR</code></td><td>380204</td><td><pre><code>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ı

</code></pre></td></tr><tr><td><code>DEVICE\_ERROR</code></td><td>380205</td><td><pre><code>EN:
Response message to be sent from device could not be created

TR:
Cihazdan gönderilecek yanıt mesajı oluşturulamadı </code></pre></td></tr></tbody></table>

### Validation Error Messages

<table><thead><tr><th>Hata Grubu</th><th>Hata Kodu</th><th>Hata Mesajı</th></tr></thead><tbody><tr><td><code>VALIDATION_ERROR</code></td><td>380104</td><td><pre class="language-json"><code class="lang-json">EN:
Device request validation error! Details: {0}
TR:
Request doğrulama hatası! Detaylar: {0}
</code></pre></td></tr><tr><td><code>VALIDATION_ERROR</code></td><td>380105</td><td><pre class="language-json"><code class="lang-json"><strong>EN:
</strong>Operation {0} is not supported for device modal: {1}
TR:{0} işlemi {1} model cihazda desteklenmemektedir

</code></pre></td></tr><tr><td><code>VALIDATION\_ERROR</code></td><td>380111</td><td><pre class="language-json"><code class="lang-json">EN:
Either transactionReferenceId or paymentId must be provided.
TR:
TransactionReferenceId veya PaymentId sağlanmalıdır. </code></pre></td></tr></tbody></table>

### "Business Error" Error Messages

<table><thead><tr><th>Hata Grubu</th><th>Hata Kodu</th><th>Hata Mesajı</th></tr></thead><tbody><tr><td><code>BUSINESS_ERROR</code></td><td>380101</td><td><pre><code><strong>En:
</strong><strong>Auth Device not found! For username: {0}
</strong><strong>
</strong>
TR:
Auth Device bulunamadı! username: {0}
</code></pre></td></tr><tr><td><code>BUSINESS_ERROR</code></td><td>380107</td><td><pre><code><strong>En:
</strong><strong>Payment not found with paymentId: {0}
</strong>
TR:
Ödeme bulunamadı paymentId: {0}
</code></pre></td></tr><tr><td><code>BUSINESS_ERROR</code></td><td>380108</td><td><pre><code><strong>En:
</strong>Payment not found with id: {0}

TR:
Ödeme bulunamadı id: {0} </code></pre></td></tr><tr><td><code>BUSINESS\_ERROR</code></td><td>380109</td><td><pre><code><strong>En: </strong>Payment not found with orderId: {0}

TR:
Ödeme bulunamadı orderId: {0} </code></pre></td></tr><tr><td><code>BUSINESS\_ERROR</code></td><td>380112</td><td><pre><code><strong>En: </strong>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. </code></pre></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iyzico.com/en/products/physical-pos/terminal-api-integration/error-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.