QR skeneris saskarne. Vienreizējās piekļuves darbības ir plānotas.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Izveidojiet vienreiz lietojamus biļetes, saņemšanas apstiprinājumus vai kuponus. Darbinieki skenē kodu, pārbauda rezultātu, priekšskatās pasūtījumu un apstiprina lietošanu tikai tad, kad ir gatavi.

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.

Izveidojiet darbplūsmu ↓Spraudņa iestatījumi ↗Native Lab

Dokumentācija pārskatīta 6 novembrī 2026

Praktiski piemēri

Vienreizējā piekļuve vienas dienas pasākumam

Parastā QR vērtības ekrānuzņēmumu citādi var tikt izmantots vairāk nekā vienā ieejā.

Jūsu lietotne saglabā Admission ierakstu un stabilu izsniegšanas pieprasījuma `request_id`; izmantojiet iepriekš noteikto `label=event` un `ttl_seconds` vērtību 1–86400 sekunžu robežās.

Pilnvarots izdevējs izpilda Issue QR pass un privāti nodod atgriezto QR. Personāls skenē → Check QR pass → apstiprina tikai, ja `ok=yes` un `status=available` → Confirm QR redemption ar saglabātu stabilu pieprasījuma ID.

Tikai `status=redeemed` kopā ar `receipt_id` ļauj jūsu lietotnei izdot ieejas apstiprinājuma kvīti. Caurlaides/kvīts atsauci saglabājiet Admission ierakstā; nenododiet QR saturu analītikas sistēmām.

Ja ir `outcome_unknown`, noskaidrojiet tā paša pieprasījuma rezultātu, izmantojot to pašu lietotāju, vidi un caurlaidi; nekad neģenerējiet jaunu apstiprinājuma ID. expired, revoked un jau izmantotas caurlaides stāvokļus apstrādājiet kā atšķirīgus rezultātus.

Plānots. Noskenēšana un pārbaude neatzīmē caurlaidi kā izmantotu; to dara tikai nepārprotama apstiprināšana.

Izmantojiet īslaicīgu priekšrocību vienu reizi pie partnera apkalpošanas letes

Partnerim ir nepieciešams apstiprināts izmantots/neizmantots rezultāts, nevis uzticēties QR attēlam vai ekrāna animācijai.

`label=coupon`; lietotnes labuma ieraksts nosaka atbilstību un īsu derīguma laika logu pirms pilnvarotas izdošanas darbības.

Izsniedziet caurlaidi tikai pēc tam, kad jūsu lietotne ir pārbaudījusi tiesības saņemt priekšrocību. Pie apkalpošanas letes Check QR pass parāda, vai caurlaide ir pieejama, neatzīmējot to kā izmantotu. Kad darbinieks ir apstiprinājis priekšrocības saņemšanu, palaidiet Confirm QR redemption.

Jūsu labuma ieraksts var saglabāt `receipt_id` un apstiprināto izpirkšanas laiku pēc `status=redeemed`. Spraudnis pārvalda kartes stāvokli; jūsu lietotne pārvalda labumu un klienta attiecības.

Ja labums tiek atcelts pirms lietošanas, tas pats pilnvarotais izdevējs var veikt Revoke QR pass, izmantojot tā `pass_id`. Neizsludiniet atmaksu vai veiksmīgu izpirkšanu tikai no `ok=yes`.

Plānots. Noskenēšana un pārbaude neatzīmē caurlaidi kā izmantotu; to dara tikai nepārprotama apstiprināšana.

Apstipriniet tajā pašā dienā notiekošu iekārtas vai pasūtījuma izņemšanu.

Darbinieku darbplūsmā jāatšķir preces saņemšanas atsauces noskenēšana no faktiskas preces nodošanas.

Jūsu lietotnei piederošais Collection ieraksts glabā saņemšanas atļauju, paredzēto preci un atsevišķus stabilus izsniegšanas un izmantošanas apstiprināšanas pieprasījumu ID; izmantojiet īslaicīgu `label=access` caurlaidi.

Kad jūsu lietotne ir atļāvusi preces saņemšanu, palaidiet Issue QR pass. Darbinieki noskenē caurlaidi un veic Check pārbaudi, jūsu lietotnē pārskata atbilstošo Collection ierakstu un pēc tam nepārprotami apstiprina preces nodošanu un palaiž Confirm QR redemption.

Tikai pēc apstiprināta `redeemed` kvīts jūsu darbplūsmai jāiestata kolekcija kā nodota. Saglabājiet `receipt_id` kā saiti uz kartes rezultātu.

Atkārtota skenēšana var atgriezt already_used; parādiet esošo lietotnes ierakstu, nevis nododot citu vienumu. Atgūstiet nenoteiktu apstiprinājumu ar to pašu ID un ievadiem.

Plānots. Noskenēšana un pārbaude neatzīmē caurlaidi kā izmantotu; to dara tikai nepārprotama apstiprināšana.

Kas pašlaik darbojas

Privāta beta versija. Pašreizējam skenerim ir kameras un atļauju vadīklas. Vienreizēju caurlaižu izveide, pārbaude un izmantošanas apstiprināšana ir plānota, taču jūsu lietotnē vēl nav gatava lietošanai.

Izveidojiet darbplūsmu

Plānots

Plānots darbplūsma. Šobrīd nav pieejama pašreizējā beta versijā.

Šie piemēri izmanto lietotnes ierakstus, piemēram, Lesson, Message un Order. Aizstājiet tos ar saviem datu tipiem un elementu nosaukumiem. Piemēru multivides adreses jāaizstāj ar jūsu failiem.

Plānots: pilnvarots darbinieks izmanto Issue QR pass attiecīgajam Admission vai Order ierakstam. Piemērs: label=event, ttl_seconds=900, environment=development. Šai izsniegšanas darbībai saglabājiet stabilu request_id un pie ieraksta saglabājiet pass_id.
Parādiet atgriezto QR kodu personai, kurai caurlaide paredzēta. Darbinieki to noskenē. Plānotajā caurlaides darbplūsmā izmantojiet workflow_mode=yes un pēc pass_scanned nolasiet scanned_pass_token. Šie caurlaižu darbplūsmas iestatījumi pašreizējā skenerī nav pieejami.
Palaidiet Check QR pass ar pass_token = QR Scanner's scanned_pass_token. Šī darbība pārbauda caurlaidi, neatzīmējot to kā izmantotu. Ja status=available, parādiet atbilstošā pasūtījuma vai ieejas datus, lai darbinieki varētu tos pārskatīt.
Tikai atsevišķs Apstiprināt pogas nospiešana izpilda Confirm QR redemption ar to pašu pass_token, stabilu request_id un confirm=yes. status=redeemed gadījumā saglabājiet receipt_id un atzīmējiet šo pasūtījumu vai ierakstu kā pabeigtu.
already_used, expired, revoked vai invalid nozīmē, ka nedrīkst atļaut ieeju vai izsniegt pasūtījumu. Noskenēšana vai veiksmīga Check pārbaude pati par sevi nekad nepabeidz darījumu.

Darba plūsmas diagramma — ne lietotnes ekrānuzņēmums

Konfigurējiet vienreiz

Izveidojiet vai izvēlieties savu Bubble lietotnes projektu vietnē BestPlugins → Dashboard → Plugins. Izvēlieties Xodera QR Passes Native, nokopējiet tā atslēgu, pēc tam atveriet Bubble → Plugins → Xodera QR Passes Native un ielīmējiet to project_api_key. Saglabājiet vienreiz; pēc tam izmantojiet zemāk redzamās darbības. Katram spraudnim katrā projektā ir sava atslēga.

Skenēšanai vajadzīga atļauja izmantot kameru. Vienreizējām caurlaidēm nosakiet, kam ir tiesības tās izveidot un kam ir tiesības tās pārbaudīt pie ieejas vai preču saņemšanas punktā. Parastajiem klientiem nav vajadzīga neviena no šīm darbinieku lomām.

`qr_issuer_permission_field`

qr_pass_issuer · Lietotāja jā/nē lauka nosaukums, kas norāda darbiniekus, kuri var izveidot vai anulēt pases. Piemērs/noklusējums: qr_pass_issuer. Ievietojiet šeit lauka nosaukumu, nevis jā vai nē. Šo atļauju lietotāja līmenī drīkst mainīt tikai pilnvarots administrators.

`qr_staff_permission_field`

qr_staff · Lietotāja jā/nē lauka nosaukums, kas norāda darbiniekus, kuri var pārbaudīt un apstiprināt lietošanu. Piemērs/noklusējums: qr_staff. Biļetes turētājam šī atļauja nav nepieciešama. Neiekļaujiet to publiskajos reģistrācijas un profila veidlapās.

Konfigurējiet vienreiz

Izveidojiet vai izvēlieties savu Bubble lietotnes projektu vietnē BestPlugins → Dashboard → Plugins.
Izvēlieties šo spraudni un nokopējiet tā projekta atslēgu.
Atveriet Bubble → Plugins → Xodera QR Passes Native; ielīmējiet atslēgu project_api_key un saglabājiet.
Pievienojiet elementu, izvēlieties savus lietotnes datus un izveidojiet zemāk redzamo darbplūsmu.
Privāta beta piekļuve tikai šobrīd. Publiskā instalācija un maksas aktivācija vēl nav atvērtas.

Instalēšana un abonements

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.

Saglabājiet rezultātu savā lietotnē

Piemērs Ienākšana vai Izņemšana: saglabājiet saistīto pasūtījumu/notikumu, pass_id, expires_at un issue_request_id. Pēc apstiprinātas lietošanas pievienojiet receipt_id, redeemed_at un darbinieku, kas apstiprināja. Neatzīmējiet ierakstu kā pabeigtu, ja kods ir tikai naskenēts vai pārbaudīts. QR kods nepārbauda personas identitāti.

Kļūda, atcelšana un atjaunošana

Ja outcome_unknown=yes, atkārtoti pārbaudot rezultātu, saglabājiet to pašu caurlaidi, request_id un ievades vērtības. Neveidojiet jaunu apstiprinājumu. already_used, expired un revoked ir galīgi biznesa procesa rezultāti. Ja atļauja ir liegta, lūdziet pilnvarotam administratoram pārskatīt darbinieka lomu. Clear session atiestata skeneri; tas nevar atcelt jau pabeigtu caurlaides izmantošanu.

Iespējas un ierobežojumi

Plānotās caurlaides ir vienreizējas; to derīguma termiņš ir 1–86400 sekundes, noklusējuma vērtība ir 900. Caurlaižu tipi: access, event, coupon un membership. Pārbaude caurlaidi nerezervē. Caurlaides izmantošanai ir vajadzīgs interneta savienojums. Nav paredzēta maksājumu apstrāde, identitātes pārbaude vai atkārtoti izmantojama ilgtermiņa dalības karte. Parastas QR vērtības nolasīšana ir atsevišķa darbība no caurlaides pārbaudes.

Iestatījumi, darbības un rezultāti

Izmantojiet šos nosaukumus Bubble. Plānotās funkcijas ir atzīmētas atsevišķi.

Pieejamie beta iestatījumi

Elementa iestatījumi

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

Stāvokļi

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

Notikumi

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Darbības un to ievades

Clear session

Elementa iestatījumi · 5

Plānots darbplūsma. Šobrīd nav pieejama pašreizējā beta versijā.

disabledyes/no · Noklusējums: false: Piemēra vērtībano; Piemērs Bubble izteiksmeiGuideHost's is_busy (your yes/no custom state); Atspējojiet elementu, kamēr jūsu lietotne ir aizņemta vai šī darbība nav pieejama.

is_activeyes/no · Noklusējums: true: Piemēra vērtībayes; Piemērs Bubble izteiksmeiGuideHost's view_is_active (your yes/no custom state); Iestatiet jā, kamēr šis skats ir atvērts. Iestatiet nē, kad iziet, lai atskaņošana vai pašreizējais darbs varētu apturēties.

ui_text_jsontext · Noklusējums: "{}": Piemēra vērtība{}; Piemērs Bubble izteiksmeiApp Settings' player_labels_json (supported keys only); Papildu JSON ar atbalstītām pogu etiķetēm. Atstājiet tukšu, lai izmantotu iebūvēto tekstu.

languagetext · Noklusējums: "auto": Piemēra vērtībauk; Piemērs Bubble izteiksmeiCurrent User's preferred_language; Iestatiet language=auto, lai sekotu atbalstītai ierīcei vai pārlūkprogrammas valodai. Ievadiet atbalstītu valodas kodu, lai to izvēlētos tieši.

workflow_modeyes/no · Noklusējums: false: Piemēra vērtībayes; Piemērs Bubble izteiksmeiApp Settings' use_qr_business_actions; Plānots: ļaut skenēto QR vērtību izmantot ar Check QR pass. Vienkārši skenēšana neapstiprina ieeju vai saņemšanu.

Darbības un to ievades · 5

Plānots darbplūsma. Šobrīd nav pieejama pašreizējā beta versijā.

Clear session

Nav darbības parametru

Issue QR pass

environmenttext · Noklusējums: "development": Piemēra vērtībadevelopment; Piemērs Bubble izteiksmeiApp Settings' selected_environment; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

request_idtext · Noklusējums: —: Piemēra vērtībapickup-123-issue-v1; Piemērs Bubble izteiksmeiCurrent Admission's stable_request_id; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

labeltext · Noklusējums: "access": Piemēra vērtībaevent; Piemērs Bubble izteiksmeiSelected Admission's pass_label; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

ttl_secondsnumber · Noklusējums: 900: Piemēra vērtība900; Piemērs Bubble izteiksmeiEvent Settings' pass_ttl_seconds; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Atgrieztās vērtības

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

Check QR pass

environmenttext · Noklusējums: "development": Piemēra vērtībadevelopment; Piemērs Bubble izteiksmeiApp Settings' selected_environment; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

pass_tokentext · Noklusējums: —: Piemēra vērtība<opaque token returned by Issue / camera scan>; Piemērs Bubble izteiksmeiQR Pass Scanner's scanned_pass_token (capture before Check); Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Atgrieztās vērtības

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Noklusējums: "development": Piemēra vērtībadevelopment; Piemērs Bubble izteiksmeiApp Settings' selected_environment; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

pass_tokentext · Noklusējums: —: Piemēra vērtība<opaque token returned by Issue / camera scan>; Piemērs Bubble izteiksmeiQR Pass Scanner's scanned_pass_token (capture before Check); Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

request_idtext · Noklusējums: —: Piemēra vērtībapickup-123-redeem-v1; Piemērs Bubble izteiksmeiCurrent Admission's stable_redemption_request_id; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

confirmyes/no · Noklusējums: false: Piemēra vērtībayes — explicit confirmation only; Piemērs Bubble izteiksmeiConfirm Checkbox is checked; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Atgrieztās vērtības

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

Revoke QR pass

environmenttext · Noklusējums: "development": Piemēra vērtībadevelopment; Piemērs Bubble izteiksmeiApp Settings' selected_environment; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

pass_idtext · Noklusējums: —: Piemēra vērtība<pass_id returned by Issue>; Piemērs Bubble izteiksmeiSelected Admission's pass_id; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Atgrieztās vērtības

pass_id · textrevoked · yes/no

Stāvokļi un notikumi

Plānots darbplūsma. Šobrīd nav pieejama pašreizējā beta versijā.

Stāvokļi

scanner_status · text

Pašreizējais šīs darbības rezultāts. Izmantojiet atbilstošo pabeigšanas notikumu pirms saglabāšanas panākuma. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Pašreizējais šīs darbības rezultāts. Izmantojiet atbilstošo pabeigšanas notikumu pirms saglabāšanas panākuma. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifikators šim vienumam vai darbībai. Saglabājiet to kopā ar atbilstošu lietotnes ierakstu. Izmantojiet to pašu pieprasījuma identifikatoru, atkārtotot nenoteiktu rezultātu.

pass_label · text

Pašreizējā vērtība izvēlētajam vienumam. Nolasiet to pēc saistītā notikuma. empty,access,event,coupon,membership

receipt_id · text

Identifikators šim vienumam vai darbībai. Saglabājiet to kopā ar atbilstošu lietotnes ierakstu. Izmantojiet to pašu pieprasījuma identifikatoru, atkārtotot nenoteiktu rezultātu.

error_code · text

Kļūdas informācija par pēdējo darbību. Rādiet noderīgu ziņojumu un piedāvājiet atbilstošu atkārtotu mēģinājumu.

is_busy · yes/no

Darbs joprojām notiek. Pagaidiet, pirms uzsākt citu darbību.

is_scanning · yes/no

Pašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.

torch_enabled · yes/no

Pašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.

scan_source · text

Pašreizējā vērtība izvēlētajam vienumam. Nolasiet to pēc saistītā notikuma. empty,camera,fixture

pending_redemption · yes/no

Pašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.

scanned_pass_token · text

Pašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.