9. Tüm hata kodları
| HTTP | code | Nerede | Anlamı | Ne yapılmalı |
|---|---|---|---|---|
| 400 | VALIDATION | her yerde | İstek hatalı: eksik alan, yanlış tip, yanlış formatta eşleştirme kodu veya Fırsat kodu olmayan bir kod. Önizlemede details.code: "QR_TOKEN_EXPIRED" eski bir QR kod demektir. | İsteği düzeltin. Önizlemede "Geçersiz kod. Müşterinin Fırsat uygulamasındaki QR'ı okutun veya 6 haneli kodu girin." gösterin; eski QR için müşteriden kodu uygulamada yenilemesini isteyin. |
| 400 | POS_SOLUTION_HEADER_REQUIRED | token isteği dışında her yerde | X-Firsat-Pos yok ya da geçerli bir header id değil. | Entegrasyon hatası: POS header id'nizi Fırsat'ın verdiği gibi gönderin. |
| 400 | POS_PARTNER_CONNECTION_REQUIRED | işletme çağrıları | X-Firsat-Connection yok veya UUID değil. | Entegrasyon hatası: X-Firsat-Connection header'ını ekleyin. |
| 401 | POS_PARTNER_INVALID_CLIENT | token | Client id veya secret yanlış. | Kimlik bilgilerini kontrol edin. Doğruysa Fırsat ile iletişime geçin (dev@firsat.com). |
| 401 | POS_PARTNER_TOKEN_INVALID | her yerde | Token yok, süresi dolmuş veya iptal edilmiş; secret'ınız yenilenmeden önce alınmış bir token da dahil. | Bir kez yeni token alıp tekrar deneyin. |
| 403 | POS_SOLUTION_HEADER_MISMATCH | token isteği dışında her yerde | X-Firsat-Pos, token'ınızın alındığı POS'tan başka bir POS'u gösteriyor. | Entegrasyon hatası: kendi header id'nizi gönderdiğinizi kontrol edin (her POS'unuzun kendi kimlik bilgileri ve header id'si vardır). |
| 403 | POS_CONNECTION_REVOKED | işletme çağrıları | İşletme bu bağlantıyı iptal etmiş. | Bu işletme için çağrı yapmayı bırakın; yeni eşleştirme kodu isteyin. |
| 404 | NOT_FOUND | her yerde | Bilinmeyen id: size ait olmayan bir bağlantı, bağlantıda olmayan bir şube, başka bağlantının önizlemesi veya bilinmeyen bir menü ürünü. | Id'leri kontrol edin. Şube için GET /branches ile listeyi yenileyin. |
| 404 | POS_PAIRING_CODE_INVALID | claim | Kod bilinmiyor, süresi dolmuş, kullanılmış, bağlantısı kapanmış ya da başka bir POS için açılmış. | İşletmeden yeni kod isteyin. |
| 409 | POS_REDEMPTION_FAILED | onay | Reddedildi; sebep details.reason'da (7.5). | Fiş satırlarını geri alın. |
| 409 | POS_REDEMPTION_PREVIEW_USED | onay | Önizleme başka bir key ile zaten onaylandı veya reddedildi. | Fiş satırlarını geri alın. |
| 409 | POS_REDEMPTION_IN_PROGRESS | onay | Bu key ile gönderilen ilk istek hâlâ işleniyor. | Kısa süre sonra aynı key ve gövdeyle tekrar deneyin. |
| 409 | POS_IDEMPOTENCY_KEY_CONFLICT | onay | Key daha önce farklı bir gövdeyle kullanılmış. | Entegrasyon hatası: previewId başına tek key, her tekrar denemede aynı gövde (bölüm 11). Fiş satırlarını geri alın. |
| 410 | POS_REDEMPTION_PREVIEW_EXPIRED | onay | expiresAt'ten sonra onaylandı. Hiçbir şey harcanmadı. | Geri alın ve tekrar önizleme yapın. |
| 429 | RATE_LIMITED | her yerde | Çok fazla istek veya önizlemede çok fazla hatalı kod. | Retry-After saniye bekleyin. |
| 429 | REDEEM_LOCKED | önizleme | Bu şubede çok fazla hatalı kod; geçici olarak kilitli. | Birkaç dakika bekleyin. |
| 5xx | (çeşitli) | her yerde | Bizim tarafımızda hata. | Bekleyerek tekrar deneyin. Onayda aynı key ile tekrar deneyin (7.6). |
Onayda yalnızca 7.6'daki geçici cevaplarda tekrar deneyin; bu tabloda olmayan bir kod dahil diğer her cevapta durun ve fiş satırlarını geri alın.