QR skener sučelje. Planirane su jednokratne akcije prolaza.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Izradite jednokratne ulaznice, potvrde preuzimanja ili kupone. Osoblje skenira kod, provjerava rezultat, pregledava narudžbu i potvrđuje korištenje tek kada je spremno.

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.

Izradite radni tok ↓Postavke dodatka ↗Native Lab

Dokumentacija pregledana 6 studeni 2026

Praktični primjeri

Jednokratni ulaz za događaj istog dana

Snimka zaslona obične QR vrijednosti može se inače ponovno upotrijebiti na više od jednog ulaza.

Vaša aplikacija pohranjuje zapis o prijemu i stabilni izdani `request_id`; koristite uređeni `label=event` i `ttl_seconds` unutar 1–86400‑sekundnog ugovora.

Ovlašteni izdavatelj pokreće Issue QR pass i privatno isporučuje vraćeni QR. Osoblje skenira → Check QR pass → potvrđuje samo ako su `ok=yes` i `status=available` → Confirm QR redemption s pohranjenim stabilnim ID‑jem zahtjeva.

Samo `status=redeemed` plus `receipt_id` ovjeravaju zapis o prijemu vaše aplikacije. Pohranite referencu na propusnicu/račun u zapis o prijemu; ne otkrivajte sadržaj QR analitici.

Za `outcome_unknown`, povratite isti zahtjev s identičnim korisnikom/okruženjem/propusnicom; nikada ne generirajte novi ID potvrde. Obradite expired, revoked i već korištene stanje kao odvojene ishode.

Planirano. Skeniranje i provjera ne koriste propusnicu; samo izričita potvrda to čini.

Iskoristite kratkotrajnu pogodnost jednom na šalteru partnera

Partner treba potvrđen rezultat korištenja/neupotrebe umjesto da se oslanja na sliku QR ili animaciju na zaslonu.

`label=coupon`; zapis o pogodnosti aplikacije definira podobnost i kratko razdoblje valjanosti prije ovlaštene radnje izdavanja.

Izdajte propusnicu tek nakon provjere podobnosti vaše aplikacije. Na šalteru, Check QR pass prikazuje dostupnost bez potrošnje. Nakon što član osoblja potvrdi isporuku pogodnosti, pokrenite Confirm QR redemption.

Vaš zapis o pogodnosti može pohraniti `receipt_id` i potvrđeno vrijeme iskorištenja nakon `status=redeemed`. Dodatak upravlja stanjem propusnice; vaša aplikacija upravlja pogodnošću i odnosom s kupcem.

Ako se pogodnost otkaže prije upotrebe, isti ovlašteni izdavatelj može Revoke QR pass koristeći svoj `pass_id`. Ne objavljujte povrat novca ili uspješno iskorištenje samo na temelju `ok=yes`.

Planirano. Skeniranje i provjera ne koriste propusnicu; samo izričita potvrda to čini.

Potvrdite preuzimanje opreme ili narudžbe isti dan

Radni tok osoblja mora razlikovati skeniranje reference preuzimanja od stvarnog predavanja predmeta.

Zapis o vlasničkoj kolekciji vaše aplikacije čuva ovlaštenje, namijenjeni predmet i odvojene stabilne ID‑je zahtjeva za izdavanje/iskorištenje; koristite kratkotrajnu `label=access` propusnicu.

Nakon što vaša aplikacija odobri preuzimanje, Issue QR pass. Osoblje skenira i provjerava, pregledava odgovarajuću kolekciju u vašoj aplikaciji, zatim izričito potvrđuje predaju i Confirm QR redemption.

Tek nakon potvrđenog `redeemed` računa vaš radni tok treba postaviti kolekciju na predano. Zadržite `receipt_id` kao poveznicu na ishod propusnice.

Ponovljeno skeniranje može vratiti already_used; prikažite postojeći zapis aplikacije umjesto da predajete drugi predmet. Povratite neizvjesnu potvrdu s istim ID‑jem i unosima.

Planirano. Skeniranje i provjera ne koriste propusnicu; samo izričita potvrda to čini.

Što trenutno funkcionira

Privatna beta. Trenutni skener ima kontrolu kamere i dozvola. Izrada, provjera i potvrda jednokratnih propusnica je planirana i još nije spremna za upotrebu u vašoj aplikaciji.

Izradite radni tok

Planirano

Planirani tijek rada. Još nije dostupan u trenutnoj beta verziji.

Ovi primjeri koriste zapise aplikacije poput Lesson, Message i Order. Zamijenite ih vlastitim tipovima podataka i nazivima elemenata. Primjer adresa medija mora biti zamijenjen vašim vlastitim datotekama.

Planirano: ovlašteni zaposlenik koristi Issue QR pass za ulaz ili Order. Primjer: label=event, ttl_seconds=900, environment=development. Zadržite stabilni request_id za taj izdavanje i spremite pass_id uz zapis.
Prikažite vraćeni QR njegovom namijenjenom vlasniku. Osoblje ga skenira. U planiranom tijeku propusnice koristite workflow_mode=yes i pročitajte scanned_pass_token nakon pass_scanned. Ove postavke tijeka propusnice nisu dostupne u trenutnom skeneru.
Pokrenite Check QR pass s pass_token = QR Scanner's scanned_pass_token. Provjerava bez korištenja propusnice. Za status=available prikažite odgovarajuće detalje narudžbe ili unosa kako bi osoblje moglo pregledati.
Samo zasebno dugme Potvrdi pokreće Confirm QR redemption s istim pass_token, stabilnim request_id i confirm=yes. Na status=redeemed spremite receipt_id i označite tu narudžbu ili unos kao dovršenu.
already_used, expired, revoked ili invalid znače da se ne smije dopustiti ulaz niti predati narudžba. Samo skeniranje ili uspješna provjera ne dovršavaju transakciju.

Dijagram radnog toka — nije snimka aplikacije

Postavite jednom

Stvorite ili odaberite svoj Bubble projekt aplikacije u BestPlugins → Dashboard → Plugins. Odaberite Xodera QR Passes Native, kopirajte njegov ključ, zatim otvorite Bubble → Plugins → Xodera QR Passes Native i zalijepite ga u project_api_key. Spremite jednom; zatim koristite radnje ispod. Svaki dodatak u svakom projektu ima svoj ključ.

Skeniranje zahtijeva dopuštenje za kameru. Za jednokratne propusnice odlučite tko smije stvarati propusnice i tko ih smije provjeravati na vratima ili mjestu preuzimanja. Obični kupci ne trebaju niti ulogu osoblja.

`qr_issuer_permission_field`

qr_pass_issuer · Naziv korisničkog da/ne polja koje označava zaposlenike kojima je dopušteno stvarati ili opozivati propusnice. Primjer/zadano: qr_pass_issuer. Ovdje unesite naziv polja, a ne da ili ne. Samo ovlašteni administrator smije promijeniti to dopuštenje za korisnika.

`qr_staff_permission_field`

qr_staff · Naziv korisničkog da/ne polja koje označava osoblje kojem je dopušteno provjeriti i potvrditi korištenje. Primjer/zadano: qr_staff. Vlasnik karte ne treba ovo dopuštenje. Držite ga izvan javnih obrazaca za registraciju i profile.

Postavite jednom

Stvorite ili odaberite svoj Bubble projekt aplikacije na BestPlugins → Dashboard → Plugins.
Odaberite ovaj dodatak i kopirajte njegov ključ projekta.
Otvorite Bubble → Plugins → Xodera QR Passes Native; zalijepite ključ u project_api_key i spremite.
Dodajte element, odaberite svoje podatke aplikacije i izradite radni tok ispod.
Privatni beta pristup je trenutno jedini. Javna instalacija i plaćena aktivacija još nisu otvorene.

Instalacija i pretplata

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.

Spremite rezultat u svoju aplikaciju

Primjer ulaza ili preuzimanja: spremite povezanu narudžbu/događaj, pass_id, expires_at i issue_request_id. Nakon potvrđene upotrebe, dodajte receipt_id, redeemed_at i zaposlenika koji je potvrdio. Nemojte označiti zapis kao dovršen kada je kod samo skeniran ili provjeren. QR kod ne verificira identitet osobe.

Neuspjeh, otkazivanje i oporavak

Ako je outcome_unknown=yes, zadržite istu propusnicu, request_id i unose prilikom ponovne provjere rezultata. Nemojte stvarati novu potvrdu. already_used, expired i revoked su konačni poslovni rezultati. Ako je dopuštenje odbijeno, zatražite od ovlaštenog administratora da pregleda ulogu zaposlenika. Clear session resetira skener; ne može poništiti dovršenu upotrebu.

Mogućnosti i ograničenja

Planirane propusnice su jednokratne, s trajanjem od 1–86400 sekundi; zadano 900. Vrste propusnica: access, event, coupon i membership. Provjera ne rezervira propusnicu. Potreban je pristup internetu za korištenje propusnice. Nema obrade plaćanja, provjere identiteta niti ponovne upotrebe dugoročnog članskog kartice. Čitanje obične QR vrijednosti odvojeno je od provjere propusnice.

Postavke, radnje i rezultati

Koristite ove nazive u Bubble. Planirane značajke su označene odvojeno.

Dostupna beta podešavanja

Postavke elementa

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

Stanja

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

Događaji

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Radnje i njihovi ulazi

Clear session

Postavke elementa · 5

Planirani tijek rada. Još nije dostupan u trenutnoj beta verziji.

disabledyes/no · Zadano: false: Primjer vrijednostino; Primjer Bubble izrazaGuideHost's is_busy (your yes/no custom state); Onemogućite element dok je vaša aplikacija zauzeta ili je ova radnja nedostupna.

is_activeyes/no · Zadano: true: Primjer vrijednostiyes; Primjer Bubble izrazaGuideHost's view_is_active (your yes/no custom state); Postavite da je da dok je ovaj prikaz otvoren. Postavite da je ne kada napuštate, kako bi se reprodukcija ili trenutni rad mogli zaustaviti.

ui_text_jsontext · Zadano: "{}": Primjer vrijednosti{}; Primjer Bubble izrazaApp Settings' player_labels_json (supported keys only); Opcionalni JSON s podržanim oznakama gumba. Ostavite prazno za korištenje ugrađenog teksta.

languagetext · Zadano: "auto": Primjer vrijednostiuk; Primjer Bubble izrazaCurrent User's preferred_language; Postavite language=auto da prati podržani uređaj ili jezik preglednika. Unesite podržani kod jezika za izričitu odabir.

workflow_modeyes/no · Zadano: false: Primjer vrijednostiyes; Primjer Bubble izrazaApp Settings' use_qr_business_actions; Planirano: dopustiti da se skenirana vrijednost QR koristi od strane Check QR pass. Samo skeniranje ne potvrđuje ulazak ili preuzimanje.

Radnje i njihovi ulazi · 5

Planirani tijek rada. Još nije dostupan u trenutnoj beta verziji.

Clear session

Nema parametara radnje

Issue QR pass

environmenttext · Zadano: "development": Primjer vrijednostidevelopment; Primjer Bubble izrazaApp Settings' selected_environment; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

request_idtext · Zadano: —: Primjer vrijednostipickup-123-issue-v1; Primjer Bubble izrazaCurrent Admission's stable_request_id; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

labeltext · Zadano: "access": Primjer vrijednostievent; Primjer Bubble izrazaSelected Admission's pass_label; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

ttl_secondsnumber · Zadano: 900: Primjer vrijednosti900; Primjer Bubble izrazaEvent Settings' pass_ttl_seconds; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

Povrati

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

Check QR pass

environmenttext · Zadano: "development": Primjer vrijednostidevelopment; Primjer Bubble izrazaApp Settings' selected_environment; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

pass_tokentext · Zadano: —: Primjer vrijednosti<opaque token returned by Issue / camera scan>; Primjer Bubble izrazaQR Pass Scanner's scanned_pass_token (capture before Check); Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

Povrati

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Zadano: "development": Primjer vrijednostidevelopment; Primjer Bubble izrazaApp Settings' selected_environment; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

pass_tokentext · Zadano: —: Primjer vrijednosti<opaque token returned by Issue / camera scan>; Primjer Bubble izrazaQR Pass Scanner's scanned_pass_token (capture before Check); Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

request_idtext · Zadano: —: Primjer vrijednostipickup-123-redeem-v1; Primjer Bubble izrazaCurrent Admission's stable_redemption_request_id; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

confirmyes/no · Zadano: false: Primjer vrijednostiyes — explicit confirmation only; Primjer Bubble izrazaConfirm Checkbox is checked; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

Povrati

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

Revoke QR pass

environmenttext · Zadano: "development": Primjer vrijednostidevelopment; Primjer Bubble izrazaApp Settings' selected_environment; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

pass_idtext · Zadano: —: Primjer vrijednosti<pass_id returned by Issue>; Primjer Bubble izrazaSelected Admission's pass_id; Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.

Povrati

pass_id · textrevoked · yes/no

Stanja i događaji

Planirani tijek rada. Još nije dostupan u trenutnoj beta verziji.

Stanja

scanner_status · text

Trenutni rezultat ove radnje. Upotrijebite odgovarajući događaj dovršetka prije spremanja uspjeha. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Trenutni rezultat ove radnje. Upotrijebite odgovarajući događaj dovršetka prije spremanja uspjeha. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifikator za ovu stavku ili radnju. Sačuvajte ga uz odgovarajući zapis aplikacije. Upotrijebite isti identifikator zahtjeva pri ponovnom pokušaju neizvjesnog rezultata.

pass_label · text

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezane radnje. empty,access,event,coupon,membership

receipt_id · text

Identifikator za ovu stavku ili radnju. Sačuvajte ga uz odgovarajući zapis aplikacije. Upotrijebite isti identifikator zahtjeva pri ponovnom pokušaju neizvjesnog rezultata.

error_code · text

Informacije o pogrešci za posljednju radnju. Prikažite korisnu poruku i ponudite odgovarajući pokušaj ponovo.

is_busy · yes/no

Rad je još u tijeku. Pričekajte prije pokretanja druge radnje.

is_scanning · yes/no

Trenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.

torch_enabled · yes/no

Trenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.

scan_source · text

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezane radnje. empty,camera,fixture

pending_redemption · yes/no

Trenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.

scanned_pass_token · text

Trenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.