☰ Мәзір · Өзгерістер тізімі
Тағы

Өзгерістер тізімі

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/account settings ішінде timeout_seconds, offline_redeem және offline_max_hours қайтарады. Қараңыз: Касса байланыссыз болғанда.
  • Сыйлықтар: POST /v1/checks/calculate gifts.pending және gifts.unlocks қайтарады, POST /v1/transactions gifts.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 ішіндегі белгісіз жолдар сайт бетінің орнына JSON 404 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 жұмыс істей береді.
Интеграция бойынша сұрақтар: api@loyaltyfy.io. Бір жұмыс күні ішінде жауап береміз.