Interface da scanner QR. Accziuns da pass da dovrar ina giada èn planisadas.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Creescha bigliets per ina sola utilisaziun, confermas da retratga u cupons. Il persunal scannescha il code, controlla il resultat, guarda la cumanda e conferma l'utilisaziun mo cura che tut è pront.

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.

Crear il flus da lavur ↓Configuraziun dal plugin ↗Native Lab

Documentaziun controllada ils 6 da november 2026

Exemplars pratics

Admitsiun per in us unic per in eveniment dal medem di

Ina captura da scherm d'ina valur QR ordinarja po altrimai vegnir reutilisada en pli che in'entrata.

L'app tia memorisescha in registr da Admission e in emittament stabil `request_id`; duvrar `label=event` curadi e in `ttl_seconds` entaifer il contract da 1–86400 secund.

In emissur autorisà exequa Issue QR pass e transmet privatamain il QR returnà. Il persunal scannescha → Check QR pass → conferma mo sch `ok=yes` e `status=available` → Confirm QR redemption cun in ID da dumonda stabil memorisà.

Mo `status=redeemed` ensemen cun `receipt_id` autorisescha la conferma d'entrada da tia app. Memorisescha la referenza dal pass e da la conferma en l'Admission; na trametta betg il cuntegn dal QR a l'analitica.

Per `outcome_unknown`, recupere la medema dumonda cun il medem utilisader/ambient/pass; na genere mai in nov ID da conferma. Tratta ils stadi expired, revoked e already‑utilisà sco resultats separads.

Planà. Scannar e controllar na duvran betg il pass; mo la conferma explicita fa quai.

Dovra in avantatg da curta durada ina giada al spurtegl d'in partenari

In partnèr ha basegn d'in resultat confermà dovrà/nondovrà enstagl da fidar ad ina maletg QR u ina animaziun da scherm.

`label=coupon`; l'endataziun Benefit da tia app definescha il dretg a l'avantatg ed ina curta perioda da validitad avant in'acziun d'emissiun autorisada.

Emetta in pass sulet suenter il controll d'eligibilità da tia app. Al compt, Check QR pass mussa la disponibilità senza consumar. Suenter che il persunal confermescha la consegna da l'avantatg, exequa Confirm QR redemption.

L'endataziun Benefit po memorisar `receipt_id` ed il mument da l'utilisaziun confermada suenter `status=redeemed`. Il plugin administrescha il stadi dal pass; tia app administrescha l'avantatg e la relaziun cun il client.

Sche in avantatg è annullà avant l'utilisaziun, il medem emissur autorisà po Revoke QR pass cun si `pass_id`. Na publitgescha betg in remburs u in riscatt reussì cun `ok=yes` sulett.

Planà. Scannar e controllar na duvran betg il pass; mo la conferma explicita fa quai.

Confirma la prelevaziun da l'equipament u la comanda per il medem di.

Il flus da lavur dal persunal sto distinguer tranter scannar ina referenza da retratga e consegnar effectivamain in artitgel.

L'endataziun Collection che tutga a tia app conserva l'autorisaziun, l'artitgel previs ed IDs da dumonda stabels e separads per l'emissiun e l'utilisaziun; dovra in pass `label=access` da curta durada.

Suenter che tia app ha autorisà la retratga, exequescha Issue QR pass. Il persunal scannescha e dovra Check, controlla l'endataziun Collection correspundenta en tia app e conferma lura explicitamain la consegna cun Confirm QR redemption.

Mo suenter ina conferma d'utilisaziun `redeemed` duai tes flus da lavur marcar il Collection sco consegnà. Conserva `receipt_id` sco colliaziun cun il resultat dal pass.

In scannar repetì po returnar already_used; mussa il registr existent da l’app enstagl da consegnar in auter artitgel. Recupere ina conferma incerta cun il medem ID e inputs.

Planà. Scannar e controllar na duvran betg il pass; mo la conferma explicita fa quai.

Tge che funcziuna ussa

Beta privata. Il scanner actual ha controllas per la camera e permissiuns. La creaziun, la controlla e la conferma da pass da utilisaziun unica è planificada e n’è anc betg pronta per l’utilisar en tia app.

Crear il flus da lavur

Previst

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Quests exempels dovran endataziuns da l'app sco Lesson, Message ed Order. Remplazza quellas cun tes agens tips da datas e nums d'elements. Remplazza las adressas da medias d'exempel cun tias atgnas datotecas.

Planisà: in emploià autorisà dovra Issue QR pass per in Admission u Order. Exempel: label=event, ttl_seconds=900, environment=development. Conserva in request_id stabil per questa emissiun e memorisescha pass_id cun l'endataziun.
Mostra il QR returnà al detentur previst. Il persunal il scana. En il flux da lavur da pass planà, utilisescha workflow_mode=yes e legia scanned_pass_token suenter pass_scanned. Questas configuraziuns dal flux da pass na èn betg disponiblas en il scanner actual.
Executa Check QR pass cun pass_token = QR Scanner's scanned_pass_token. El controlla senza utilisar il pass. Per status=available, mussa ils detagls da la cumanda u l'entrata correspundenta per che il persunal laschia revisar.
Mo in buttun Separà Confirm exequa Confirm QR redemption cun il medem pass_token, in request_id stabil e confirm=yes. Sin status=redeemed, memorisescha receipt_id e marca quella cumanda u entrata sco cumpletta.
already_used, expired, revoked u invalid signifitgeschan da na admitir ni da transmetter la cumanda. In scann u in controll reussì da persavon na cumpletescha mai la transacziun.

Diagramma dal flus da lavur — betg ina captura d’app

Configurar ina giada

Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins. Tscherna Xodera QR Passes Native, copia sia clav, suenter avra Bubble → Plugins → Xodera QR Passes Native e incolla ella en project_api_key. Salva ina giada; suenter utilisescha las acziuns sutvart. Mintga plugin en mintga project ha sia propria clav.

Scannar pretenda permess per la camera. Per pass da dovrar unic, decida tgi po crear pass e tgi po controllar els tar la porta u il punct da prelevament. Clients ordinaris na dovran nagin roll da persunal.

`qr_issuer_permission_field`

qr_pass_issuer · Num dal champ User da tip yes/no che marca ils emploiads autorisads da crear u revocar pass. Exempel/standard: qr_pass_issuer. Endatescha qua il num dal champ, betg yes u no. Mo in administratur autorisà duai midar questa permissiun d'in utilisader.

`qr_staff_permission_field`

qr_staff · Num dal champ User da tip yes/no che marca il persunal autorisà da controllar e confermar l'utilisaziun. Exempel/standard: qr_staff. In possessur da bigliet na dovra betg questa permissiun. Na metta betg quest champ en formulars publics d'inscripziun u da profil.

Configurar ina giada

Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins.
Tscherna quest plugin e copia sia clav dal project.
Avra Bubble → Plugins → Xodera QR Passes Native; incolla la clav en project_api_key e salva.
Agiunta l'element, tscherna tias datas d'app e construescha il flus da lavur sutvart.
Accès beta privat per ussa mo. Installaziun publica e activaziun cun pajament n'èn anc betg avertas.

Installaziun e abonnament

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.

Memorisar il resultat en tia app

Exempel d'admisiun u prelevament: memorisescha l'ordin/avveniment relatà, pass_id, expires_at e issue_request_id. Suenter l'utilisaziun confermada, agiunta receipt_id, redeemed_at e l'emplegià che ha confermà. Na marcà betg il registr cumplet cura che il code è mo scannà u controllà. In code QR na verifitgescha betg l'identitad da ina persuna.

Falliment, annullar e restaurar

Sche outcome_unknown=yes, mantegna il medem pass, request_id e las endataziuns cun controllar il resultat anc ina giada. Na crees betg ina nova conferma. already_used, expired e revoked èn resultats final da l'affar. Sche il permess è refusà, dumonda ad in administratur autorisà da revizar il roll da l'emplegià. Clear session reimposta il scanner; na po betg annullar in dovrament cumpiglià.

Capacitads e lims

Pass da plan è d'utilisaziun unica, cun ina durada da 1–86400 secundas; standard 900. Tipas da pass: access, event, coupon e membership. Controllar na reserva betg in pass. L'access a l'internet è necessari per l'utilisaziun dal pass. Nissun processament da pajaments, controll da l'identitad ni carta da membranza a lunga durata reutilisabla. La lectura d'in valur QR ordinar è separada da la controlla d'in pass.

Configuraziuns, acziuns e resultats

Utilisescha quests numens en Bubble. Funcziuns planisadas èn marcadas separadamain.

Configuraziuns beta disponiblas

Configuraziun da l'element

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

Stadis

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

Eveniments

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Acziuns e lur inputs

Clear session

Configuraziun da l'element · 5

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

disabledyes/no · Standard: false: Valur d'exempelno; Exempel Bubble expressiunGuideHost's is_busy (your yes/no custom state); Deactiva l'element cura che tia app è occupada u che questa acziun è betg disponibla.

is_activeyes/no · Standard: true: Valur d'exempelyes; Exempel Bubble expressiunGuideHost's view_is_active (your yes/no custom state); Definiescha yes durant che questa vista è averta. Definiescha no cura che ti bandunas ella, per che la reproducziun u il lavur actual possia sa fermar.

ui_text_jsontext · Standard: "{}": Valur d'exempel{}; Exempel Bubble expressiunApp Settings' player_labels_json (supported keys only); JSON facultativ cun etichettas da buttun sustegnidas. Lascha vid per duvrar il text integrà.

languagetext · Standard: "auto": Valur d'exempeluk; Exempel Bubble expressiunCurrent User's preferred_language; Definiescha language=auto per suandar la lingua da l'apparat u dal navigatur, sch'ella è sustegnida. Endatescha in code da lingua sustegnì per tscherner quella explicitamain.

workflow_modeyes/no · Standard: false: Valur d'exempelyes; Exempel Bubble expressiunApp Settings' use_qr_business_actions; Planà: permetter che il valur scannà QR vegn duvrà da Check QR pass. Scannar sulet na conferma betg l'entrata ni la prelevaziun.

Acziuns e lur inputs · 5

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Clear session

Nagins parameters d'acziun

Issue QR pass

environmenttext · Standard: "development": Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

request_idtext · Standard: —: Valur d'exempelpickup-123-issue-v1; Exempel Bubble expressiunCurrent Admission's stable_request_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

labeltext · Standard: "access": Valur d'exempelevent; Exempel Bubble expressiunSelected Admission's pass_label; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

ttl_secondsnumber · Standard: 900: Valur d'exempel900; Exempel Bubble expressiunEvent Settings' pass_ttl_seconds; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

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

Check QR pass

environmenttext · Standard: "development": Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

pass_tokentext · Standard: —: Valur d'exempel<opaque token returned by Issue / camera scan>; Exempel Bubble expressiunQR Pass Scanner's scanned_pass_token (capture before Check); Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Standard: "development": Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

pass_tokentext · Standard: —: Valur d'exempel<opaque token returned by Issue / camera scan>; Exempel Bubble expressiunQR Pass Scanner's scanned_pass_token (capture before Check); Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

request_idtext · Standard: —: Valur d'exempelpickup-123-redeem-v1; Exempel Bubble expressiunCurrent Admission's stable_redemption_request_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

confirmyes/no · Standard: false: Valur d'exempelyes — explicit confirmation only; Exempel Bubble expressiunConfirm Checkbox is checked; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

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

Revoke QR pass

environmenttext · Standard: "development": Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

pass_idtext · Standard: —: Valur d'exempel<pass_id returned by Issue>; Exempel Bubble expressiunSelected Admission's pass_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

pass_id · textrevoked · yes/no

Stadis e eveniments

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Stadis

scanner_status · text

Resultat actual da questa acziun. Dovra l'eveniment da finiziun correspundent avant da memorisar in success. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Resultat actual da questa acziun. Dovra l'eveniment da finiziun correspundent avant da memorisar in success. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identificader per quest element u acziun. Mantegna el cun il registr da l'app correspundent. Utilisescha il medem identificader da dumonda cun reprovair in resultat incert.

pass_label · text

Valur actual per l'element selecziunà. Legia lura suenter l'event relatà. empty,access,event,coupon,membership

receipt_id · text

Identificader per quest element u acziun. Mantegna el cun il registr da l'app correspundent. Utilisescha il medem identificader da dumonda cun reprovair in resultat incert.

error_code · text

Informaziuns d'error per l'ultima acziun. Mussar in messadi d'agid e porscher il reprovà pertinent.

is_busy · yes/no

Il lavur è anc en cors. Spetga avant da cumenzar ina nova acziun.

is_scanning · yes/no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

torch_enabled · yes/no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

scan_source · text

Valur actual per l'element selecziunà. Legia lura suenter l'event relatà. empty,camera,fixture

pending_redemption · yes/no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

scanned_pass_token · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.