QR-scannerynterface. Ienmalige pas-aksjes binne pland.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Bou kaartsjes foar ien kear, befêstigingen foar opheljen of kûpons. It personiel scant de koade, kontrolearret it resultaat, besjocht de bestelling en befêstiget it gebrûk pas as alles klear is.

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.

Bou de workflow ↓Pluginynstellingen ↗Native Lab

Dokumintaasje beoardiele 6 novimber 2026

Praktyske foarbylden

Ienmalige tagong foar in evenemint op deselde dei

In screenshot fan in gewoane QR-waarde kin oars op mear as ien yngong wer brûkt wurde.

Jo app bewarret in Admission-record en in stabyl `request_id` foar de útjefte; brûk de foarskreaune `label=event` en in `ttl_seconds` binnen it kontrakt fan 1–86400 sekonden.

In autorisearre útjouwer draait Issue QR pass en leveret privee de weromkommende QR. It personiel scan → Check QR pass → befêstigje allinnich as `ok=yes` en `status=available` → Confirm QR redemption mei in bewarre stabile oanfreegings-ID.

Allinnich `status=redeemed` tegearre mei `receipt_id` jout jo app grûn foar in tagongsbefêstiging. Bewarje de referinsje nei de pas en de befêstiging op it Admission-record; diel de QR-ynhâld net mei analysetsjinsten.

Foar `outcome_unknown`, werhelje it deselde fersyk mei identike brûker/omjouwing/pas; generearje nea in nije befêstigings-ID. Hannel expired, revoked en al brûkte steaten as aparte útwurden.

Plande. Skannen en kontrolearjen brûke de pas net; allinnich eksplisyt befêstigjen docht dat.

Brûk in koart jildich foardiel ien kear by in partnerbalje

In partner hat in befêstige brûkt/ûnbrûkt resultaat nedich yn stee fan it fertrouwen op in QR-ôfbylding of in skermanimatie.

`label=coupon`; it Benefit-record fan de app bepaalt wa't foar it foardiel yn oanmerking komt en hoe lang it koart jildich is, foardat in autorisearre útjefte-aksje útfierd wurdt.

Jou in pas út allinnich nei de rjochtekontrole fan jo app. By de balie lit Check QR pass beskikberheid sjen sûnder dizze te ferbrûken. Nei't it personiel de levering fan it foardiel befêstiget, draai Confirm QR redemption.

Jo Benefit-record kin nei `status=redeemed` de `receipt_id` en it befêstige tiidstip fan gebrûk bewarje. De plugin beheart de steat fan de pas; jo app beheart it foardiel en de klantrelaasje.

As in foardiel foar gebrûk annulearre wurdt, kin deselde autorisearre útjouwer Revoke QR pass útfiere mei de `pass_id`. Meitsje net op grûn fan allinnich `ok=yes` in werombetelling of slagge gebrûk bekend.

Plande. Skannen en kontrolearjen brûke de pas net; allinnich eksplisyt befêstigjen docht dat.

Befêstigje in op deselde dei opheljen fan apparatuer of bestelling

De workflow fan it personiel moat it scannen fan in ôfhelreferinsje ûnderskiede fan it feitlik oerdragen fan in artikel.

It Collection-record fan jo app bewarret de autorisaasje, it bedoelde artikel en aparte stabile fersyk-ID's foar útjefte en gebrûk; brûk in koart jildige `label=access`-pas.

Fier Issue QR pass út nei't jo app it opheljen autorisearre hat. It personiel scant en brûkt Check, besjocht it oerienkommende Collection-record yn jo app en befêstiget dan eksplisyt de oerdracht mei Confirm QR redemption.

Pas nei in befêstige gebrûksbewiis mei `redeemed` mei jo workflow it Collection-record op oerdroegen sette. Hâld `receipt_id` as keppeling nei de útkomst fan de pas.

In werhelte scan kin already_used weromjaan; toan it besteande apprecord yn stee fan in oar item oer te dragen. Werhelje in ûnwis befêstiging mei deselde ID en ynfieringen.

Plande. Skannen en kontrolearjen brûke de pas net; allinnich eksplisyt befêstigjen docht dat.

Wat no wurket

Privee beta. De hjoeddeiske scanner hat kamera- en tastimmingkontrollen. It oanmeitsjen, kontrolearjen en befêstigjen fan ienmalige passen is pland en noch net klear om te brûken yn jo app.

Bou de workflow

Plande

Plande workflow. Noch net beskikber yn de hjoeddeiske beta.

Dizze foarbylden brûke app-records lykas Lesson, Message en Order. Ferfang se troch jo eigen gegevenstypen en elemintnammen. Ferfang de media-adressen út de foarbylden troch adressen fan jo eigen bestannen.

Pland: in autorisearre meiwurker brûkt Issue QR pass foar in Admission of Order. Foarbyld: label=event, ttl_seconds=900, environment=development. Hâld in stabyl request_id foar dy útjefte en bewarje pass_id by it record.
Lit de weromjûn QR sjen oan de bedoeld houder. Persoanen scannen it. Yn de plande pasworkflow, brûk workflow_mode=yes en lêze scanned_pass_token nei pass_scanned. Dizze pas-workflowynstellingen binne net beskikber yn de hjoeddeiske scanner.
Run Check QR pass mei pass_token = QR Scanner's scanned_pass_token. It kontrolearret sûnder de pas te brûken. Foar status=available, lit de oerienkommende bestelling- of yngongdetails sjen sadat persoanen se beoardiele kinne.
Allinnich in aparte Befêstigingsknop rint Confirm QR redemption mei deselde pass_token, in stabile request_id en confirm=yes. Op status=redeemed, bewarje receipt_id en markearje dy bestelling of yngong as foltôge.
already_used, expired, revoked of invalid betsjut dat jo gjin tagong jaan of de bestelling oerdrage meie. In scan of in slagge Check allinnich foltôget de transaksje nea.

Workflow-diagram — gjin app-skermôfdruk

Ien kear konfigurearje

Meitsje of kies jo Bubble app-projekt yn BestPlugins → Dashboard → Plugins. Kies Xodera QR Passes Native, kopiearje de kaai, iepenje dan Bubble → Plugins → Xodera QR Passes Native en plak dizze yn project_api_key. Bewarje ien kear; brûk dêrnei de aksjes hjirûnder. Elke plugin yn elk projekt hat syn eigen kaai.

Scannen fereasket kameratastimming. Beslis foar passen foar ien kear wa't passen meitsje mei en wa't se by de doar of it ôfhelpunt kontrolearje mei. Gewoane klanten hawwe gjin fan beide personielsrollen nedich.

`qr_issuer_permission_field`

qr_pass_issuer · Namme fan it User-fjild fan type yes/no dat meiwurkers markearret dy't passen meitsje of ynlûke meie. Foarbyld/standert: qr_pass_issuer. Fier hjir de fjildnamme yn, net yes of no. Allinnich in autorisearre behearder mei dy tastimming foar in brûker wizigje.

`qr_staff_permission_field`

qr_staff · Namme fan it User-fjild fan type yes/no dat personiel markearret dat gebrûk kontrolearje en befêstigje mei. Foarbyld/standert: qr_staff. In kaartsjehâlder hat dizze tastimming net nedich. Hâld dit fjild bûten iepenbiere oanmeld- en profylformulieren.

Ien kear konfigurearje

Meitsje of kies jo Bubble app-projekt by BestPlugins → Dashboard → Plugins.
Kies dizze plugin en kopiearje syn projektkaai.
Iepenje Bubble → Plugins → Xodera QR Passes Native; plak de kaai yn project_api_key en bewarje.
Foegje it elemint ta, kies jo app-gegevens en bou de workflow hjirûnder.
Privee-beta-tagong foar no allinnich. Iepenbiere ynstallaasje en betelle aktivearring binne noch net beskikber.

Ynstallaasje en abonnemint

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.

Bewarje it resultaat yn jo app

Foarbyld Ynlating of Ophal: bewarje de byhearrende bestelling/gebeurtenis, pass_id, expires_at en issue_request_id. Nei befêstige brûk, foegje receipt_id, redeemed_at en de meiwurker dy't befêstige hat ta. Markearje it rekord net as foltôge wannear de koade allinnich skand of kontrolearre is. In QR-koade ferifiearret net iemands identiteit.

Mislearjen, annulearjen en herstellen

As outcome_unknown=yes, hâld de selde pas, request_id en ynfier-ynformaasje by it kontrolearjen fan it resultaat opnij. Meitsje gjin nije befêstiging. already_used, expired en revoked binne definitive saaklike resultaten. As tastimming wegere wurdt, freegje in autorisearre behearder om de rol fan de meiwurker te beoardielen. Clear session set de scanner werom; it kin in foltôge brûk net ûngedien meitsje.

Moglikheden en limiten

Plande passen binne ienmalich, mei in libbensdoer 1–86400 sekonden; standert 900. Passtypen: access, event, coupon en membership. Kontrolearjen reservearret gjin pas. Ynternetferbining is fereaske foar pasgebrûk. Gjin betellingsferwurking, identiteitskontrole of werbrûkbere langduorjende lidmaatskipskaart. It lêzen fan in gewoane QR-wearde is apart fan it kontrolearjen fan in pas.

Ynstellings, aksjes en resultaten

Brûk dizze nammen yn Bubble. Plande funksjes binne apart markearre.

Bêta-ynstellingen beskikber

Elemintynstellingen

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

Steaten

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

Eveneminten

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Aksjes en harren ynputs

Clear session

Elemintynstellingen · 5

Plande workflow. Noch net beskikber yn de hjoeddeiske beta.

disabledyes/no · Standert: false: Foarbyldweardeno; Foarbyld Bubble útdrukkingGuideHost's is_busy (your yes/no custom state); Skeakel it elemint út wylst jo app dwaande is of dizze aksje net beskikber is.

is_activeyes/no · Standert: true: Foarbyldweardeyes; Foarbyld Bubble útdrukkingGuideHost's view_is_active (your yes/no custom state); Stel yes yn wylst dit skerm iepen is. Stel no yn as jo it ferlitte, sadat it ôfspyljen of it hjoeddeiske wurk stopje kin.

ui_text_jsontext · Standert: "{}": Foarbyldwearde{}; Foarbyld Bubble útdrukkingApp Settings' player_labels_json (supported keys only); Opsjoneel JSON mei stipte knoplabels. Lit leech om de ynboude tekst te brûken.

languagetext · Standert: "auto": Foarbyldweardeuk; Foarbyld Bubble útdrukkingCurrent User's preferred_language; Stel language=auto yn om de taal fan it apparaat of de browser te folgjen as dy taal stipe wurdt. Fier in stipe taalkoade yn om dy taal eksplisyt te kiezen.

workflow_modeyes/no · Standert: false: Foarbyldweardeyes; Foarbyld Bubble útdrukkingApp Settings' use_qr_business_actions; Pland: lit Check QR pass de scande QR-wearde brûke. Scannen allinnich befêstiget gjin tagong of opheljen.

Aksjes en harren ynputs · 5

Plande workflow. Noch net beskikber yn de hjoeddeiske beta.

Clear session

Gjin aksjeparameters

Issue QR pass

environmenttext · Standert: "development": Foarbyldweardedevelopment; Foarbyld Bubble útdrukkingApp Settings' selected_environment; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

request_idtext · Standert: —: Foarbyldweardepickup-123-issue-v1; Foarbyld Bubble útdrukkingCurrent Admission's stable_request_id; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

labeltext · Standert: "access": Foarbyldweardeevent; Foarbyld Bubble útdrukkingSelected Admission's pass_label; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

ttl_secondsnumber · Standert: 900: Foarbyldwearde900; Foarbyld Bubble útdrukkingEvent Settings' pass_ttl_seconds; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

Weromjûne wearden

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

Check QR pass

environmenttext · Standert: "development": Foarbyldweardedevelopment; Foarbyld Bubble útdrukkingApp Settings' selected_environment; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

pass_tokentext · Standert: —: Foarbyldwearde<opaque token returned by Issue / camera scan>; Foarbyld Bubble útdrukkingQR Pass Scanner's scanned_pass_token (capture before Check); Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

Weromjûne wearden

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Standert: "development": Foarbyldweardedevelopment; Foarbyld Bubble útdrukkingApp Settings' selected_environment; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

pass_tokentext · Standert: —: Foarbyldwearde<opaque token returned by Issue / camera scan>; Foarbyld Bubble útdrukkingQR Pass Scanner's scanned_pass_token (capture before Check); Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

request_idtext · Standert: —: Foarbyldweardepickup-123-redeem-v1; Foarbyld Bubble útdrukkingCurrent Admission's stable_redemption_request_id; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

confirmyes/no · Standert: false: Foarbyldweardeyes — explicit confirmation only; Foarbyld Bubble útdrukkingConfirm Checkbox is checked; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

Weromjûne wearden

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

Revoke QR pass

environmenttext · Standert: "development": Foarbyldweardedevelopment; Foarbyld Bubble útdrukkingApp Settings' selected_environment; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

pass_idtext · Standert: —: Foarbyldwearde<pass_id returned by Issue>; Foarbyld Bubble útdrukkingSelected Admission's pass_id; Brûk de wearde fan it hjoeddeiske saaklike rekord; falidearje it tsjin de hjirûnder steande limiten.

Weromjûne wearden

pass_id · textrevoked · yes/no

Steaten en eveneminten

Plande workflow. Noch net beskikber yn de hjoeddeiske beta.

Steaten

scanner_status · text

Aktueel resultaat fan dizze aksje. Brûk it oerienkommende foltôgingsevenemint foardat jo sukses bewarje. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Aktueel resultaat fan dizze aksje. Brûk it oerienkommende foltôgingsevenemint foardat jo sukses bewarje. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifier foar dit item of aksje. Hâld it by it oerienkommende app‑record. Brûk deselde oanfraach‑identifier by it opnij probearjen fan in ûnwissel resultaat.

pass_label · text

Aktuele wearde foar it selektearre item. Lês it nei it bybehorende evenemint. empty,access,event,coupon,membership

receipt_id · text

Identifier foar dit item of aksje. Hâld it by it oerienkommende app‑record. Brûk deselde oanfraach‑identifier by it opnij probearjen fan in ûnwissel resultaat.

error_code · text

Foutynformaasje foar de lêste aksje. Lit in nuttich berjocht sjen en bied de relevante probearring oan.

is_busy · yes/no

It wurk is noch dwaande. Wachtsje foardat jo in oare aksje starte.

is_scanning · yes/no

Hjoeddeiske wearde foar it selektearre item. Lês it nei it bybehorende evenemint.

torch_enabled · yes/no

Hjoeddeiske wearde foar it selektearre item. Lês it nei it bybehorende evenemint.

scan_source · text

Aktuele wearde foar it selektearre item. Lês it nei it bybehorende evenemint. empty,camera,fixture

pending_redemption · yes/no

Hjoeddeiske wearde foar it selektearre item. Lês it nei it bybehorende evenemint.

scanned_pass_token · text

Hjoeddeiske wearde foar it selektearre item. Lês it nei it bybehorende evenemint.