QR skener interfejs. Planirane su jednokratne akcije prolaza.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Izradite jednorazne karte, potvrde preuzimanja ili kupone. Osoblje skenira kod, proverava rezultat, pregledava porudžbinu i potvrđuje upotrebu 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.

Izgradite radni tok ↓Podešavanja dodatka ↗Native Lab

Dokumentacija pregledana 6 novembar 2026

Praktični primeri

Jednokratna ulaznica za događaj istog dana

Snimak ekrana obične QR vrednosti može se, u suprotnom, ponovo upotrebiti na više od jednog ulaza.

Vaša aplikacija čuva zapis o prijemu i stabilni izdavanje `request_id`; koristite kurirani `label=event` i `ttl_seconds` u okviru 1–86400 sekundi ugovora.

Ovlašćeni izdavač pokreće Issue QR pass i privatno isporučuje vraćeni QR. Osoblje skenira → Check QR pass → potvrđuje samo ako `ok=yes` i `status=available` → Confirm QR redemption uz sačuvani stabilni ID zahteva.

Samo `status=redeemed` plus `receipt_id` autorizuju priznanicu prijema vaše aplikacije. Sačuvajte referencu na propusnicu/priznanicu u zapisu o prijemu; ne otkrivajte sadržaj QR analitici.

Za `outcome_unknown` povratite isti zahtev sa identičnim korisnikom/okruženjem/propusnicom; nikada ne generišite novi ID potvrde. Obradite expired, revoked i već korišćena stanja kao odvojene ishode.

Planirano. Skeniranje i provera ne koriste propusnicu; koristi je samo eksplicitna potvrda.

Iskoristite kratkotrajnu pogodnost jednokratno na šalteru partnera

Partneru je potreban potvrđen rezultat korišćenja/neupotrebe umesto da veruje slici QR ili animaciji na ekranu.

`label=coupon`; zapis o pogodnosti aplikacije definiše podobnost i kratko vremensko okno važenja pre ovlašćenog izdavanja.

Izdajte propusnicu tek nakon provere 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 čuvati `receipt_id` i potvrđeno vreme iskorišćenja nakon `status=redeemed`. Plugin upravlja stanjem propusnice; vaša aplikacija upravlja pogodnošću i odnosom sa kupcem.

Ako se pogodnost otkaže pre upotrebe, isti ovlašćeni izdavač može Revoke QR pass koristeći svoj `pass_id`. Ne najavljujte povraćaj novca ili uspešno iskorišćenje samo na osnovu `ok=yes`.

Planirano. Skeniranje i provera ne koriste propusnicu; koristi je samo eksplicitna potvrda.

Potvrdite preuzimanje opreme ili porudžbine istog dana

Radni tok osoblja mora da razlikuje skeniranje reference za preuzimanje od stvarnog predavanja predmeta.

Zapis o kolekciji u vlasništvu vaše aplikacije čuva autorizaciju, predviđeni predmet i odvojene stabilne ID‑je zahteva za izdavanje/iskorišćenje; koristite kratkotrajnu `label=access` propusnicu.

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

Tek nakon potvrđene `redeemed` priznanice vaš radni tok treba da postavi kolekciju na predatu. Zadržite `receipt_id` kao vezu ka ishodu propusnice.

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

Planirano. Skeniranje i provera ne koriste propusnicu; koristi je samo eksplicitna potvrda.

Šta trenutno funkcioniše

Privatna beta. Trenutni skener ima kontrolu kamere i dozvola. Kreiranje, provera i potvrđivanje jednoraznih propusnica je planirano i još nije spremno za upotrebu u vašoj aplikaciji.

Izgradite radni tok

Planirano

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

Ovi primeri koriste zapise aplikacije kao što su Lesson, Message i Order. Zamenite ih svojim tipovima podataka i imenima elemenata. Primer adresa medija mora biti zamenjen vašim fajlovima.

Planirano: ovlašćeni zaposleni koristi Issue QR pass za ulaz ili Order. Primer: label=event, ttl_seconds=900, environment=development. Zadržite stabilan request_id za to izdavanje propusnice i sačuvajte pass_id uz zapis.
Prikažite vraćeni QR njegovom namenjenom vlasniku. Osoblje ga skenira. U planiranom radnom toku propusnice, koristite workflow_mode=yes i pročitajte scanned_pass_token nakon pass_scanned. Ova podešavanja radnog toka propusnice nisu dostupna u trenutnom skeneru.
Pokrenite Check QR pass sa pass_token = QR Scanner's scanned_pass_token. Proverava bez korišćenja propusnice. Za status=available, prikažite odgovarajuće detalje narudžbine ili unosa kako bi osoblje moglo da ih pregleda.
Samo poseban dugme Potvrdi pokreće Confirm QR redemption sa istim pass_token, stabilnim request_id i confirm=yes. Na status=redeemed, sačuvajte receipt_id i označite da je ta narudžbina ili unos završen.
already_used, expired, revoked ili invalid znače da ne smete dozvoliti ulazak niti predati narudžbinu. Samo skeniranje ili uspešna provera ne dovode do završetka transakcije.

Dijagram radnog toka — nije snimak ekrana aplikacije

Konfigurišite jednom

Kreirajte ili izaberite vaš Bubble projekat aplikacije u BestPlugins → Dashboard → Plugins. Izaberite Xodera QR Passes Native, kopirajte njegov ključ, zatim otvorite Bubble → Plugins → Xodera QR Passes Native i nalepite ga u project_api_key. Sačuvajte jednom; zatim koristite akcije ispod. Svaki dodatak u svakom projektu ima svoj ključ.

Skeniranje zahteva dozvolu za kameru. Za jednokratne propusnice, odlučite ko može da kreira propusnice i ko može da ih proverava na ulazu ili mestu preuzimanja. Obični kupci ne trebaju ni jednu ulogu osoblja.

`qr_issuer_permission_field`

qr_pass_issuer · Naziv polja korisnika da/ne koje označava zaposlene kojima je dozvoljeno da kreiraju ili opozovu propusnice. Primer/podrazumevano: qr_pass_issuer. Ovde unesite naziv polja, a ne da ili ne. Samo ovlašćeni administrator treba da menja to ovlašćenje za korisnika.

`qr_staff_permission_field`

qr_staff · Naziv polja korisnika da/ne koje označava osoblje kojem je dozvoljeno da proveri i potvrdi upotrebu. Primer/podrazumevano: qr_staff. Vlasniku karte nije potrebno ovo ovlašćenje. Držite ga van javnih obrazaca za registraciju i profil.

Konfigurišite jednom

Kreirajte ili izaberite vaš Bubble projekat aplikacije na BestPlugins → Dashboard → Plugins.
Izaberite ovaj dodatak i kopirajte njegov ključ projekta.
Otvorite Bubble → Plugins → Xodera QR Passes Native; nalepite ključ u project_api_key i sačuvajte.
Dodajte element, izaberite vaše podatke aplikacije i izgradite tok rada ispod.
Privatan 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.

Sačuvajte rezultat u vašoj aplikaciji

Primer ulaza ili preuzimanja: sačuvajte povezanu narudžbinu/događaj, pass_id, expires_at i issue_request_id. Nakon potvrđene upotrebe, dodajte receipt_id, redeemed_at i zaposlenog koji je potvrdio. Nemojte označiti zapis kao završen kada je kod samo skeniran ili proveravan. QR kod ne potvrđuje identitet osobe.

Neuspeh, otkazivanje i oporavak

Ako je outcome_unknown=yes, zadržite istu propusnicu, request_id i unose prilikom ponovnog proveravanja rezultata. Nemojte kreirati novu potvrdu. already_used, expired i revoked su konačni poslovni rezultati. Ako je dozvola odbijena, zatražite od ovlašćenog administratora da pregleda ulogu zaposlenog. Clear session resetuje skener; ne može poništiti završenu upotrebu.

Mogućnosti i ograničenja

Planirane propusnice su jednokratne, sa trajanjem od 1–86400 sekundi; podrazumevano 900. Tipovi propusnica: access, event, coupon i membership. Provera ne rezerviše propusnicu. Potreban je pristup internetu za korišćenje propusnice. Nema obrade plaćanja, provere identiteta niti ponovnog korišćenja dugoročnog članskog kartice. Čitanje obične QR vrednosti je odvojeno od provere propusnice.

Podešavanja, akcije i rezultati

Koristite ova imena u Bubble. Planirane funkcije su označene odvojeno.

Dostupna beta podešavanja

Podešavanja 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

Akcije i njihovi ulazi

Clear session

Podešavanja elementa · 5

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

disabledyes/no · Podrazumevano: false: Primer vrednostino; Primer Bubble izrazaGuideHost's is_busy (your yes/no custom state); Онемогућите елемент док је ваша апликација заузета или док је ова радња недоступна.

is_activeyes/no · Podrazumevano: true: Primer vrednostiyes; Primer Bubble izrazaGuideHost's view_is_active (your yes/no custom state); Поставите „да“ док је овај преглед отворен. Поставите „не“ приликом напуштања, како би репродукција или тренутни рад могли да се зауставе.

ui_text_jsontext · Podrazumevano: "{}": Primer vrednosti{}; Primer Bubble izrazaApp Settings' player_labels_json (supported keys only); Опционални JSON са подржаним ознакама дугмади. Оставите празно да се користи уграђени текст.

languagetext · Podrazumevano: "auto": Primer vrednostiuk; Primer Bubble izrazaCurrent User's preferred_language; Поставите language=auto да прати подржани уређај или језик прегледача. Унесите подржани код језика да бисте га изричито изабрали.

workflow_modeyes/no · Podrazumevano: false: Primer vrednostiyes; Primer Bubble izrazaApp Settings' use_qr_business_actions; Planned: omogućiti da skenirana vrednost QR bude korišćena od strane Check QR pass. Samo skeniranje ne potvrđuje ulazak ili preuzimanje.

Akcije i njihovi ulazi · 5

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

Clear session

Nema parametara akcije

Issue QR pass

environmenttext · Podrazumevano: "development": Primer vrednostidevelopment; Primer Bubble izrazaApp Settings' selected_environment; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

request_idtext · Podrazumevano: —: Primer vrednostipickup-123-issue-v1; Primer Bubble izrazaCurrent Admission's stable_request_id; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

labeltext · Podrazumevano: "access": Primer vrednostievent; Primer Bubble izrazaSelected Admission's pass_label; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

ttl_secondsnumber · Podrazumevano: 900: Primer vrednosti900; Primer Bubble izrazaEvent Settings' pass_ttl_seconds; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

Povrati

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

Check QR pass

environmenttext · Podrazumevano: "development": Primer vrednostidevelopment; Primer Bubble izrazaApp Settings' selected_environment; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

pass_tokentext · Podrazumevano: —: Primer vrednosti<opaque token returned by Issue / camera scan>; Primer Bubble izrazaQR Pass Scanner's scanned_pass_token (capture before Check); Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

Povrati

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Podrazumevano: "development": Primer vrednostidevelopment; Primer Bubble izrazaApp Settings' selected_environment; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

pass_tokentext · Podrazumevano: —: Primer vrednosti<opaque token returned by Issue / camera scan>; Primer Bubble izrazaQR Pass Scanner's scanned_pass_token (capture before Check); Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

request_idtext · Podrazumevano: —: Primer vrednostipickup-123-redeem-v1; Primer Bubble izrazaCurrent Admission's stable_redemption_request_id; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

confirmyes/no · Podrazumevano: false: Primer vrednostiyes — explicit confirmation only; Primer Bubble izrazaConfirm Checkbox is checked; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

Povrati

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

Revoke QR pass

environmenttext · Podrazumevano: "development": Primer vrednostidevelopment; Primer Bubble izrazaApp Settings' selected_environment; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

pass_idtext · Podrazumevano: —: Primer vrednosti<pass_id returned by Issue>; Primer Bubble izrazaSelected Admission's pass_id; Користите вредност тренутног пословног записа; проверите је у односу на доње границе.

Povrati

pass_id · textrevoked · yes/no

Stanja i događaji

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

Stanja

scanner_status · text

Trenutni rezultat ove akcije. Koristite odgovarajući događaj završetka pre nego što sačuvate uspeh. 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 akcije. Koristite odgovarajući događaj završetka pre nego što sačuvate uspeh. empty,available,redeemed,already_used,expired,revoked

pass_id · text

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

pass_label · text

Trenutna vrednost za izabranu stavku. Pročitajte je nakon povezanog događaja. empty,access,event,coupon,membership

receipt_id · text

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

error_code · text

Информације о грешци за последњу радњу. Прикажите корисну поруку и понудите релевантно поновно покушавање.

is_busy · yes/no

Rad je još u toku. Sačekajte pre nego što započnete drugu radnju.

is_scanning · yes/no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

torch_enabled · yes/no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

scan_source · text

Trenutna vrednost za izabranu stavku. Pročitajte je nakon povezanog događaja. empty,camera,fixture

pending_redemption · yes/no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

scanned_pass_token · text

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.