☰ Menü · Hatalar
Başlarken

Hatalar

HTTP durum kodu sorunun türünü, JSON gövdesi ise tam olarak ne olduğunu ve sorun tek bir alanla ilgiliyse hangi alan olduğunu söyler.

JSON
{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "consent: must be true: confirm the guest agreed to data processing",
    "param": "consent"
  },
  "request_id": "req_0d4d15b86c484738b46b"
}
error.typestring
Genel sınıf: invalid_request_error, authentication_error, permission_error, idempotency_error, rate_limit_error, api_error.
error.codestring
Makinenin okuyacağı sabit kod, örneğin member_not_found. Kodunuzu mesaja göre değil, bu alana göre dallandırın.
error.messagestring
Geliştiriciye yönelik açıklama. Değişebilir, ayrıştırmaya çalışmayın.
error.paramstring
Hatanın ilgili olduğu istek alanı (varsa).
request_idstring
Her yanıtın X-Request-Id başlığında da bulunur. Bize yazarken ekleyin.

Durum kodları

DurumAnlamıNe yapmalı
200, 201Başarılı. 201 yeni bir kayıt oluşturulduğunu gösterir.
400İstek hatalı veya bir alan geçersiz.İsteği düzeltin. Aynı gövdeyle tekrar denemek aynı yanıtı verir.
401Anahtar yok, tanınmıyor veya iptal edilmiş.Anahtarı kontrol edin.
402İstek geçerli ama gerçekleştirilemiyor, örneğin bakiye yetersiz.Mesajı misafire gösterin. Ayrıntılar gövdededir.
403Anahtarda bu istek için gereken izin yok.Mesajda belirtilen izne sahip bir anahtar kullanın.
404Üye, işlem, ürün veya sipariş bu işletmede bulunamadı.Tanımlayıcıyı kontrol edin.
409Çakışma: kart numarası kullanımda, durum geçişine izin verilmiyor veya istek sırasında bakiye değişti.Koda bakın. balance_conflict durumunda aynı external_id ile tekrar deneyin.
429Çok fazla istek.Retry-After başlığındaki süre kadar (saniye) bekleyin.
500, 502, 503Bizim tarafımızda bir sorun oluştu.Artan aralıklarla ve aynı external_id veya Idempotency-Key ile tekrar deneyin. Hiçbir işlem iki kez uygulanmaz.

Sık görülen kodlar

KodNe zaman
parameter_invalidBir alan eksik veya biçimi hatalı. param alanına bakın.
endpoint_not_foundBu yolda bir uç nokta yok. Yöntemi ve yolu referansla karşılaştırın.
member_not_foundKart numarası, barkod, telefon veya id ile eşleşen üye yok.
card_number_takenBu kart numarası bu işletmede başka bir üyeye ait.
insufficient_balanceredeem_amount cashback bakiyesinden fazla. Bakiye available alanındadır. max_amount bu fişte kullanılabilecek en yüksek tutar, limited_by ise hangi sınırın uygulandığını söyler.
redeem_not_supportedÜyenin programında harcanabilecek cashback bakiyesi yok.
visit_not_supportedCashback programı için ziyaret gönderildi. Bunun yerine tutarlı bir fiş gönderin.
no_reward_availableÜyenin kullanabileceği kazanılmış ödül yok.
transaction_not_foundBu external_id ile bir işlem yok.
invalid_status_transitionSipariş mevcut durumundan gönderdiğiniz duruma geçemez.
missing_scopeAnahtarda gerekli izin yok.
hold_requiredİşletme cashback'i yalnızca rezervasyonla kullandırıyor. POST /v1/holds ile bir rezervasyon oluşturun.
hold_expired, hold_captured, hold_releasedRezervasyon artık kullanılamaz. Yeni bir tane oluşturun.
register_id_requiredİşletme fişleri kasa bazında numaralandırıyor, bu yüzden register_id zorunludur.
redeem_not_allowed_hereBu register_id'nin bağlı olduğu şubede cashback harcanamaz. Fişi redeem_amount 0 ile gönderin (müşteri kazanmaya devam eder) veya başka bir şubede harcayın.
discount_redeem_not_allowedBu discount_type ile gelen fişte cashback kullanılamaz: işletme sahibi bu indirimde cashback ile ödemeyi yasakladı. Fişi redeem_amount 0 ile gönderin (tür izin veriyorsa misafir yine kazanır).
check_too_oldclosed_at, işletmenin kabul ettiğinden daha eski.
scan_requiredİşletme bunu yalnızca bu anahtarın kısa süre önce okuttuğu bir kart için kabul ediyor.
refund_exceeds_checkİade, fişten geriye kalan tutardan fazla. Kalan tutar refundable alanındadır.
adjustments_disabledİşletme API üzerinden bakiye düzeltmelerine izin vermedi.
idempotency_key_reusedAynı Idempotency-Key farklı bir gövdeyle kullanıldı.
rate_limitedBu anahtardan çok fazla istek geldi.
Entegrasyonla ilgili sorularınız için: api@loyaltyfy.io. Bir iş günü içinde yanıt veriyoruz.