Rozhranie skenera QR. Akcie jednorazového prechodu sú plánované.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Vytvorte jednorazové vstupenky, potvrdenia o vyzdvihnutí alebo kupóny. Personál naskenuje kód, skontroluje výsledok, zobrazí náhľad objednávky a potvrdí použitie až keď je pripravený.

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.

Vytvorte pracovný postup ↓Nastavenia pluginu ↗Native Lab

Dokumentácia skontrolovaná 6 november 2026

Praktické príklady

Jednorazové vstupné pre podujatie v ten istý deň

Snímka obrazovky bežnej hodnoty QR môže byť inak znovu použitá na viac ako jednom vstupe.

Vaša aplikácia ukladá záznam o vstupnom a stabilný vydaný `request_id`; použite upravený `label=event` a `ttl_seconds` v rámci kontraktu 1–86400 sekúnd.

Oprávnený vydavateľ spustí Issue QR pass a súkromne doručí vrátený QR. Personál skenuje → Check QR pass → potvrdí iba ak `ok=yes` a `status=available` → Confirm QR redemption s uloženým stabilným ID požiadavky.

Iba `status=redeemed` plus `receipt_id` autorizujú potvrdenku vstupu vašej aplikácie. Uložte odkaz na preukaz/potvrdenku v zázname vstupu; neodhaľujte obsah QR analytike.

Pre `outcome_unknown` obnovte rovnakú požiadavku s identickým používateľom/prostredím/preukazom; nikdy nevytvárajte nové ID potvrdenia. Spracujte expired, revoked a už použité stavy ako odlišné výsledky.

Plánované. Skenovanie a kontrola preukaz nespotrebujú; spotrebuje ho až výslovné potvrdenie.

Uplatnite krátkodobý benefit raz na pultu partnera

Partner potrebuje potvrdený výsledok použitého/nepoužitého namiesto dôvery v obrázok QR alebo animáciu na obrazovke.

`label=coupon`; záznam Benefit v aplikácii určuje spôsobilosť a krátke časové okno platnosti pred autorizovanou akciou vydania.

Vydajte preukaz až po kontrole oprávnenosti vašej aplikácie. Na pultu Check QR pass zobrazuje dostupnosť bez jej spotrebovania. Po tom, čo zamestnanec potvrdí doručenie benefitu, spustite Confirm QR redemption.

Váš záznam o benefite môže ukladať `receipt_id` a potvrdený čas uplatnenia po `status=redeemed`. Plugin spravuje stav preukazu; vaša aplikácia spravuje benefit a vzťah so zákazníkom.

Ak je benefit zrušený pred použitím, rovnaký oprávnený vydavateľ môže Revoke QR pass pomocou svojho `pass_id`. Neoznamujte vrátenie peňazí ani úspešné uplatnenie len na základe `ok=yes`.

Plánované. Skenovanie a kontrola preukaz nespotrebujú; spotrebuje ho až výslovné potvrdenie.

Potvrďte prevzatie vybavenia alebo objednávky v ten istý deň

Pracovný postup zamestnancov musí rozlišovať skenovanie referencie prevzatia od skutočného odovzdania položky.

Záznam vlastnej kolekcie vašej aplikácie uchováva autorizáciu, zamýšľanú položku a samostatné stabilné ID požiadaviek na vydanie/vyzdvihnutie; použite krátkodobý `label=access` preukaz.

Po tom, čo vaša aplikácia povolí prevzatie, Issue QR pass. Personál naskenuje a skontroluje, prehliadne zodpovedajúcu kolekciu vo vašej aplikácii a potom výslovne potvrdí odovzdanie a Confirm QR redemption.

Iba po potvrdenom `redeemed` potvrdení by mal váš pracovný postup nastaviť kolekciu na odovzdanú. Zachovajte `receipt_id` ako odkaz na výsledok preukazu.

Opakované skenovanie môže vrátiť already_used; zobrazte existujúci záznam aplikácie namiesto odovzdania ďalšej položky. Obnovte neisté potvrdenie s rovnakým ID a vstupmi.

Plánované. Skenovanie a kontrola preukaz nespotrebujú; spotrebuje ho až výslovné potvrdenie.

Čo funguje teraz

Súkromná beta. Aktuálny skener má ovládanie kamery a oprávnení. Vytváranie, kontrola a potvrdenie jednorazových preukazov je plánované a zatiaľ nie je pripravené na použitie vo vašej aplikácii.

Vytvorte pracovný postup

Plánované

Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.

Tieto príklady používajú záznamy aplikácie, ako sú Lesson, Message a Order. Nahraďte ich vlastnými typmi údajov a názvami prvkov. Príkladové mediálne adresy musia byť nahradené vašimi vlastnými súbormi.

Plánované: oprávnený zamestnanec použije Issue QR pass pre vstup alebo Order. Príklad: label=event, ttl_seconds=900, environment=development. Uchovajte stabilný request_id pre toto vydanie preukazu a uložte pass_id so záznamom.
Zobrazte vrátený QR jeho zamýšľanému držiteľovi. Zamestnanci ho naskenujú. V pracovnom postupe plánovaného preukazu použite workflow_mode=yes a prečítajte scanned_pass_token po pass_scanned. Tieto nastavenia pracovného postupu preukazu nie sú dostupné v aktuálnom skeneri.
Spustite Check QR pass s pass_token = QR Scanner's scanned_pass_token. Kontroluje bez použitia preukazu. Pre status=available zobrazte zodpovedajúce podrobnosti objednávky alebo vstupu, aby ich zamestnanci mohli skontrolovať.
Iba samostatné tlačidlo Potvrdiť spustí Confirm QR redemption s rovnakým pass_token, stabilným request_id a confirm=yes. Na status=redeemed uložte receipt_id a označte túto objednávku alebo vstup ako dokončený.
already_used, expired, revoked alebo invalid znamená neumožniť vstup ani odovzdať objednávku. Sken alebo úspešná kontrola samostatne nikdy transakciu nedokončia.

Diagram pracovného postupu — nie je to snímka aplikácie

Nastavte raz

Vytvorte alebo vyberte svoj Bubble projekt v BestPlugins → Dashboard → Plugins. Vyberte Xodera QR Passes Native, skopírujte jeho kľúč a potom otvorte Bubble → Plugins → Xodera QR Passes Native a vložte ho do project_api_key. Uložte raz; potom použite akcie nižšie. Každý plugin v každom projekte má svoj vlastný kľúč.

Skenovanie vyžaduje povolenie kamery. Pre jednorazové preukazy určite, kto môže vytvárať preukazy a kto ich môže kontrolovať pri vchode alebo mieste odberu. Bežní zákazníci nepotrebujú žiadnu rolu zamestnanca.

`qr_issuer_permission_field`

qr_pass_issuer · Názov používateľského áno/nie poľa, ktoré označuje zamestnancov oprávnených vytvárať alebo rušiť preukazy. Príklad/štandard: qr_pass_issuer. Sem zadajte názov poľa, nie áno alebo nie. Použitie tejto povolenia by mal meniť iba oprávnený administrátor.

`qr_staff_permission_field`

qr_staff · Názov používateľského áno/nie poľa, ktoré označuje zamestnancov oprávnených kontrolovať a potvrdiť použitie. Príklad/štandard: qr_staff. Držiteľ vstupenky túto povolenie nepotrebuje. Nezahrňujte ho do verejných registračných a profilových formulárov.

Nastavte raz

Vytvorte alebo vyberte svoj Bubble projekt na BestPlugins → Dashboard → Plugins.
Vyberte tento plugin a skopírujte jeho projektový kľúč.
Otvorte Bubble → Plugins → Xodera QR Passes Native; vložte kľúč do project_api_key a uložte.
Pridajte element, vyberte svoje údaje aplikácie a zostavte pracovný postup nižšie.
Privátny beta prístup len zatiaľ. Verejná inštalácia a platená aktivácia nie sú ešte otvorené.

Inštalácia a predplatné

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ýsledok do svojej aplikácie

Príklad vstupu alebo odberu: uložte súvisiacu objednávku/udalosti, pass_id, expires_at a issue_request_id. Po potvrdenom použití pridajte receipt_id, redeemed_at a zamestnanca, ktorý potvrdil. Neoznačujte záznam ako dokončený, keď je kód iba naskenovaný alebo skontrolovaný. Kód QR neoveruje identitu osoby.

Zlyhanie, zrušenie a obnovenie

Ak outcome_unknown=yes, zachovajte rovnaký preukaz, request_id a vstupy pri opätovnej kontrole výsledku. Nevytvárajte nové potvrdenie. already_used, expired a revoked sú konečné obchodné výsledky. Ak je povolenie odmietnuté, požiadajte oprávneného administrátora, aby prešiel rolu zamestnanca. Clear session resetuje skener; nedokáže vrátiť dokončené použitie.

Možnosti a limity

Plánované preukazy sú jednorazové s životnosťou 1–86400 sekúnd; predvolená hodnota 900. Typy preukazov: access, event, coupon a membership. Kontrola nevyhradzuje preukaz. Pre použitie preukazu je potrebný prístup na internet. Nie je žiadne spracovanie platieb, kontrola identity ani opakovane použiteľná dlhodobá členská karta. Čítanie bežnej hodnoty QR je oddelené od kontroly preukazu.

Nastavenia, akcie a výsledky

Použite tieto názvy v Bubble. Plánované funkcie sú označené samostatne.

Dostupné beta nastavenia

Nastavenia 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

Udalosti

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Akcie a ich vstupy

Clear session

Nastavenia prvku · 5

Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.

disabledyes/no · Predvolené: false: Ukážková hodnotano; Príklad Bubble výrazGuideHost's is_busy (your yes/no custom state); Zakážte prvok, keď je vaša aplikácia zaneprázdnená alebo je táto akcia nedostupná.

is_activeyes/no · Predvolené: true: Ukážková hodnotayes; Príklad Bubble výrazGuideHost's view_is_active (your yes/no custom state); Nastavte áno, kým je tento pohľad otvorený. Nastavte nie pri odchode, aby sa prehrávanie alebo aktuálna práca mohla zastaviť.

ui_text_jsontext · Predvolené: "{}": Ukážková hodnota{}; Príklad Bubble výrazApp Settings' player_labels_json (supported keys only); Voliteľný JSON s podporovanými popiskami tlačidiel. Ponechajte prázdne pre použitie vstavaného textu.

languagetext · Predvolené: "auto": Ukážková hodnotauk; Príklad Bubble výrazCurrent User's preferred_language; Nastavte language=auto, aby sledoval podporované zariadenie alebo jazyk prehliadača. Zadajte podporovaný kód jazyka pre jeho explicitný výber.

workflow_modeyes/no · Predvolené: false: Ukážková hodnotayes; Príklad Bubble výrazApp Settings' use_qr_business_actions; Plánované: umožniť použitie naskenovanej hodnoty QR v Check QR pass. Samotné skenovanie nepotvrdzuje vstup ani vyzdvihnutie.

Akcie a ich vstupy · 5

Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.

Clear session

Žiadne parametre akcie

Issue QR pass

environmenttext · Predvolené: "development": Ukážková hodnotadevelopment; Príklad Bubble výrazApp Settings' selected_environment; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

request_idtext · Predvolené: —: Ukážková hodnotapickup-123-issue-v1; Príklad Bubble výrazCurrent Admission's stable_request_id; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

labeltext · Predvolené: "access": Ukážková hodnotaevent; Príklad Bubble výrazSelected Admission's pass_label; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

ttl_secondsnumber · Predvolené: 900: Ukážková hodnota900; Príklad Bubble výrazEvent Settings' pass_ttl_seconds; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

Návraty

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

Check QR pass

environmenttext · Predvolené: "development": Ukážková hodnotadevelopment; Príklad Bubble výrazApp Settings' selected_environment; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

pass_tokentext · Predvolené: —: Ukážková hodnota<opaque token returned by Issue / camera scan>; Príklad Bubble výrazQR Pass Scanner's scanned_pass_token (capture before Check); Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

Návraty

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Predvolené: "development": Ukážková hodnotadevelopment; Príklad Bubble výrazApp Settings' selected_environment; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

pass_tokentext · Predvolené: —: Ukážková hodnota<opaque token returned by Issue / camera scan>; Príklad Bubble výrazQR Pass Scanner's scanned_pass_token (capture before Check); Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

request_idtext · Predvolené: —: Ukážková hodnotapickup-123-redeem-v1; Príklad Bubble výrazCurrent Admission's stable_redemption_request_id; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

confirmyes/no · Predvolené: false: Ukážková hodnotayes — explicit confirmation only; Príklad Bubble výrazConfirm Checkbox is checked; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

Návraty

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

Revoke QR pass

environmenttext · Predvolené: "development": Ukážková hodnotadevelopment; Príklad Bubble výrazApp Settings' selected_environment; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

pass_idtext · Predvolené: —: Ukážková hodnota<pass_id returned by Issue>; Príklad Bubble výrazSelected Admission's pass_id; Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.

Návraty

pass_id · textrevoked · yes/no

Stavy a udalosti

Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.

Stavy

scanner_status · text

Aktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Aktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifikátor pre túto položku alebo akciu. Uchovajte ho s príslušným záznamom aplikácie. Použite rovnaký identifikátor požiadavky pri opakovaní neistého výsledku.

pass_label · text

Aktuálna hodnota vybranej položky. Prečítajte ju po súvislej udalosti. empty,access,event,coupon,membership

receipt_id · text

Identifikátor pre túto položku alebo akciu. Uchovajte ho s príslušným záznamom aplikácie. Použite rovnaký identifikátor požiadavky pri opakovaní neistého výsledku.

error_code · text

Informácie o chybe poslednej akcie. Zobrazte užitočnú správu a ponúknite príslušný opätovný pokus.

is_busy · yes/no

Práca stále prebieha. Počkajte pred spustením ďalšej akcie.

is_scanning · yes/no

Aktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.

torch_enabled · yes/no

Aktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.

scan_source · text

Aktuálna hodnota vybranej položky. Prečítajte ju po súvislej udalosti. empty,camera,fixture

pending_redemption · yes/no

Aktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.

scanned_pass_token · text

Aktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.