Xodera Plugins · Bubble Native
Xodera QR Passes Native
Bygg engangsbilletter, henting‑stadfestingar eller kupongar. Tilsette skannar koden, sjekkar resultatet, førehandsviser bestillinga og stadfestar bruk berre når klar.
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 døme
Ein‑gangs adgang til ein hending på same dag
Eit skjermbilde av ein vanleg QR-verdi kan elles bli brukt på meir enn eitt inngangspunkt.
Appen din lagrar ein Admission‑post og ein stabil utgjeving `request_id`; bruk kurert `label=event` og ein `ttl_seconds` innanfor 1–86400‑sekund kontrakten.
Ein autorisert utferdar køyrer Issue QR pass og leverer privat det returnerte QR. Tilsette skannar → Check QR pass → bekrefter berre om `ok=yes` og `status=available` → Confirm QR redemption med ein lagra stabil førespurnads‑ID.
Berre `status=redeemed` pluss `receipt_id` autoriserer appens admissionskvittering. Lagre pass/kvitteringsreferansen på Admission; ikkje eksponér innhaldet i QR for analyse.
For `outcome_unknown`, gjenopprett den same førespurnaden med same brukar, same miljø og same QR-pass; lag aldri ein ny stadfestings-ID. Handter tilstandane expired og revoked og pass som allereie er brukte, som ulike resultat.
Planlagt. Skanning og kontroll bruker ikkje passet; berre eksplisitt bekreftelse gjer det.
Løys inn ein kortvarig fordel ein gong ved ein partnardisk
Ein partnar treng eit bekrefta brukt/ubrukta resultat i staden for å stole på eit QR‑bilde eller ein skjerm‑animasjon.
`label=coupon`; appens Benefit‑post definerer kvalifisering og eit kort gyldigheitsvindauge før ein autorisert utgjeving.
Utferd eit pass berre etter at appen har gjort kvalifiseringskontroll. Ved terminalen viser Check QR pass tilgjenge utan å bli brukt. Etter at tilsett har bekrefta levering av fordelen, køyr Confirm QR redemption.
Benefit‑posten din kan lagre `receipt_id` og den bekrefta innløysingstida etter `status=redeemed`. Tilleggsprogrammet handterer pass‑tilstand; appen din handterer fordelen og kundeforholdet.
Viss ein fordel blir kansellert før bruk, kan den same autoriserte utferdaren Revoke QR pass ved å bruke sin `pass_id`. Ikkje kunngjer refusjon eller vellykka innløysing basert på `ok=yes`.
Planlagt. Skanning og kontroll bruker ikkje passet; berre eksplisitt bekreftelse gjer det.
Bekreft same‑dag‑utstyr‑ eller bestillingshenting
Ein tilsett‑arbeidsflyt må skilje mellom skanning av ein samlingsreferanse og faktisk overlevering av eit element.
Appens eigde Samlings‑post oppbevar autorisasjon, det tiltenkte elementet og separate stabile utgjeving/innløysings‑førespurnads‑IDar; bruk eit kortvarig `label=access`‑pass.
Etter at appen autoriserer samling, Issue QR pass. Tilsette skannar og kontrollerer, inspiserer den tilsvarande samlinga i appen, og deretter bekrefter eksplisitt overleveringa og Confirm QR redemption.
Berre etter ein bekrefta `redeemed`‑kvittering skal arbeidsflyten din setje samlinga til overlevert. Behald `receipt_id` som lenke til pass‑resultatet.
Ein gjentekande skanning kan returnere already_used; vis den eksisterande app‑posten i staden for å overlevere eit anna element. Gjenopprett ein usikker bekreftelse med same ID og inndata.
Planlagt. Skanning og kontroll bruker ikkje passet; berre eksplisitt bekreftelse gjer det.
Kva som fungerer no
Privat beta. Den aktuelle skannaren har kamera‑ og løyvekontrollar. Å lage, sjekke og stadfeste engangspass er planlagt og er ikkje klar til bruk i appen din enno.
Bygg arbeidsflyten
Planlagt
Planlagt arbeidsflyt. Ikkje tilgjengeleg i den aktuelle betaen enno.
Desse døma bruker app‑registreringar som Lesson, Message og Order. Byt dei ut med eigne datatypar og elementnamn. Eksempel‑medieadresser må erstattast med eigne filer.
Planlagt: ein autorisert tilsett bruker Issue QR pass for ein innreise eller Order. Døme: label=event, ttl_seconds=900, environment=development. Behald ein stabil request_id for den saken og lagre pass_id med posten.
Vis den returnerte QR til den tiltenkte innehavaren. Tilsette skannar den. I den planlagde pass‑arbeidsflyten, bruk workflow_mode=yes og les scanned_pass_token etter pass_scanned. Desse pass‑arbeidsflyt‑innstillingane er ikkje tilgjengelege i den aktuelle skannaren.
Køyr Check QR pass med pass_token = QR Scanner's scanned_pass_token. Den sjekkar utan å bruke passet. For status=available, vis den tilhøyrande ordren eller oppføringsdetaljane slik at tilsette kan gjennomgå dei.
Berre ein separat Bekreft‑knapp køyrer Confirm QR redemption med same pass_token, ein stabil request_id og confirm=yes. På status=redeemed, lagre receipt_id og merk den ordren eller oppføringa som fullført.
already_used, expired, revoked eller invalid betyr at du ikkje skal innvilge eller overrekke ordren. Ein skanning eller ein vellykka Sjekk aleine fullfører aldri transaksjonen.
Konfigurer ein gong
Opprett eller vel ditt Bubble‑app‑prosjekt i BestPlugins → Dashboard → Plugins. Vel Xodera QR Passes Native, kopier nøkkelen, og opna deretter Bubble → Plugins → Xodera QR Passes Native og lim den inn i project_api_key. Lagre ein gong; bruk så handlingane nedanfor. Kvar plugin i kvart prosjekt har sin eigen nøkkel.
Skanning krev kameratillatelse. For eingongspass, avgjer kven som kan opprette pass og kven som kan sjekke dei ved døra eller hentepunktet. Vanlege kundar treng verken personalrolle.
qr_issuer_permission_field
qr_pass_issuer · Namn på brukar‑ja/nei‑feltet som markerer tilsette som kan opprette eller trekke tilbake pass. Døme/standard: qr_pass_issuer. Skriv inn feltnamnet her, ikkje ja eller nei. Berre ein autorisert administrator bør endre den løyva på ein brukar.
qr_staff_permission_field
qr_staff · Namn på brukar‑ja/nei‑feltet som markerer tilsette som kan sjekke og stadfeste bruk. Døme/standard: qr_staff. Ein billettinnehavar treng ikkje denne løyva. Hald det utanfor offentlege registrerings‑ og profilskjema.
Konfigurer ein gong
- Opprett eller vel ditt Bubble‑app‑prosjekt på BestPlugins → Dashboard → Plugins.
- Vel denne plugin‑en og kopier prosjektnøkkelen.
- Opna Bubble → Plugins → Xodera QR Passes Native; lim inn nøkkelen i project_api_key og lagre.
- Legg til elementet, vel app‑dataa dine og bygg arbeidsflyten nedanfor.
- Privat beta‑tilgang berre for no. Offentleg installasjon og betalt aktivering er ikkje open enno.
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
Døme på innreise eller henting: lagre den tilknytte bestilling/hending, pass_id, expires_at og issue_request_id. Etter bekrefta bruk, legg til receipt_id, redeemed_at og den tilsette som stadfekte. Ikkje merk posten som fullført når koden berre er skanna eller sjekka. Ein QR‑kode verifiserer ikkje ein persons identitet.
Feil, avbryt og gjenoppretting
Hvis outcome_unknown=yes, behold same pass, request_id og inndata når du sjekkar resultatet igjen. Ikke opprett ein ny bekreftelse. already_used, expired og revoked er endelege forretningsresultat. Dersom løyve blir avvist, be ein autorisert administrator om å gjennomgå den tilsette sin rolle. Clear session nullstiller skannaren; den kan ikkje angre ein fullført bruk.
Evner og grenser
Planlagde pass er ein‑gangs, med ein levetid på 1–86400 sekund; standard 900. Pass-typar: access, event, coupon og membership. Sjekking reserverer ikkje eit pass. Internett‑tilgang er påkrevd for passbruk. Ingen betalingsbehandling, identitetssjekk eller gjenbrukbar langtidsmedlemskort. Å lese ein vanleg QR‑verdi er separat frå å sjekke eit pass.
Innstillingar, handlingar og resultat
Bruk desse namna i Bubble. Planlagde funksjonar er merkte separat.
Tilgjengelege beta‑innstillingar
Elementinnstillingar
disabled · yes/nois_active · yes/noui_text_json · textlanguage · textTilstandar
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/noHendingar
scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_errorHandlingar og deira innspel
Clear sessionElementinnstillingar · 5
Planlagt arbeidsflyt. Ikkje tilgjengeleg i den aktuelle betaen enno.
disabledyes/no · Standard: false- Dømeverdi
no - Døme Bubble uttrykk
GuideHost's is_busy (your yes/no custom state) - Deaktiver elementet medan appen din er opptatt eller handlinga er utilgjengeleg.
is_activeyes/no · Standard: true- Dømeverdi
yes - Døme Bubble uttrykk
GuideHost's view_is_active (your yes/no custom state) - Set ja medan denne visinga er open. Set nei ved avslutting, slik at avspeling eller pågåande arbeid kan stoppe.
ui_text_jsontext · Standard: "{}"- Dømeverdi
{} - Døme Bubble uttrykk
App Settings' player_labels_json (supported keys only) - Valfri JSON med støtta knappetekstar. La stå tomt for å bruke den innebygde teksten.
languagetext · Standard: "auto"- Dømeverdi
uk - Døme Bubble uttrykk
Current User's preferred_language - Set language=auto til å følgje ein støtta eining eller nettlesarspråk. Skriv inn ein støtta språkkode for å velje den eksplisitt.
workflow_modeyes/no · Standard: false- Dømeverdi
yes - Døme Bubble uttrykk
App Settings' use_qr_business_actions - Planlagt: tillat at den skannede QR‑verdien kan brukast av Check QR pass. Skanning aleine bekrefter ikkje inngang eller henting.
Handlingar og deira innspel · 5
Planlagt arbeidsflyt. Ikkje tilgjengeleg i den aktuelle betaen enno.
Clear session
Ingen handlingsparametrar
Issue QR pass
environmenttext · Standard: "development"- Dømeverdi
development - Døme Bubble uttrykk
App Settings' selected_environment - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
request_idtext · Standard: —- Dømeverdi
pickup-123-issue-v1 - Døme Bubble uttrykk
Current Admission's stable_request_id - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
labeltext · Standard: "access"- Dømeverdi
event - Døme Bubble uttrykk
Selected Admission's pass_label - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
ttl_secondsnumber · Standard: 900- Dømeverdi
900 - Døme Bubble uttrykk
Event Settings' pass_ttl_seconds - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
Retur
pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/noCheck QR pass
environmenttext · Standard: "development"- Dømeverdi
development - Døme Bubble uttrykk
App Settings' selected_environment - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
pass_tokentext · Standard: —- Dømeverdi
<opaque token returned by Issue / camera scan> - Døme Bubble uttrykk
QR Pass Scanner's scanned_pass_token (capture before Check) - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
Retur
pass_label · textexpires_at · textConfirm QR redemption
environmenttext · Standard: "development"- Dømeverdi
development - Døme Bubble uttrykk
App Settings' selected_environment - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
pass_tokentext · Standard: —- Dømeverdi
<opaque token returned by Issue / camera scan> - Døme Bubble uttrykk
QR Pass Scanner's scanned_pass_token (capture before Check) - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
request_idtext · Standard: —- Dømeverdi
pickup-123-redeem-v1 - Døme Bubble uttrykk
Current Admission's stable_redemption_request_id - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
confirmyes/no · Standard: false- Dømeverdi
yes — explicit confirmation only - Døme Bubble uttrykk
Confirm Checkbox is checked - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
Retur
pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/noRevoke QR pass
environmenttext · Standard: "development"- Dømeverdi
development - Døme Bubble uttrykk
App Settings' selected_environment - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
pass_idtext · Standard: —- Dømeverdi
<pass_id returned by Issue> - Døme Bubble uttrykk
Selected Admission's pass_id - Bruk den gjeldande forretningspostens verdi; valider den mot grensa nedanfor.
Retur
pass_id · textrevoked · yes/noTilstandar og hendingar
Planlagt arbeidsflyt. Ikkje tilgjengeleg i den aktuelle betaen enno.
Tilstandar
scanner_status · textNoverande resultat av denne handlinga. Bruk den tilsvarande fullføringshendinga før du lagrar suksess. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded
server_status · textNoverande resultat av denne handlinga. Bruk den tilsvarande fullføringshendinga før du lagrar suksess. empty,available,redeemed,already_used,expired,revoked
pass_id · textIdentifikator for dette elementet eller handlinga. Behald den saman med den tilhøyrande app‑posten. Bruk same førespurnadsidentifikator ved gjentaking av eit usikkert resultat.
pass_label · textGjeldande verdi for det valde elementet. Les den etter den tilknytte hendinga. empty,access,event,coupon,membership
receipt_id · textIdentifikator for dette elementet eller handlinga. Behald den saman med den tilhøyrande app‑posten. Bruk same førespurnadsidentifikator ved gjentaking av eit usikkert resultat.
error_code · textFeilinformasjon for den siste handlinga. Vis ein hjelpsam melding og tilby den relevante omstarten.
is_busy · yes/noArbeidet pågår framleis. Vent før du startar ein annan handling.
is_scanning · yes/noNoverande verdi for det valde elementet. Les den etter den tilknytte hendinga.
torch_enabled · yes/noNoverande verdi for det valde elementet. Les den etter den tilknytte hendinga.
scan_source · textGjeldande verdi for det valde elementet. Les den etter den tilknytte hendinga. empty,camera,fixture
pending_redemption · yes/noNoverande verdi for det valde elementet. Les den etter den tilknytte hendinga.
scanned_pass_token · textNoverande verdi for det valde elementet. Les den etter den tilknytte hendinga.
Hendingar
scanner_startedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
scanner_pausedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
scanner_cancelledNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
permission_deniedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
pass_scannedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
validation_startedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
validation_completedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
redemption_startedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
pass_redeemedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
redemption_rejectedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
redemption_pendingNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
fixture_decodedNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
qr_errorNår denne hendinga skjer, les dei tilknytte tilstandane frå same element.
Spørsmål utviklarar stiller
Kva betyr dei to løyveinnstillingane?
Namn på brukar‑ja/nei‑feltet som markerer tilsette som kan opprette eller tilbakekalle pass. Døme/standard: qr_pass_issuer. Skriv inn feltnamnet her, ikkje ja eller nei. Berre ein autorisert administrator bør endre dette løyvet på ein brukar. Namn på brukar‑ja/nei‑feltet som markerer tilsette som kan sjekke og bekrefte bruk. Døme/standard: qr_staff. Ein billettinhavar treng ikkje dette løyvet. Hald det utanfor offentlege registrerings‑ og profilskjema.
Kan den same tilsett opprette og sjekke pass?
Ja, dersom ein autorisert administrator gir den tilsette begge løyva. Dette krev ikkje ein annan prosjektnøkkel. Kundar treng normalt ingen av løyva. Ikkje la brukarar tildele seg sjølve desse løyva.
Kvifor bruke Check etter Scan?
Scan les koden. Check spør om passet er tilgjengeleg utan å bruke det. Tilsette kan gjennomgå bestillinga først. Berre den separate Confirm QR redemption-handlingen brukar passet ein gong.
Korleis fungerer abonnementet?
Planlagt pris: installering av plugin‑en i Bubble er gratis. BestPlugins‑tilgang er eit separat abonnement for kvar plugin i kvart Bubble‑app‑prosjekt: 7 dagar gratis, deretter US$1.50 per månad. Development og Live er inkluderte. Det finst ingen fast grense for talet på operasjonar; grenser for filstorleik og funksjonar gjeld framleis. Kassa er ikkje open enno. Aktiveringsskjermen vil vise den første faktureringsdatoen og avbestillingsvilkåra.
Relaterte vegvisar
Marketplace‑utgjeving ventar
Forumrettleiing ikkje publisert
For hjelp, fortel oss kva plugin og eining du bruker, handlinga du prøvde og kva som skjedde. Bruk eit døme utan personopplysningar. Del aldri nøkkelen din eller private filer.