☰ Мәзір · Өзгерістер тізімі
Тағы
Өзгерістер тізімі
API-да не өзгерді, жаңасынан бастап.
2026 жылғы 22 қараша
POST /v1/transactions,POST /v1/checks/calculateжәнеPOST /v1/holdsішіндегіcashier: чекті кім өткізгенін айтатын жол не{id, name}. Чекпен және холдпен сақталады,cashierішінде қайтарылады және иесінің кассир сигналдарында қолданылады. Кэшбэкті ешқашан өзгертпейді және идемпотенттік тексеруге кірмейді.
2026 жылғы 17 қараша
- «Бір сапарда қонақ не жинайды, не жұмсайды» ережесі: есептен шығару бар чек кэшбэк бермейді, ал
POST /v1/checks/calculateжәнеPOST /v1/transactionsжауаптарындаearn_blocked: "redeemed"болады. Ереже болмаса, бұл өріс жоқ.
2026 жылғы 16 қараша
- Нүктелер: иесі касса кодтары мен дүкен кодтарын нүктелерге байлайды.
register_idболмаса немесе нүктеге байланбаса, чектермен, есептеулермен және холдтарменstore_idжіберіңіз; жауаптардаmatched_byбарlocationболады. Қараңыз: нүкте мен кассаны қалай жіберу керек. - Нүкте ережелері: өз пайызы, жинау өшірулі, кэшбэкпен төлеу нүктеде тыйым салынған немесе шектелген. Тыйым салынған жерде кэшбэкі бар чек не холд
400 redeem_not_allowed_hereарқылы қабылданбайды, ал есептеуredeem_blocked_reasonқайтарады. Нүктедегі тауар мен санат ерекшеліктері:GET /v1/catalog/location-rules. - Атауы бойынша санат: ережелердің толық реті қосулы мекемелер
line_items[].categoryішінде санаттың атауын да, кодын да қабылдайды. Атау ешқашан жаңа санат жасамайды; ең нақты ереже жеңеді. - Акциядағы тауарлар:
line_items[].promo: true; иесі мұндай жолдар кэшбэк беретінін және оларды кэшбэкпен төлеуге болатынын шешеді. - Жеңілдік түрлері: чекте және жолдарда
discount_type; иесі әр түр үшін кэшбэк беретінін және кэшбэкпен төлеуге болатынын белгілейді, әйтпесе400 discount_redeem_not_allowed. - Кэшбэк төлем немесе жеңілдік ретінде: жеңілдік режимінде әр жолда
redeem_allocatedбар; режимsettings.redeem_accountingішінде. - Офлайн:
GET /v1/accountsettingsішіндеtimeout_seconds,offline_redeemжәнеoffline_max_hoursқайтарады. Қараңыз: Касса байланыссыз болғанда. - Сыйлықтар:
POST /v1/checks/calculategifts.pendingжәнеgifts.unlocksқайтарады,POST /v1/transactionsgifts.unlockedқайтарады; сыйлықты берілді деп белгілеу:POST /v1/members/{member}/gifts/{gift_id}/give. Оқиғаларgift.unlockedжәнеgift.given.
2026 жылғы 5 қараша
- Әр транзакцияда және
POST /v1/checks/calculateжауабында әр позицияның есептегенін көрсететінline_itemsбар:amount,cashback_earned,earn_percent,redeemable,quantity_refunded. - Позициялар бойынша қайтарулар:
POST /v1/transactions/{external_id}/refundsкод пен санменline_itemsқабылдайды; кэшбэк әр позицияның шын мәнінде есептегеніне сәйкес жүреді. - Карта нөмірінің префиксі: иесі оны кассаларға арналған ережелерде қояды, жаңа карталар онымен басталады;
GET /v1/accountішіндеsettings.card_prefix. - Тауар бойынша ережелер: иесі санатты бір тауарда тұрақты немесе күндер арасында өзгертеді;
GET /v1/catalog/productsолардыrulesішінде қайтарады. - Кэшбэк минусқа кетуі мүмкін: қайтару немесе жою қонақ жұмсап қойған кэшбэкті алып тастайды,
cashback.balanceтеріс болады, ал келесі чек алдымен қарызды жабады. - Кабинет: карта тіліндегі туған күн құттықтаулары, суретсіз оқиғалар мен туған күн баннерлері (мәтін карта дизайнының үстіне түседі), мөртабандар жиналған сәтте өзгеретін мөртабан деңгейлері.
- Кабинет: автокампаниялар (тауар сатып алды, сатып алуды тоқтатты, сегментке кесте) жіберу журналымен; LTV-мен сатып алушылар когорталары; сатып алынған тауарлар мен кэшбэк балансы бойынша сегменттер.
- Позицияларды қайтару:
POST /v1/transactions/{external_id}/returnsқайтарылғанline_itemsқабылдап, кэшбэкті әр позицияның есептегеніне қарай жылжытады; позициялары бар қайтарудағыдай қозғалтқыш, бөлек эндпоинт ретінде.
2026 жылғы 24 қазан
- Өзімен алу тапсырыстары:
location,pickup_at,guestжәнеday_numberбарtype: pickup. - Әр тапсырыста
paymentжәнеhistoryбар.GET /v1/orders?type=және?location=қабылдайды. - Міндетті таңдауы бар тағам таңдаусыз қосылса, сізге жетпей тұрып
needs_optionsарқылы қабылданбайды.
2026 жылғы 9 қазан
- Жойылған немесе толық қайтарылған чек енді келу мен шығын болып есептелмейді, сондықтан қайтарулар қонақтың кэшбэк деңгейін көтермейді.
/v1ішіндегі белгісіз жолдар сайт бетінің орнына JSON404 endpoint_not_foundқайтарады;GET /v1өзі API-ды сипаттайды.- Тексеру қателері нені жіберу керектігін айтады, мысалы
amountең кіші бірліктегі бүтін сан екенін.
2026 жылғы 7 қазан
- Кассаларға арналған мекеме ережелері: кэшбэкпен резерв арқылы төлеу, әр кассаның чек нөмірлері, кешіккен чектерге лимит, бір чекке және бір күнге кэшбэк лимиттері, картаны міндетті сканерлеу, қолмен түзету. Әр кілттің өз мәндері болуы мүмкін.
GET /v1/accountережелердіsettingsішінде қайтарады. - Резервтер:
POST /v1/holds,hold_idарқылы растау, босату, мерзімі өткенде өздігінен босату. POST /v1/checks/calculateештеңе жазбай, чек не беретінін көрсетеді.- Ішінара қайтарулар:
POST /v1/transactions/{external_id}/refunds. - Каталог: тауарларды SKU бойынша жүктеу. Мекеме иесі әр санатқа кэшбэк бере ме, оны кэшбэкпен төлеуге бола ма және өз пайызы қандай екенін орнатады.
- Қатысушыларда кэшбэктің
levels,next_level,heldжәнеavailableмәндері көрсетіледі. - Әр чекте, сканерлеуде және есептеуде кассир мен чекке арналған дайын мәтіні бар
displayбар. - Жаңа құқықтар:
members:adjust,catalog:read,catalog:write. Жаңа оқиғалар:transaction.refunded,balance.adjusted.
2026 жылғы 6 қазан
/api/v1мекенжайындағы API v1, бағдарламаның барлық түрі үшін: кэшбэк, штамптар, келу жеңілдіктері, VIP деңгейлері.- Қатысушылар: өз карта нөміріңізбен тіркеу, карта, штрихкод, телефон немесе id бойынша іздеу, тарих, сыйлық беру.
- Әр бағдарламаға карта штрихкодының пішімі: карта нөмірі бар QR немесе Code 128, не болмаса сериялық нөмірі бар QR.
line_itemsбар транзакциялар, болдырмау, бағдарлама шектерімен кэшбэкпен төлеу.- Киосктер мен сканерлер:
POST /v1/scans,POST /v1/visits,devices:writeқұқығы. external_idішінде өз SKU-іңізбен жұмыс істейтін мәзір API-ы, бағалар мен стоп-листті топтап синхрондау.- QR-мәзірден келетін, POS үшін мәртебелері бар үстел тапсырыстары.
- Қолтаңбалар мен қайталаулары бар вебхуктар,
Idempotency-Key, курсорлық беттеу, кілт құқықтары. /api/pos/v1мекенжайындағы бұрынғы POS API жұмыс істей береді.