Қателер

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 тақырыбында да бар. Бізге жазғанда оны көрсетіңіз.

Параметр	Түрі	Сипаттама
error.type	string	Жалпы санат: `invalid_request_error`, `authentication_error`, `permission_error`, `idempotency_error`, `rate_limit_error`, `api_error`.
error.code	string	Машина оқитын тұрақты код, мысалы `member_not_found`. Логиканы хабарламаға емес, осы кодқа құрыңыз.
error.message	string	Әзірлеушіге арналған сөйлем. Ол өзгеруі мүмкін, оны парсингтемеңіз.
error.param	string	Қате қатысты сұрау өрісі, егер ондай өріс болса.
request_id	string	Әр жауаптың `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` қараңыз.
member_not_found	Карта нөміріне, штрихкодқа, телефонға немесе id-ге сәйкес қатысушы жоқ.
card_number_taken	Бұл мекемеде осы карта нөмірі басқа қатысушыда бар.
insufficient_balance	`redeem_amount` кэшбэк балансынан көп. Баланс `available` өрісінде.
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` міндетті.
check_too_old	`closed_at` мекеме қабылдайтын мерзімнен ескі.
scan_required	Мекеме мұны тек осы кілт жақында сканерлеген картаға қабылдайды.
refund_exceeds_check	Қайтарылатын сома чектің қалған бөлігінен көп. Қалдық `refundable` өрісінде.
adjustments_disabled	Мекеме API арқылы балансты түзетуге рұқсат бермеген.
idempotency_key_reused	Бір `Idempotency-Key` басқа денемен қолданылды.
rate_limited	Бұл кілттен сұраулар тым көп.