QR skener rozhraní. Jednorázové akce průchodu jsou plánovány.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Vytvářejte jednorázové vstupenky, potvrzení vyzvednutí nebo kupóny. Personál naskenuje kód, zkontroluje výsledek, zobrazí náhled objednávky a potvrdí použití až když je připraven.

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.

Vytvořte pracovní postup ↓Nastavení pluginu ↗Native Lab

Dokumentace přezkoumána 6 listopad 2026

Praktické příklady

Jednorázový vstup pro událost ve stejný den

Snímek běžné hodnoty QR může být jinak znovu použit na více než jednom vstupu.

Vaše aplikace ukládá záznam vstupu a stabilní vydání `request_id`; použijte upravený `label=event` a `ttl_seconds` v rámci kontraktu 1–86400 sekund.

Autorizovaný vydavatel spustí Issue QR pass a soukromě doručí vrácený QR. Zaměstnanci naskenují → Check QR pass → potvrdí pouze pokud `ok=yes` a `status=available` → Confirm QR redemption se uloženým stabilním ID požadavku.

Pouze `status=redeemed` plus `receipt_id` autorizuje vstupní potvrzení vaší aplikace. Uložte odkaz na průkaz/potvrzení do záznamu Admission; neukazujte obsah QR analytice.

Pro `outcome_unknown` obnovte stejný požadavek se shodným uživatelem/prostředím/průkazem; nikdy nevytvářejte nové ID potvrzení. Zpracovávejte expired, revoked a stavy již použito jako odlišné výsledky.

Plánováno. Skenování a kontrola nepoužívají průkaz; pouze explicitní potvrzení jej využije.

Uplatněte krátkodobý benefit jednorázově u partnera na přepážce

Partner potřebuje potvrzený výsledek použití/nepoužití místo spoléhaní se na obrázek QR nebo animaci na obrazovce.

`label=coupon`; záznam Benefit v aplikaci určuje oprávněnost a krátké časové okno platnosti před autorizovanou akcí vydání.

Vydávejte průkaz až po kontrole oprávněnosti vaší aplikace. Na přepážce Check QR pass zobrazuje dostupnost bez spotřeby. Po potvrzení doručení benefitu zaměstnancem spusťte Confirm QR redemption.

Váš záznam Benefit může ukládat `receipt_id` a potvrzený čas uplatnění po `status=redeemed`. Plugin spravuje stav průkazu; vaše aplikace spravuje benefit a vztah se zákazníkem.

Pokud je benefit zrušen před použitím, stejný autorizovaný vydavatel může Revoke QR pass pomocí svého `pass_id`. Neoznamujte refundaci ani úspěšné uplatnění pouze na základě `ok=yes`.

Plánováno. Skenování a kontrola nepoužívají průkaz; pouze explicitní potvrzení jej využije.

Potvrďte vyzvednutí vybavení nebo objednávky ve stejný den

Pracovní postup zaměstnance musí rozlišovat skenování odkazu na sbírku od skutečného předání položky.

Vlastní záznam Collection ve vaší aplikaci uchovává autorizaci, zamýšlenou položku a samostatná stabilní ID požadavků na vydání/uplatnění; použijte krátkodobý průkaz `label=access`.

Po autorizaci sbírky vaší aplikací Issue QR pass. Zaměstnanci naskenují a zkontrolují, prověří odpovídající Collection ve vaší aplikaci a poté explicitně potvrdí předání a Confirm QR redemption.

Teprve po potvrzeném příjmu `redeemed` by měl váš pracovní postup nastavit Collection jako předané. Uchovejte `receipt_id` jako odkaz na výsledek průkazu.

Opakované skenování může vrátit already_used; zobrazte existující záznam aplikace místo předání další položky. Obnovte nejisté potvrzení se stejným ID a vstupy.

Plánováno. Skenování a kontrola nepoužívají průkaz; pouze explicitní potvrzení jej využije.

Co funguje nyní

Soukromá beta. Aktuální skener má ovládání kamery a oprávnění. Vytváření, kontrola a potvrzení jednorázových průchodů je plánováno a zatím není připraveno k použití ve vaší aplikaci.

Vytvořte pracovní postup

Plánováno

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

Tyto příklady používají záznamy aplikace, jako jsou Lesson, Message a Order. Nahraďte je vlastními typy dat a názvy prvků. Příkladové adresy médií je třeba nahradit vlastními soubory.

Plánováno: oprávněný zaměstnanec použije Issue QR pass pro vstup nebo Order. Příklad: label=event, ttl_seconds=900, environment=development. Uchovejte stabilní request_id pro tuto vydanou položku a uložte pass_id se záznamem.
Zobrazte vrácený QR jeho zamýšlenému držiteli. Zaměstnanci jej naskenují. V pracovním postupu plánovaného průkazu použijte workflow_mode=yes a přečtěte scanned_pass_token po pass_scanned. Tato nastavení pracovního postupu průkazu nejsou v současném skeneru k dispozici.
Spusťte Check QR pass s pass_token = QR Scanner's scanned_pass_token. Kontroluje se bez použití průkazu. Pro status=available zobrazte odpovídající objednávku nebo podrobnosti vstupu, aby si je zaměstnanec mohl prohlédnout.
Pouze samostatné tlačítko Potvrdit spustí Confirm QR redemption se stejným pass_token, stabilním request_id a confirm=yes. Na status=redeemed uložte receipt_id a označte objednávku nebo vstup jako dokončený.
already_used, expired, revoked nebo invalid znamenají nepřijmout ani nepředat objednávku. Pouhý sken nebo úspěšná kontrola nikdy transakci nedokončí.

Diagram pracovního postupu — ne snímek obrazovky aplikace

Nastavte jednou

Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera QR Passes Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera QR Passes Native a vložte jej do project_api_key. Uložte jednou; poté použijte akce níže. Každý plugin v každém projektu má svůj vlastní klíč.

Skenování vyžaduje oprávnění k fotoaparátu. Pro jednorázové průkazy rozhodněte, kdo může průkazy vytvářet a kdo je může kontrolovat u dveří nebo výdejního místa. Běžní zákazníci nepotřebují žádnou roli zaměstnance.

`qr_issuer_permission_field`

qr_pass_issuer · Název pole uživatele ano/ne, které označuje zaměstnance oprávněné vytvářet nebo rušit průkazy. Příklad/výchozí: qr_pass_issuer. Zadejte zde název pole, ne hodnotu ano či ne. Pouze oprávněný administrátor by měl tuto oprávnění u uživatele měnit.

`qr_staff_permission_field`

qr_staff · Název pole uživatele ano/ne, které označuje personál oprávněný kontrolovat a potvrzovat použití. Příklad/výchozí: qr_staff. Držitel vstupenky tuto oprávnění nepotřebuje. Nezahrnujte jej do veřejných registračních a profilových formulářů.

Nastavte jednou

Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
Vyberte tento plugin a zkopírujte jeho projektový klíč.
Otevřete Bubble → Plugins → Xodera QR Passes Native; vložte klíč do project_api_key a uložte.
Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
Soukromý beta přístup pouze zatím. Veřejná instalace a placená aktivace ještě nejsou otevřeny.

Instalace a předplatné

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.

Uložte výsledek ve své aplikaci

Příklad vstupu nebo výdeje: uložte související objednávku/událost, pass_id, expires_at a issue_request_id. Po potvrzeném použití přidejte receipt_id, redeemed_at a zaměstnance, který potvrdil. Neoznačujte záznam jako dokončený, pokud je kód pouze naskenován nebo zkontrolován. Kód QR neověřuje totožnost osoby.

Selhání, zrušení a obnovení

Pokud outcome_unknown=yes, zachovejte stejný průkaz, request_id a vstupy při opětovné kontrole výsledku. Nevytvářejte nové potvrzení. already_used, expired a revoked jsou konečné obchodní výsledky. Pokud je oprávnění odmítnuto, požádejte oprávněného administrátora o revizi role zaměstnance. Clear session resetuje skener; nemůže vrátit dokončené použití.

Možnosti a limity

Plánované průkazy jsou jednorázové s životností 1–86400 sekund; výchozí 900. Typy průkazů: access, event, coupon a membership. Kontrola nevyhrazuje průkaz. Pro použití průkazu je vyžadován přístup k internetu. Žádné zpracování plateb, kontrola identity ani opakovaně použitelná dlouhodobá členská karta. Čtení běžné hodnoty QR je oddělené od kontroly průkazu.

Nastavení, akce a výsledky

Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.

Dostupná beta nastavení

Nastavení prvku

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

Stavy

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

Události

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Akce a jejich vstupy

Clear session

Nastavení prvku · 5

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

disabledyes/no · Výchozí: false: Ukázková hodnotano; Příklad Bubble výrazuGuideHost's is_busy (your yes/no custom state); Deaktivujte prvek, když je aplikace zaneprázdněná nebo je tato akce nedostupná.

is_activeyes/no · Výchozí: true: Ukázková hodnotayes; Příklad Bubble výrazuGuideHost's view_is_active (your yes/no custom state); Nastavte ano, dokud je tento pohled otevřený. Nastavte ne při odchodu, aby se přehrávání nebo aktuální práce mohly zastavit.

ui_text_jsontext · Výchozí: "{}": Ukázková hodnota{}; Příklad Bubble výrazuApp Settings' player_labels_json (supported keys only); Volitelný JSON s podporovanými popisky tlačítek. Nechte prázdné pro použití vestavěného textu.

languagetext · Výchozí: "auto": Ukázková hodnotauk; Příklad Bubble výrazuCurrent User's preferred_language; Nastavte language=auto tak, aby sledoval podporované zařízení nebo jazyk prohlížeče. Zadejte podporovaný kód jazyka pro jeho explicitní výběr.

workflow_modeyes/no · Výchozí: false: Ukázková hodnotayes; Příklad Bubble výrazuApp Settings' use_qr_business_actions; Plánováno: umožnit použití naskenované hodnoty QR v Check QR pass. Pouhé skenování nepotvrzuje vstup ani vyzvednutí.

Akce a jejich vstupy · 5

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

Clear session

Žádné parametry akce

Issue QR pass

environmenttext · Výchozí: "development": Ukázková hodnotadevelopment; Příklad Bubble výrazuApp Settings' selected_environment; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

request_idtext · Výchozí: —: Ukázková hodnotapickup-123-issue-v1; Příklad Bubble výrazuCurrent Admission's stable_request_id; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

labeltext · Výchozí: "access": Ukázková hodnotaevent; Příklad Bubble výrazuSelected Admission's pass_label; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

ttl_secondsnumber · Výchozí: 900: Ukázková hodnota900; Příklad Bubble výrazuEvent Settings' pass_ttl_seconds; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

Vrácení

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

Check QR pass

environmenttext · Výchozí: "development": Ukázková hodnotadevelopment; Příklad Bubble výrazuApp Settings' selected_environment; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

pass_tokentext · Výchozí: —: Ukázková hodnota<opaque token returned by Issue / camera scan>; Příklad Bubble výrazuQR Pass Scanner's scanned_pass_token (capture before Check); Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

Vrácení

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Výchozí: "development": Ukázková hodnotadevelopment; Příklad Bubble výrazuApp Settings' selected_environment; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

pass_tokentext · Výchozí: —: Ukázková hodnota<opaque token returned by Issue / camera scan>; Příklad Bubble výrazuQR Pass Scanner's scanned_pass_token (capture before Check); Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

request_idtext · Výchozí: —: Ukázková hodnotapickup-123-redeem-v1; Příklad Bubble výrazuCurrent Admission's stable_redemption_request_id; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

confirmyes/no · Výchozí: false: Ukázková hodnotayes — explicit confirmation only; Příklad Bubble výrazuConfirm Checkbox is checked; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

Vrácení

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

Revoke QR pass

environmenttext · Výchozí: "development": Ukázková hodnotadevelopment; Příklad Bubble výrazuApp Settings' selected_environment; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

pass_idtext · Výchozí: —: Ukázková hodnota<pass_id returned by Issue>; Příklad Bubble výrazuSelected Admission's pass_id; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

Vrácení

pass_id · textrevoked · yes/no

Stavy a události

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

Stavy

scanner_status · text

Aktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Aktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifikátor pro tuto položku nebo akci. Uchovejte jej u odpovídajícího záznamu aplikace. Použijte stejný identifikátor požadavku při opakování nejistého výsledku.

pass_label · text

Aktuální hodnota vybrané položky. Přečtěte ji po související události. empty,access,event,coupon,membership

receipt_id · text

Identifikátor pro tuto položku nebo akci. Uchovejte jej u odpovídajícího záznamu aplikace. Použijte stejný identifikátor požadavku při opakování nejistého výsledku.

error_code · text

Informace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.

is_busy · yes/no

Práce stále probíhá. Počkejte, než spustíte další akci.

is_scanning · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

torch_enabled · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

scan_source · text

Aktuální hodnota vybrané položky. Přečtěte ji po související události. empty,camera,fixture

pending_redemption · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

scanned_pass_token · text

Aktuální hodnota vybrané položky. Přečtěte ji po související události.