☰ Мәзір · Қателер
Бастау

Қателер

HTTP мәртебе коды мәселенің түрін көрсетеді. JSON денесі нақты не болғанын, ал қате бір өріске қатысты болса, қай өріс екенін айтады.

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
Жалпы санат: invalid_request_error, authentication_error, permission_error, idempotency_error, rate_limit_error, api_error.
error.codestring
Машина оқитын тұрақты код, мысалы member_not_found. Логиканы хабарламаға емес, осы кодқа құрыңыз.
error.messagestring
Әзірлеушіге арналған сөйлем. Ол өзгеруі мүмкін, оны парсингтемеңіз.
error.paramstring
Қате қатысты сұрау өрісі, егер ондай өріс болса.
request_idstring
Әр жауаптың X-Request-Id тақырыбында да бар. Бізге жазғанда оны көрсетіңіз.

Мәртебе кодтары

МәртебеМағынасыНе істеу керек
200, 201Сәтті. 201 жаңа нәрсе жасалғанын білдіреді.
400Сұрау дұрыс құрылмаған немесе өріс жарамсыз.Сұрауды түзетіңіз. Сол денені қайта жіберсеңіз, жауап өзгермейді.
401Кілт жоқ, белгісіз немесе кері қайтарылған.Кілтті тексеріңіз.
402Сұрау дұрыс, бірақ орындау мүмкін емес, мысалы баланс жеткіліксіз.Қонаққа хабарламаны көрсетіңіз. Толығырақ ақпарат денеде.
403Кілтте бұл шақыруға керек құқық жоқ.Хабарламада аталған құқығы бар кілтті пайдаланыңыз.
404Бұл мекемеде мұндай қатысушы, транзакция, тағам немесе тапсырыс жоқ.Идентификаторды тексеріңіз.
409Қайшылық: карта нөмірі бос емес, мәртебені ауыстыруға болмайды немесе шақыру кезінде баланс өзгерді.Кодты қараңыз. balance_conflict болса, сол external_id арқылы қайталаңыз.
429Сұраулар тым көп.Retry-After секунд күтіңіз.
500, 502, 503Біз жақта ақау болды.Кідірісті ұлғайта отырып, сол external_id немесе Idempotency-Key арқылы қайталаңыз. Ештеңе екі рет өтпейді.

Жиі кездесетін кодтар

КодҚашан
parameter_invalidӨріс жоқ немесе пішімі қате. param қараңыз.
endpoint_not_foundБұл жолда эндпоинт жоқ. Әдіс пен жолды анықтамалықпен салыстырыңыз.
member_not_foundКарта нөміріне, штрихкодқа, телефонға немесе id-ге сәйкес қатысушы жоқ.
card_number_takenБұл мекемеде осы карта нөмірі басқа қатысушыда бар.
insufficient_balanceredeem_amount кэшбэк балансынан көп. Баланс available өрісінде. max_amount осы чектен жұмсауға болатын ең көп сома, ал limited_by қай шектеу қолданылғанын айтады.
redeem_not_supportedҚатысушының бағдарламасында төлеуге болатын кэшбэк балансы жоқ.
visit_not_supportedКэшбэк бағдарламасына келу жіберілді. Оның орнына сомасы бар чек жіберіңіз.
no_reward_availableҚатысушыда алуға болатын сыйлық жоқ.
transaction_not_foundБұл external_id бойынша транзакция жоқ.
invalid_status_transitionТапсырысты ағымдағы мәртебеден сіз жіберген мәртебеге ауыстыруға болмайды.
missing_scopeКілтте керекті құқық жоқ.
hold_requiredМекеме кэшбэкпен төлеуді тек резерв арқылы қабылдайды. Резервті POST /v1/holds арқылы жасаңыз.
hold_expired, hold_captured, hold_releasedРезервті енді пайдалануға болмайды. Жаңасын жасаңыз.
register_id_requiredМекеме чектерді әр касса бойынша нөмірлейді, сондықтан register_id міндетті.
redeem_not_allowed_hereОсы register_id байланған нүктеде кэшбэкпен төлеуге болмайды. Чекті redeem_amount 0 арқылы жіберіңіз (есептеу сақталады) немесе басқа нүктеде төлеңіз.
discount_redeem_not_allowedОсы discount_type бар чекте кэшбэк жұмсауға болмайды: иесі бұл жеңілдік үшін кэшбэкпен төлеуге тыйым салған. Чекті redeem_amount 0 етіп жіберіңіз (түр рұқсат етсе, қонаққа бәрібір есептеледі).
check_too_oldclosed_at мекеме қабылдайтын мерзімнен ескі.
scan_requiredМекеме мұны тек осы кілт жақында сканерлеген картаға қабылдайды.
refund_exceeds_checkҚайтарылатын сома чектің қалған бөлігінен көп. Қалдық refundable өрісінде.
adjustments_disabledМекеме API арқылы балансты түзетуге рұқсат бермеген.
idempotency_key_reusedБір Idempotency-Key басқа денемен қолданылды.
rate_limitedБұл кілттен сұраулар тым көп.
Интеграция бойынша сұрақтар: api@loyaltyfy.io. Бір жұмыс күні ішінде жауап береміз.