QR сканер интерфейсы. Бер тапкыр кулланыла торган пропуск гамәлләре планлаштырылган.

← Bubble Native буенча барлык кулланмалар

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Бер кулланылышлы билетлар, алу раслану яки купоннар төзегез. Хезмәткәр кодны сканлый, нәтиҗәне тикшерә, заказны карап ала һәм әзер булганда кулланылышны раслый.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Эш агымын төзегез ↓Плагин көйләүләре ↗Native Lab

Документация каралган 6 ноябрь 2026

Практик мисаллар

Көн эчендәге чара өчен бер тапкыр кулланыла торган керү.

Гадәти QR кыйммәтенең скриншоты башка керүләрдә берничә керү ноктасында кулланыла ала.

Кушымтагыз Admission язмасын һәм тотрыклы чыгарылыш `request_id` саклый; `label=event`ны көйләнгән итеп кулланыгыз һәм `ttl_seconds`ны 1–86400‑нче контракт кысаларында кулланыгыз.

Вәкаләтле чыгаручы Issue QR pass эшләтә һәм кайтарылган QR кодын тиешле кешегә аерым тапшыра. Хезмәткәр сканлый → Check QR pass → `ok=yes` һәм `status=available` булганда гына раслый → сакланган тотрыклы сорау ID белән Confirm QR redemption.

`status=redeemed` белән `receipt_id` бергә булганда гына кушымтагыз керү раслануын бирә ала. Пропуск/куллану раслануына сылтаманы Admission язмасында саклагыз; QR эчтәлеген аналитикага җибәрмәгез.

`outcome_unknown` өчен, бер үк кулланучы/мохит/пасс белән шул ук сорауны торгыз; яңа раслау IDсын булдырмагыз. expired, revoked һәм инде кулланылган хәлләрне аерым нәтиҗәләр итеп эшкәртегез.

Планлаштырылган. Сканлау һәм тикшерү пассны кулланмый; бары тик ачык раслау гына куллана.

Партнер кассасында кыска вакытлы файдасын бер тапкыр кулланыгыз.

Партнер расланган кулланылган/кулланылмаган нәтиҗәне таләп итә, QR рәсеме яки экран анимациясенә ышанмый.

`label=coupon`; кушымтаның Benefit язмасы хокуклылыкны һәм авторизацияләнгән чыгарылыш гамәленнән алда кыска гамәл вакытын билгели.

Кушымтагыз файдалану хокукын тикшергәч кенә пропуск чыгарыгыз. Партнер ноктасында Check QR pass аны кулланмыйча куллану мөмкинлеген күрсәтә. Хезмәткәр өстенлекнең бирелүен раслагач, Confirm QR redemption эшләтегез.

Benefit язмагыз `receipt_id`ны һәм `status=redeemed`дан соң расланган куллану вакытын саклый ала. Плагин пасс халәтен идарә итә; кушымтагыз файда һәм клиент мөнәсәбәтләрен идарә итә.

Файда кулланылмыйча кире кагылган очракта, шул ук авторизацияләнгән чыгаручы Revoke QR passны үз `pass_id`сы белән эшләтә ала. `ok=yes`дан гына кайтару яки уңышлы куллану турында игълан итмәгез.

Планлаштырылган. Сканлау һәм тикшерү пассны кулланмый; бары тик ачык раслау гына куллана.

Көн эчендәге җиһаз яки заказны алуны раслагыз.

Хезмәткәрнең эш процессы заказны алу белешмәсен сканлау белән әйберне чынлап тапшыруны аерырга тиеш.

Кушымтагызның ия булган Collection язмасы авторизацияне, планлаштырылган предметны һәм аерым тотрыклы чыгарылыш/куллану сорау IDларын саклый; кыска вакытлы `label=access` пассны кулланыгыз.

Кушымтагыз әйберне алуга рөхсәт биргәч, Issue QR pass эшләтегез. Хезмәткәр сканлый һәм Check эшләтә, кушымтадагы туры килгән Collection язмасын карый, аннары тапшыруны ачык раслый һәм Confirm QR redemption эшләтә.

`redeemed` куллану раслануын алганнан соң гына эш процессы Collection язмасын тапшырылган дип билгеләргә тиеш. `receipt_id` кыйммәтен пропуск нәтиҗәсенә сылтама итеп саклагыз.

Кабат сканлау already_usedны кайтарырга мөмкин; башка предметны тапшыру урынына бар булган кушымта язмасын күрсәтегез. Шул ук ID һәм кертемнәр белән билгесез раслауны торгыз.

Планлаштырылган. Сканлау һәм тикшерү пассны кулланмый; бары тик ачык раслау гына куллана.

Хәзер эшли торганнар

Шәхси бета. Хәзерге сканер камера һәм рөхсәт контрольләренә ия. Бер кулланылышлы үтү билгеләрен төзү, тикшерү һәм раслау планлаштырылган һәм сезнең кушымтада әле куллануга әзер түгел.

Эш агымын төзегез

Планлаштырылган

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

Бу мисалларда Lesson, Message һәм Order кебек кушымта язмалары кулланыла. Аларны үзегезнең мәгълүмат төрләрегез һәм элемент исемнәрегез белән алыштырыгыз. Мисал медиа адресларын үз файлларыгыз белән алыштырырга кирәк.

Планлаштырылган: рөхсәте булган хезмәткәр Admission яки Order язмасы өчен Issue QR pass эшләтә. Мисал: label=event, ttl_seconds=900, environment=development. Бу чыгару гамәле өчен тотрыклы request_id саклагыз һәм pass_id кыйммәтен шул язма белән саклагыз.
Кайтарылган QR ны аның тиешле иясенә күрсәтегез. Хезмәткәр аны сканлый. Планлаштырылган үтү билгесе эш агышында workflow_mode=yes кулланыгыз һәм scanned_pass_token ны pass_scanned дан соң укыгыз. Бу үтү‑эш агышы көйләүләре хәзерге сканерда юк.
Check QR pass ны pass_token = QR Scanner's scanned_pass_token белән эшләтегез. Ул үтү билгесен кулланмыйча тикшерә. status=available өчен, туры килгән заказ яки керү детальләрен күрсәтегез, хезмәткәр аларны карап ала ала.
Тик аерым “Раслау” төймәсе Confirm QR redemption ны шул ук pass_token, тотрыклы request_id һәм confirm=yes белән эшләтә. status=redeemed вакытында receipt_id ны саклагыз һәм заказ яки керүне тәмамланган итеп билгеләгез.
already_used, expired, revoked яки invalid булса, кешене кертмәгез һәм заказны тапшырмагыз. Сканлау яки уңышлы Check гамәле генә транзакцияне беркайчан да тәмамламый.

Эш агымы схемасы — кушымта скриншоты түгел

Бер тапкыр көйләгез

BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз. Xodera QR Passes Native сайлагыз, аның ачкычын күчерегез, аннары Bubble → Plugins → Xodera QR Passes Native ачыгыз һәм project_api_key эченә кертегез. Бер тапкыр саклагыз; аннары түбәндәге гамәлләрне кулланыгыз. Һәр проекттагы һәр плагинның үз ачкычы бар.

Сканерлау камера рөхсәтен таләп итә. Бер кулланылышлы үтү билгеләре өчен, кем үтү билгеләрен булдыра ала һәм кем капкада яки алу ноктасында тикшерә ала икәнен билгеләгез. Гадәти клиентларга хезмәткәр роле кирәк түгел.

`qr_issuer_permission_field`

qr_pass_issuer · Пропуск чыгара яки кире ала алган хезмәткәрләрне билгеләүче User yes/no кырының исеме. Мисал/килешү: qr_pass_issuer. Монда yes яки no түгел, кыр исемен языгыз. Кулланучының бу рөхсәтен вәкаләтле администратор гына үзгәртергә тиеш.

`qr_staff_permission_field`

qr_staff · Пропускны тикшерә һәм куллануны раслый алган хезмәткәрләрне билгеләүче User yes/no кырының исеме. Мисал/килешү: qr_staff. Билет иясенә бу рөхсәт кирәк түгел. Аны ачык теркәлү һәм профиль формаларына кертмәгез.

Бер тапкыр көйләгез

BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз.
Бу плагинны сайлагыз һәм аның проект ачкычын күчерегез.
Bubble → Plugins → Xodera QR Passes Native ачыгыз; ачкычны project_api_key эченә кертегез һәм саклагыз.
Элементны өстәгез, кушымта мәгълүматларын сайлагыз һәм түбәндәге эш агымын төзегез.
Хәзер өчен генә шәхси бета керү. Җәмәгатькә урнаштыру һәм түләүле активлаштыру әле ачык түгел.

Урнаштыру һәм язылу

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Нәтиҗәне кушымтагызда саклагыз

Admission яки Pickup мисалы: бәйле заказны/чараны, pass_id, expires_at һәм issue_request_id саклагыз. Куллану раслангач, receipt_id, redeemed_at һәм раслаган хезмәткәрне өстәгез. Кодны сканлау яки тикшерү генә язманы тәмамланган дип билгеләү өчен җитми. QR коды кешенең шәхесен расламый.

Уңышсызлык, гамәлне туктату һәм торгызу

Әгәр outcome_unknown=yes, шул үтү билгесен, request_id һәм кертемнәрне нәтиҗәне кабат тикшергәндә саклагыз. Яңа раслау булдырмагыз. already_used, expired һәм revoked соңгы бизнес нәтиҗәләре. Рөхсәт кире кагылган очракта, хезмәткәрнең ролен карау өчен авторизацияләнгән администраторга мөрәҗәгать итегез. Clear session сканерны яңарта; ул тәмамланган кулланылышны кире кайтара алмый.

Мөмкинлекләр һәм чикләүләр

Планлаштырылган үтү билгеләре бер кулланылышлы, гомумән 1–86400 секундка кадәр яши; стандарт 900. Үтү төрләре: access, event, coupon һәм membership. Тикшерү үтү билгесен резервламый. Үтү билгесен куллану өчен интернетка тоташу кирәк. Түләү процессинг, шәхес тикшерү яки кабат кулланыла торган озак вакытлы әгъзалык картасы юк. Гадәти QR кыйммәтен уку үтү билгесен тикшерүдән аерыла.

Көйләүләр, гамәлләр һәм нәтиҗәләр

Бу исемнәрне Bubble эчендә кулланыгыз. Планлаштырылган функцияләр аерым билгеләнгән.

Кулланыла торган бета көйләүләре

Элемент көйләүләре

disabled · yes/nois_active · yes/noui_text_json · textlanguage · text

Хәлләр

scanner_status · textserver_status · textpass_id · textpass_label · textreceipt_id · texterror_code · textis_busy · yes/nois_scanning · yes/notorch_enabled · yes/noscan_source · textpending_redemption · yes/no

Вакыйгалар

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Гамәлләр һәм аларның кертемнәре

Clear session

Элемент көйләүләре · 5

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

disabledyes/no · Стандарт: false: Мисал кыйммәтеno; Мисал Bubble ифадәсеGuideHost's is_busy (your yes/no custom state); Кушымтагыз мәшгуль булганда яки бу гамәл кулланылмый торганда элементны сүндерегез.

is_activeyes/no · Стандарт: true: Мисал кыйммәтеyes; Мисал Bubble ифадәсеGuideHost's view_is_active (your yes/no custom state); Бу күренеш ачык булганда yes куегыз. Чыкканда no куегыз, шулай итеп уйнату яки хәзерге эш туктый ала.

ui_text_jsontext · Стандарт: "{}": Мисал кыйммәте{}; Мисал Bubble ифадәсеApp Settings' player_labels_json (supported keys only); Ярдәм ителгән төймә язмалары булган ихтыяри JSON. Эчке текстны куллану өчен буш калдырыгыз.

languagetext · Стандарт: "auto": Мисал кыйммәтеuk; Мисал Bubble ифадәсеCurrent User's preferred_language; language=auto җайланма яки браузер теленә ярдәм булганда шул телне куллана. Телне ачык сайлау өчен ярдәм ителгән тел кодын кертегез.

workflow_modeyes/no · Стандарт: false: Мисал кыйммәтеyes; Мисал Bubble ифадәсеApp Settings' use_qr_business_actions; Планлаштырылган: сканланган QR кыйммәтен Check QR pass куллана ала. Сканлау гына кертүне яки алуны расламый.

Гамәлләр һәм аларның кертемнәре · 5

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

Clear session

Эш параметрлары юк

Issue QR pass

environmenttext · Стандарт: "development": Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

request_idtext · Стандарт: —: Мисал кыйммәтеpickup-123-issue-v1; Мисал Bubble ифадәсеCurrent Admission's stable_request_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

labeltext · Стандарт: "access": Мисал кыйммәтеevent; Мисал Bubble ифадәсеSelected Admission's pass_label; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

ttl_secondsnumber · Стандарт: 900: Мисал кыйммәте900; Мисал Bubble ифадәсеEvent Settings' pass_ttl_seconds; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Кайтарыла торган кыйммәтләр

pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/no

Check QR pass

environmenttext · Стандарт: "development": Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

pass_tokentext · Стандарт: —: Мисал кыйммәте<opaque token returned by Issue / camera scan>; Мисал Bubble ифадәсеQR Pass Scanner's scanned_pass_token (capture before Check); Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Кайтарыла торган кыйммәтләр

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Стандарт: "development": Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

pass_tokentext · Стандарт: —: Мисал кыйммәте<opaque token returned by Issue / camera scan>; Мисал Bubble ифадәсеQR Pass Scanner's scanned_pass_token (capture before Check); Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

request_idtext · Стандарт: —: Мисал кыйммәтеpickup-123-redeem-v1; Мисал Bubble ифадәсеCurrent Admission's stable_redemption_request_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

confirmyes/no · Стандарт: false: Мисал кыйммәтеyes — explicit confirmation only; Мисал Bubble ифадәсеConfirm Checkbox is checked; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Кайтарыла торган кыйммәтләр

pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/no

Revoke QR pass

environmenttext · Стандарт: "development": Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

pass_idtext · Стандарт: —: Мисал кыйммәте<pass_id returned by Issue>; Мисал Bubble ифадәсеSelected Admission's pass_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Кайтарыла торган кыйммәтләр

pass_id · textrevoked · yes/no

Хәлләр һәм вакыйгалар

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

Хәлләр

scanner_status · text

Бу гамәлнең хәзерге нәтиҗәсе. Уңышлы саклау алдыннан туры килгән тәмамлану вакыйгасын кулланыгыз. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Бу гамәлнең хәзерге нәтиҗәсе. Уңышлы саклау алдыннан туры килгән тәмамлану вакыйгасын кулланыгыз. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Бу элемент яки гамәл өчен идентификатор. Аны туры килгән кушымта язмасында саклагыз. Билгесез нәтиҗәне кабатлау вакытында шул ук сорау идентификаторын кулланыгыз.

pass_label · text

Сайланган элемент өчен хәзерге кыйммәт. Аны бәйле вакыйгадан соң укыгыз. empty,access,event,coupon,membership

receipt_id · text

error_code · text

Соңгы гамәл өчен хата мәгълүматы. Ярдәмче хәбәрне күрсәтегез һәм тиешле кабатлау мөмкинлеген тәкъдим итегез.

is_busy · yes/no

Эш әле дә бара. Яңа гамәлне башлар алдыннан көтегез.

is_scanning · yes/no

Сайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.

torch_enabled · yes/no

Сайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.

scan_source · text

Сайланган элементның хәзерге кыйммәте. Аны бәйле вакыйгадан соң укыгыз. empty,camera,fixture

pending_redemption · yes/no

Сайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.

scanned_pass_token · text

Сайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.