Xodera Plugins · Bubble Native
Xodera QR Passes Native
Lag engangsbilletter, hentedeklarasjoner eller kuponger. Ansatte skanner koden, sjekker resultatet, forhåndsviser bestillingen og bekrefter bruk først når de er klare.
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.
Dokumentasjon gjennomgått 6 november 2026
Praktiske eksempler
Engangsadgang for et arrangement samme dag
Et skjermbilde av en vanlig QR‑verdi kan ellers gjenbrukes ved mer enn én inngang.
Appen din lagrer en Admission‑post og en stabil utstedelse `request_id`; bruk kuratert `label=event` og en `ttl_seconds` innenfor 1–86400‑sekund kontrakten.
En autorisert utsteder kjører Issue QR pass og leverer privat den returnerte QR. Ansatte skanner → Check QR pass → bekrefter kun hvis `ok=yes` og `status=available` → Confirm QR redemption med en lagret stabil forespørsels‑ID.
Kun `status=redeemed` pluss `receipt_id` autoriserer appens admissionskvittering. Lagre pass‑/kvitteringsreferansen på Admission; ikke eksponer innholdet i QR til analyse.
For `outcome_unknown`, gjenopprett samme forespørsel med identisk bruker/miljø/pass; aldri generer en ny bekreftelses‑ID. Håndter expired, revoked og allerede‑brukte tilstander som separate resultater.
Planlagt. Skanning og sjekking bruker ikke passet; kun eksplisitt bekreftelse gjør det.
Løs inn en kortvarig fordel én gang ved en partnerdisk
En partner trenger et bekreftet brukt/ubrukt resultat i stedet for å stole på et QR‑bilde eller en skjermanimasjon.
`label=coupon`; appens Benefit‑post definerer berettigelse og et kort gyldighetsvindu før en autorisert utstedelses‑handling.
Utsted et pass kun etter appens berettigelseskontroll. Ved skranken viser Check QR pass tilgjengelighet uten å forbruke det. Etter at ansatte bekrefter levering av fordelen, kjør Confirm QR redemption.
Benefit‑posten din kan lagre `receipt_id` og den bekreftede innløsnings‑tiden etter `status=redeemed`. Plugin‑en håndterer pass‑status; appen din håndterer fordelen og kundeforholdet.
Hvis en fordel avbrytes før bruk, kan samme autoriserte utsteder Revoke QR pass ved å bruke sin `pass_id`. Ikke kunngjør refusjon eller vellykket innløsning kun fra `ok=yes`.
Planlagt. Skanning og sjekking bruker ikke passet; kun eksplisitt bekreftelse gjør det.
Bekreft henting av utstyr eller bestilling samme dag
En ansatt‑arbeidsflyt må skille mellom skanning av en samlingsreferanse og faktisk overlevering av et element.
Appens eide Samlings‑post beholder autorisasjon, det tiltenkte elementet og separate stabile utstedelses‑/innløsnings‑forespørsels‑ID‑er; bruk et kortvarig `label=access`‑pass.
Etter at appen din autoriserer samling, Issue QR pass. Ansatte skanner og sjekker, inspiserer den tilsvarende samlingen i appen, og bekrefter deretter eksplisitt overleveringen og Confirm QR redemption.
Kun etter en bekreftet `redeemed`‑kvittering skal arbeidsflyten din sette samlingen til overlevert. Behold `receipt_id` som lenken til pass‑resultatet.
En gjentatt skanning kan returnere already_used; vis den eksisterende app‑posten i stedet for å overlevere et annet element. Gjenopprett en usikker bekreftelse med samme ID og input.
Planlagt. Skanning og sjekking bruker ikke passet; kun eksplisitt bekreftelse gjør det.
Hva fungerer nå
Privat beta. Den nåværende skanneren har kamera- og tillatelseskontroller. Å lage, sjekke og bekrefte engangspass er planlagt og er ennå ikke klar til bruk i appen din.
Bygg arbeidsflyten
Planlagt
Planlagt arbeidsflyt. Ikke tilgjengelig i den nåværende betaen ennå.
Disse eksemplene bruker app‑poster som Lesson, Message og Order. Erstatt dem med dine egne datatyper og elementnavn. Eksempel‑medieadresser må erstattes med dine egne filer.
Planlagt: en autorisert ansatt bruker Issue QR pass for en adgang eller Order. Eksempel: label=event, ttl_seconds=900, environment=development. Behold en stabil request_id for den saken og lagre pass_id med posten.
Vis den returnerte QR til den tiltenkte eieren. Personalet skanner den. I den planlagte pass‑arbeidsflyten, bruk workflow_mode=yes og les scanned_pass_token etter pass_scanned. Disse pass‑arbeidsflyt‑innstillingene er ikke tilgjengelige i den nåværende skanneren.
Kjør Check QR pass med pass_token = QR Scanner's scanned_pass_token. Den sjekker uten å bruke passet. For status=available, vis den tilhørende bestillingen eller inngangsdetaljene slik at personalet kan gjennomgå dem.
Kun en egen Bekreft‑knapp kjører Confirm QR redemption med samme pass_token, en stabil request_id og confirm=yes. På status=redeemed, lagre receipt_id og merk den bestillingen eller oppføringen som fullført.
already_used, expired, revoked eller invalid betyr at du ikke skal slippe inn eller overlevere bestillingen. En skanning eller en vellykket sjekk alene fullfører aldri transaksjonen.
Konfigurer én gang
Opprett eller velg ditt Bubble‑app‑prosjekt i BestPlugins → Dashboard → Plugins. Velg Xodera QR Passes Native, kopier nøkkelen, åpne deretter Bubble → Plugins → Xodera QR Passes Native og lim den inn i project_api_key. Lagre én gang; bruk deretter handlingene nedenfor. Hver plugin i hvert prosjekt har sin egen nøkkel.
Skanning krever kameratillatelse. For engangs‑pass, bestem hvem som kan opprette pass og hvem som kan sjekke dem ved døren eller hentepunktet. Vanlige kunder trenger ingen personalrolle.
qr_issuer_permission_field
qr_pass_issuer · Navn på brukerens ja/nei‑felt som markerer ansatte som har lov til å opprette eller tilbakekalle pass. Eksempel/standard: qr_pass_issuer. Angi feltnavnet her, ikke ja eller nei. Kun en autorisert administrator bør endre den tillatelsen på en bruker.
qr_staff_permission_field
qr_staff · Navn på brukerens ja/nei‑felt som markerer ansatte som har lov til å sjekke og bekrefte bruk. Eksempel/standard: qr_staff. En billettinnehaver trenger ikke denne tillatelsen. Hold den utenfor offentlige registrerings‑ og profilskjemaer.
Konfigurer én gang
- Opprett eller velg ditt Bubble‑app‑prosjekt på BestPlugins → Dashboard → Plugins.
- Velg denne plugin‑en og kopier prosjekt‑nøkkelen.
- Åpne Bubble → Plugins → Xodera QR Passes Native; lim inn nøkkelen i project_api_key og lagre.
- Legg til elementet, velg app‑dataene dine og bygg arbeidsflyten nedenfor.
- Privat beta‑tilgang kun foreløpig. Offentlig installasjon og betalt aktivering er ikke åpnet ennå.
Installasjon og abonnement
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.
Lagre resultatet i appen din
Eksempel på adgang eller henting: lagre den tilknyttede bestillingen/hendelsen, pass_id, expires_at og issue_request_id. Etter bekreftet bruk, legg til receipt_id, redeemed_at og den ansatte som bekreftet. Merk ikke posten som fullført når koden bare er skannet eller sjekket. En QR‑kode verifiserer ikke en persons identitet.
Feil, avbryt og gjenoppretting
Hvis outcome_unknown=yes, behold samme pass, request_id og inndata når du sjekker resultatet igjen. Ikke opprett en ny bekreftelse. already_used, expired og revoked er endelige forretningsresultater. Hvis tillatelse nektes, be en autorisert administrator om å gjennomgå den ansattes rolle. Clear session tilbakestiller skanneren; den kan ikke angre en fullført bruk.
Funksjoner og begrensninger
Planlagte pass er engangsbruk, med en levetid på 1–86400 sekunder; standard 900. Pass‑typer: access, event, coupon og membership. Sjekking reserverer ikke et pass. Internett‑tilgang kreves for passbruk. Ingen betalingsbehandling, identitetssjekk eller gjenbrukbart langtidsmedlemskort. Å lese en vanlig QR‑verdi er separat fra å sjekke et pass.
Innstillinger, handlinger og resultater
Bruk disse navnene i Bubble. Planlagte funksjoner er merket separat.
Tilgjengelige beta‑innstillinger
Elementinnstillinger
disabled · yes/nois_active · yes/noui_text_json · textlanguage · textTilstander
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/noHendelser
scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_errorHandlinger og deres innganger
Clear sessionElementinnstillinger · 5
Planlagt arbeidsflyt. Ikke tilgjengelig i den nåværende betaen ennå.
disabledyes/no · Standard: false- Eksempelverdi
no - Eksempel Bubble uttrykk
GuideHost's is_busy (your yes/no custom state) - Deaktiver elementet mens appen din er opptatt eller handlingen er utilgjengelig.
is_activeyes/no · Standard: true- Eksempelverdi
yes - Eksempel Bubble uttrykk
GuideHost's view_is_active (your yes/no custom state) - Sett ja mens denne visningen er åpen. Sett nei ved avslutning, slik at avspilling eller pågående arbeid kan stoppes.
ui_text_jsontext · Standard: "{}"- Eksempelverdi
{} - Eksempel Bubble uttrykk
App Settings' player_labels_json (supported keys only) - Valgfri JSON med støttede knappetiketter. La stå tomt for å bruke den innebygde teksten.
languagetext · Standard: "auto"- Eksempelverdi
uk - Eksempel Bubble uttrykk
Current User's preferred_language - Sett language=auto til å følge en støttet enhet eller nettleserspråk. Skriv inn en støttet språkkode for å velge den eksplisitt.
workflow_modeyes/no · Standard: false- Eksempelverdi
yes - Eksempel Bubble uttrykk
App Settings' use_qr_business_actions - Planlagt: tillat at den skannede QR‑verdien brukes av Check QR pass. Skanning alene bekrefter ikke inngang eller henting.
Handlinger og deres innganger · 5
Planlagt arbeidsflyt. Ikke tilgjengelig i den nåværende betaen ennå.
Clear session
Ingen handlingsparametere
Issue QR pass
environmenttext · Standard: "development"- Eksempelverdi
development - Eksempel Bubble uttrykk
App Settings' selected_environment - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
request_idtext · Standard: —- Eksempelverdi
pickup-123-issue-v1 - Eksempel Bubble uttrykk
Current Admission's stable_request_id - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
labeltext · Standard: "access"- Eksempelverdi
event - Eksempel Bubble uttrykk
Selected Admission's pass_label - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
ttl_secondsnumber · Standard: 900- Eksempelverdi
900 - Eksempel Bubble uttrykk
Event Settings' pass_ttl_seconds - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Retur
pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/noCheck QR pass
environmenttext · Standard: "development"- Eksempelverdi
development - Eksempel Bubble uttrykk
App Settings' selected_environment - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
pass_tokentext · Standard: —- Eksempelverdi
<opaque token returned by Issue / camera scan> - Eksempel Bubble uttrykk
QR Pass Scanner's scanned_pass_token (capture before Check) - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Retur
pass_label · textexpires_at · textConfirm QR redemption
environmenttext · Standard: "development"- Eksempelverdi
development - Eksempel Bubble uttrykk
App Settings' selected_environment - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
pass_tokentext · Standard: —- Eksempelverdi
<opaque token returned by Issue / camera scan> - Eksempel Bubble uttrykk
QR Pass Scanner's scanned_pass_token (capture before Check) - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
request_idtext · Standard: —- Eksempelverdi
pickup-123-redeem-v1 - Eksempel Bubble uttrykk
Current Admission's stable_redemption_request_id - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
confirmyes/no · Standard: false- Eksempelverdi
yes — explicit confirmation only - Eksempel Bubble uttrykk
Confirm Checkbox is checked - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Retur
pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/noRevoke QR pass
environmenttext · Standard: "development"- Eksempelverdi
development - Eksempel Bubble uttrykk
App Settings' selected_environment - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
pass_idtext · Standard: —- Eksempelverdi
<pass_id returned by Issue> - Eksempel Bubble uttrykk
Selected Admission's pass_id - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Retur
pass_id · textrevoked · yes/noTilstander og hendelser
Planlagt arbeidsflyt. Ikke tilgjengelig i den nåværende betaen ennå.
Tilstander
scanner_status · textNåværende resultat av denne handlingen. Bruk den tilsvarende fullføringshendelsen før du lagrer suksess. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded
server_status · textNåværende resultat av denne handlingen. Bruk den tilsvarende fullføringshendelsen før du lagrer suksess. empty,available,redeemed,already_used,expired,revoked
pass_id · textIdentifikator for dette elementet eller handlingen. Behold den sammen med den tilsvarende app‑posten. Bruk samme forespørsels‑identifikator ved gjentakelse av et usikkert resultat.
pass_label · textGjeldende verdi for det valgte elementet. Les den etter den tilknyttede hendelsen. empty,access,event,coupon,membership
receipt_id · textIdentifikator for dette elementet eller handlingen. Behold den sammen med den tilsvarende app‑posten. Bruk samme forespørsels‑identifikator ved gjentakelse av et usikkert resultat.
error_code · textFeilinformasjon for den siste handlingen. Vis en hjelpsom melding og tilby relevant gjenforsøk.
is_busy · yes/noArbeidet pågår fortsatt. Vent før du starter en ny handling.
is_scanning · yes/noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
torch_enabled · yes/noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
scan_source · textGjeldende verdi for det valgte elementet. Les den etter den tilknyttede hendelsen. empty,camera,fixture
pending_redemption · yes/noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
scanned_pass_token · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
Hendelser
scanner_startedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
scanner_pausedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
scanner_cancelledNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
permission_deniedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
pass_scannedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
validation_startedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
validation_completedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
redemption_startedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
pass_redeemedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
redemption_rejectedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
redemption_pendingNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
fixture_decodedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
qr_errorNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
Spørsmål utviklere stiller
Hva betyr de to tillatelsesinnstillingene?
Navn på bruker‑ja/nei‑feltet som markerer ansatte som har lov til å opprette eller tilbakekalle pass. Eksempel/standard: qr_pass_issuer. Angi feltnavnet her, ikke ja eller nei. Kun en autorisert administrator skal endre denne tillatelsen på en bruker. Navn på bruker‑ja/nei‑feltet som markerer personale som har lov til å sjekke og bekrefte bruk. Eksempel/standard: qr_staff. En billettinnehaver trenger ikke denne tillatelsen. Hold den utenfor offentlige registrerings‑ og profilskjemaer.
Kan den samme ansatte opprette og sjekke pass?
Ja, hvis en autorisert administrator gir den ansatte begge tillatelsene. Dette krever ikke en annen prosjekt‑nøkkel. Kunder trenger vanligvis ingen av tillatelsene. Ikke la brukere tildele disse tillatelsene til seg selv.
Hvorfor bruke Sjekk etter Skanning?
Skanning leser koden. Sjekk spør om passet er tilgjengelig uten å bruke det. Personalet kan først gjennomgå bestillingen. Kun den separate Confirm QR redemption‑handlingen bruker passet én gang.
Hvordan fungerer abonnementet?
Planlagt pris: installasjon av plugin i Bubble er gratis. BestPlugins‑tilgang er et eget abonnement for hver plugin i hvert Bubble‑app‑prosjekt: 7 dager gratis, deretter US$1.50 per måned. Development og Live er inkludert. Det finnes ingen fast grense for antall operasjoner; filstørrelses‑ og funksjonsgrenser gjelder fortsatt. Kassen er ikke åpnet ennå. Aktiveringsskjermen vil vise første faktureringsdato og avbestillingsvilkår.
Relaterte veiledninger
Marketplace‑utgivelse venter
Forumveiledning ikke publisert
For hjelp, fortell oss hvilken plugin og enhet du bruker, handlingen du prøvde og hva som skjedde. Bruk et eksempel uten personlige data. Del aldri nøkkelen din eller private filer.