Hatalar

Başarısız bir istek, 4xx ya da 5xx HTTP durumuyla ve JSON bir gövdeyle döner.

{
  "error": "Conflict",
  "code": "POINTS_ALREADY_SPENT",
  "message": "These points were already spent."
}

Alan	Açıklama
`error`	HTTP durumunun adı (`Bad Request`, `Conflict`, …)
`code`	Kararlı, makine tarafından okunabilir hata kodu. Kodunu `code` üzerine kur.
`message`	İngilizce, insanın okuyacağı açıklama. Metni değişebilir, ona güvenme

Doğrulama hatalarında code yoktur

Gövdesi ya da başlığı geçersiz bir istek 400 döner ve code içermez. message hangi alanın yanlış olduğunu söyler:

{ "error": "Bad Request", "message": "idempotency-key: Idempotency-Key header is required" }

HTTP durumları

Durum	Anlamı
`200` / `201`	Başarılı. `201` yeni kayıt, `200` yinelenen isteğin (`replayed: true`) yanıtıdır
`400`	İstek hatalı: eksik alan, geçersiz QR
`401`	API anahtarı yok ya da geçersiz
`402`	İşletmenin aboneliği (deneme bitti ya da askıda) okutmayı engelliyor
`403`	Yetkin yok: başkasının girişi, süresi geçmiş iptal
`404`	Kayıt bulunamadı
`409`	Çakışma: kullanılmış QR, yetersiz bakiye, tekrarlanan istek
`413`	İstek gövdesi 1 MB'tan büyük (`PAYLOAD_TOO_LARGE`)
`422`	Tutar kurallara uymuyor
`429`	Çok fazla istek ya da günlük sınır
`5xx`	Bizde bir sorun var. Aynı `Idempotency-Key` ile tekrar dene

Kod	Durum	Anlamı
`UNAUTHORIZED`	401	Anahtar eksik, hatalı ya da iptal edilmiş
`QR_INVALID`	400	QR geçerli değil ya da başka bir işletmeye ait
`QR_EXPIRED`	400	QR'ın 30 saniyelik ömrü doldu; müşteri yenilemeli
`QR_ALREADY_USED`	409	Bu QR daha önce okutuldu
`SCAN_NOT_FOUND`	404	`scanId` bulunamadı; QR'ı yeniden okut
`SCAN_INVALID`	409	Okutma kullanıldı ya da 5 dakikası doldu; yeniden okut
`MEMBERSHIP_NOT_FOUND`	404	Üye bulunamadı
`MEMBERSHIP_BLOCKED`	403	Üyelik engellenmiş

Kod	Durum	Anlamı
`INVALID_AMOUNT`	400	Tutar sıfırdan büyük olmalı
`INVALID_STAMPS`	400	Damga sayısı en az 1 olmalı (hibritte 0 olabilir)
`TOO_MANY_STAMPS`	422	Damga sayısı tek ziyarette verilebilecek üst sınırı aşıyor
`NOTHING_TO_EARN`	400	Hibrit programda ne damga ne tutar var
`AMOUNT_TOO_HIGH`	422	Tutar işletmenin izin verdiği üst sınırı aşıyor
`DAILY_EARN_LIMIT`	429	Bu müşteri bugünkü kazanım sınırına ulaştı
`CASHIER_DAILY_LIMIT`	429	Bu anahtar bugünkü kazanım sınırına ulaştı
`DUPLICATE_RECEIPT`	409	Bu `receiptNo` zaten kullanıldı
`DUPLICATE_REQUEST`	409	Bu `Idempotency-Key` başka bir işlem için kullanılmış
`NO_PROGRAM`	409	İşletmenin henüz sadakat programı yok

Kod	Durum	Anlamı
`REWARD_REQUIRED`	400	Kullandırılacak ödül seçilmemiş (normal QR'da `rewardId` şart)
`REWARD_MISMATCH`	400	`rewardId`, QR'daki ödülle aynı değil
`CASHIER_DAILY_LIMIT`	429	Bu kasiyer ya da anahtar bugünkü sınıra ulaştı
`INSUFFICIENT_BALANCE`	409	Yeterli puan ya da damga yok
`REWARD_NOT_FOUND`	404	Ödül bulunamadı
`REWARD_INACTIVE`	409	Ödül kapalı
`REWARD_OUT_OF_STOCK`	409	Ödülün stoğu bitti
`REWARD_EXPIRED`	409	Ödülün süresi doldu
`REWARD_NOT_STARTED`	409	Ödül henüz başlamadı
`REWARD_LIMIT_REACHED`	409	Müşteri bu ödül için sınıra ulaştı

Kod	Durum	Anlamı
`ENTRY_NOT_FOUND`	404	Kayıt bulunamadı
`NOT_VOIDABLE`	409	Yalnızca puan kazanımı ve ödül kullanımı iptal edilebilir
`ALREADY_VOIDED`	409	Kayıt zaten iptal edilmiş
`POINTS_ALREADY_SPENT`	409	Kazanılan puanlar harcanmış
`FORBIDDEN`	403	Yalnızca kendi girişini iptal edebilirsin
`VOID_WINDOW_PASSED`	403	15 dakika geçti; yalnızca yönetici iptal edebilir

Kod	Durum	Anlamı
`TRIAL_EXPIRED`	402	Deneme süresi doldu
`SUBSCRIPTION_SUSPENDED`	402	Abonelik askıda
`LOCATION_REQUIRED`	400	Şube belirtilmedi (anahtar tek şubeye bağlıysa olmaz)
`LOCATION_FORBIDDEN`	403	Bu şubeyi kullanamazsın
`LOCATION_NOT_FOUND`	404	Şube bulunamadı ya da kapatılmış
`RATE_LIMITED`	429	İstek sınırını aştın
`PAYLOAD_TOO_LARGE`	413	İstek gövdesi çok büyük

İşletme sahibi 402 hatalarında Mekante destek ekibiyle iletişime geçmelidir; kasa tarafında yapılacak bir şey yoktur.