QR skänneri liides. Ühekordsete pääsmete toimingud on planeeritud.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Loo ühekordsed piletid, kättesaamise kinnitused või kupongid. Töötajad skaneerivad koodi, kontrollivad tulemust, eelvaatavad tellimust ja kinnitavad kasutamise alles siis, kui valmis.

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.

Loo töövoog ↓Plugina sätted ↗Native Lab

Dokumentatsioon üle vaadatud 6 novembris 2026

Praktilised näited

Ühekordne sissepääs samapäevasele sündmusele

Tavalise QR väärtuse ekraanipilt võib muidu olla kasutatud rohkem kui ühes sissepääsus.

Rakendus salvestab Admission kirje ja väljastamistaotluse stabiilse `request_id`; kasuta etteantud `label=event` väärtust ning `ttl_seconds` väärtust vahemikus 1–86400 sekundit.

Volitatud väljastaja käivitab Issue QR pass ja edastab privaatselt tagastatud QR. Personal skaneerib → Check QR pass → kinnitab ainult kui `ok=yes` ja `status=available` → Confirm QR redemption koos salvestatud stabiilse päringu ID-ga.

Ainult `status=redeemed` koos `receipt_id` väärtusega lubab rakendusel väljastada sissepääsu kinnituskviitungi. Salvesta pääsme ja kviitungi viide Admission kirjele; ära edasta QR-koodi sisu analüütikasse.

`outcome_unknown` korral taasta sama päringu tulemus sama kasutaja, keskkonna ja pääsmega; ära kunagi loo uut kinnituse ID-d. Käsitle expired, revoked ja juba kasutatud olekuid eraldi tulemustena.

Kavandatud. Skannimine ja kontrollimine ei märgi pääset kasutatuks; seda teeb ainult selgesõnaline kinnitamine.

Lunasta lühiajaline hüve üks kord partneri teenindusletis

Partner vajab kinnitatud kasutatud/kasutamata tulemust, mitte QR pildi või ekraanianimatsiooni usaldamist.

`label=coupon`; rakenduse Benefit kirje määrab sobivuse ja lühikese kehtivusakna enne volitatud väljastamistoimingut.

Väljasta pääse alles pärast seda, kui rakendus on kontrollinud õigust hüve saada. Teenindusletis näitab Check QR pass saadavust pääset kasutatuks märkimata. Pärast seda, kui töötaja kinnitab hüve üleandmise, käivita Confirm QR redemption.

Benefit kirje võib salvestada `receipt_id` ja pääsme kinnitatud kasutamise aja pärast `status=redeemed`. Plugin haldab pääsme olekut; sinu rakendus haldab hüve ja kliendisuhet.

Kui hüve tühistatakse enne kasutamist, saab sama volitatud väljastaja käivitada Revoke QR pass selle pääsme `pass_id` väärtusega. Ära teata tagasimaksest ega edukast lunastamisest ainult `ok=yes` põhjal.

Kavandatud. Skannimine ja kontrollimine ei märgi pääset kasutatuks; seda teeb ainult selgesõnaline kinnitamine.

Kinnitage samapäevane seadme või tellimuse väljavõtmine

Töötaja töövoog peab eristama kauba kättesaamise viite skannimist tegelikust kauba üleandmisest.

Rakendusele kuuluv Collection kirje säilitab kauba kättesaamise õiguse, ettenähtud eseme ning eraldi stabiilsed väljastamise ja lunastamise päringu-ID-d; kasuta lühiajalist `label=access` pääset.

Kui rakendus on kauba kättesaamise lubanud, käivita Issue QR pass. Töötajad skannivad ja kasutavad Check toimingut, vaatavad rakenduses üle vastava Collection kirje ning kinnitavad seejärel selgesõnaliselt üleandmise ja käivitavad Confirm QR redemption.

Töövoog tohib märkida Collection kirje üleantuks alles pärast kinnitatud `redeemed` kviitungit. Säilita `receipt_id` viitena pääsme kasutamise tulemusele.

Korduv skaneerimine võib tagastada already_used; kuvage olemasolev rakenduse kirje, mitte andke üle teist eset. Taastage ebakindel kinnituse sama ID ja sisenditega.

Kavandatud. Skannimine ja kontrollimine ei märgi pääset kasutatuks; seda teeb ainult selgesõnaline kinnitamine.

Mis töötab praegu

Privaatne beetaversioon. Praegusel skänneril on kaamera- ja õiguste kontrollid. Ühekordsete pääsmete loomine, kontrollimine ja kinnitamine on plaanis ning pole teie rakenduses veel kasutamiseks valmis.

Loo töövoog

Planeeritud

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

Need näited kasutavad rakenduse kirjeid, nagu Lesson, Message ja Order. Asenda need oma andmetüüpide ja elementide nimedega. Näidismeedia aadresse tuleb asendada oma failidega.

Kavandatud: volitatud töötaja kasutab Issue QR pass toimingut Admission või Order kirje jaoks. Näide: label=event, ttl_seconds=900, environment=development. Säilita selle väljastamistaotluse jaoks stabiilne request_id ja salvesta pass_id koos kirjega.
Näita tagastatud QR-koodi isikule, kellele pääse on mõeldud. Töötajad skannivad seda. Kavandatud pääsme töövoos kasuta workflow_mode=yes ja loe scanned_pass_token pärast pass_scanned. Need pääsme töövoo seaded ei ole praeguses skänneris saadaval.
Käivita Check QR pass sisendiga pass_token = QR Scanner's scanned_pass_token. See kontrollib pääset seda kasutatuks märkimata. Kui status=available, näita vastava tellimuse või sissepääsu üksikasju, et töötajad saaksid need üle vaadata.
Ainult eraldi Confirm nupp käivitab Confirm QR redemption sama pass_token, stabiilse request_id ja confirm=yes väärtusega. Kui status=redeemed, salvesta receipt_id ja märgi vastav tellimus või sissepääs lõpetatuks.
already_used, expired, revoked või invalid tähendab, et ei tohi lubada sissepääsu ega tellimust üle anda. Ainuüksi skannimine või edukas Check ei lõpeta kunagi tehingut.

Töövoodiagramm — mitte rakenduse ekraanipilt

Seadista üks kord

Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins. Vali Xodera QR Passes Native, kopeeri selle võti, seejärel ava Bubble → Plugins → Xodera QR Passes Native ja kleebi see project_api_key. Salvesta üks kord; seejärel kasuta allolevaid tegevusi. Igal pistikprogrammil igas projektis on oma võti.

Skaneerimine nõuab kaamera luba. Ühekordsete piletite puhul otsusta, kes võivad pileteid luua ja kes võivad neid ukse või kättesaamise punktis kontrollida. Tavakliendid ei vaja ühtegi töötaja rolli.

`qr_issuer_permission_field`

qr_pass_issuer · User tüübi yes/no välja nimi, mis määrab, millised töötajad tohivad pääsmeid luua või tühistada. Näide/vaikeväärtus: qr_pass_issuer. Sisesta siia välja nimi, mitte yes ega no. Seda kasutaja õigust tohiks muuta ainult volitatud administraator.

`qr_staff_permission_field`

qr_staff · User tüübi yes/no välja nimi, mis määrab, millised töötajad tohivad pääsmeid kontrollida ja kasutamist kinnitada. Näide/vaikeväärtus: qr_staff. Pääsme omanik ei vaja seda õigust. Ära lisa seda avalikele registreerimis- ega profiilivormidele.

Seadista üks kord

Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins.
Vali see pistikprogramm ja kopeeri selle projekti võti.
Ava Bubble → Plugins → Xodera QR Passes Native; kleebi võti project_api_key ja salvesta.
Lisa element, vali oma rakenduse andmed ja loo allpool toodud töövoog.
Praegu ainult privaatne beetakättesaadavus. Avalik paigaldamine ja tasuline aktiveerimine ei ole veel avatud.

Paigaldus ja tellimus

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.

Salvesta tulemus oma rakendusse

Näide Admission või Pickup: salvesta seotud tellimus või sündmus, pass_id, expires_at ja issue_request_id. Pärast kinnitatud kasutamist lisa receipt_id, redeemed_at ning kinnitanud töötaja. Ära märgi kirjet lõpetatuks ainult koodi skannimise või kontrollimise järel. QR-kood ei kinnita inimese identiteeti.

Tõrge, tühistamine ja taastamine

Kui outcome_unknown=yes, säilita tulemuse uuesti kontrollimisel sama pääse, request_id ja sisendid. Ära loo uut kinnitust. already_used, expired ja revoked on lõplikud äritulemused. Õiguste puudumisel palu volitatud administraatoril töötaja roll üle vaadata. Clear session lähtestab skänneri ega saa juba lõpetatud kasutamist tagasi võtta.

Võimekused ja piirangud

Kavandatud pääsmed on ühekordsed ja kehtivad 1–86400 sekundit; vaikeväärtus on 900. Pääsme tüübid: access, event, coupon ja membership. Kontrollimine ei broneeri pääset. Pääsme kasutamiseks on vaja internetiühendust. Puuduvad maksete töötlemine, isikusamasuse kontroll ja korduskasutatav pikaajaline liikmekaart. Tavalise QR-väärtuse lugemine ja pääsme kontrollimine on eraldi toimingud.

Seaded, toimingud ja tulemused

Kasuta neid nimesid Bubble-s. Planeeritud funktsioonid on märgitud eraldi.

Saadaolevad beetaversiooni seaded

Elemendi seaded

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

Olekud

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

Sündmused

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Toimingud ja nende sisendid

Clear session

Elemendi seaded · 5

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

disabledyes/no · Vaikimisi: false: Näidisväärtusno; Bubble avaldise näideGuideHost's is_busy (your yes/no custom state); Keela element, kui teie rakendus on hõivatud või see toiming pole saadaval.

is_activeyes/no · Vaikimisi: true: Näidisväärtusyes; Bubble avaldise näideGuideHost's view_is_active (your yes/no custom state); Määra yes, kui see vaade on avatud. Vaate sulgemisel määra no, et taasesitus või pooleliolev töö saaks peatuda.

ui_text_jsontext · Vaikimisi: "{}": Näidisväärtus{}; Bubble avaldise näideApp Settings' player_labels_json (supported keys only); Valikuline JSON toetatud nuppude siltidega. Jäta tühjaks, et kasutada sisseehitatud teksti.

languagetext · Vaikimisi: "auto": Näidisväärtusuk; Bubble avaldise näideCurrent User's preferred_language; Määra language=auto, et kasutada seadme või brauseri keelt, kui see keel on toetatud. Kindla keele valimiseks sisesta toetatud keelekood.

workflow_modeyes/no · Vaikimisi: false: Näidisväärtusyes; Bubble avaldise näideApp Settings' use_qr_business_actions; Kavandatud: luba kasutada skannitud QR-väärtust Check QR pass sisendina. Ainuüksi skannimine ei kinnita sissepääsu ega kauba kättesaamist.

Toimingud ja nende sisendid · 5

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

Clear session

Ei ole toimingu parameetreid

Issue QR pass

environmenttext · Vaikimisi: "development": Näidisväärtusdevelopment; Bubble avaldise näideApp Settings' selected_environment; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

request_idtext · Vaikimisi: —: Näidisväärtuspickup-123-issue-v1; Bubble avaldise näideCurrent Admission's stable_request_id; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

labeltext · Vaikimisi: "access": Näidisväärtusevent; Bubble avaldise näideSelected Admission's pass_label; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

ttl_secondsnumber · Vaikimisi: 900: Näidisväärtus900; Bubble avaldise näideEvent Settings' pass_ttl_seconds; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

Tagastatavad väärtused

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

Check QR pass

environmenttext · Vaikimisi: "development": Näidisväärtusdevelopment; Bubble avaldise näideApp Settings' selected_environment; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

pass_tokentext · Vaikimisi: —: Näidisväärtus<opaque token returned by Issue / camera scan>; Bubble avaldise näideQR Pass Scanner's scanned_pass_token (capture before Check); Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

Tagastatavad väärtused

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Vaikimisi: "development": Näidisväärtusdevelopment; Bubble avaldise näideApp Settings' selected_environment; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

pass_tokentext · Vaikimisi: —: Näidisväärtus<opaque token returned by Issue / camera scan>; Bubble avaldise näideQR Pass Scanner's scanned_pass_token (capture before Check); Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

request_idtext · Vaikimisi: —: Näidisväärtuspickup-123-redeem-v1; Bubble avaldise näideCurrent Admission's stable_redemption_request_id; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

confirmyes/no · Vaikimisi: false: Näidisväärtusyes — explicit confirmation only; Bubble avaldise näideConfirm Checkbox is checked; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

Tagastatavad väärtused

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

Revoke QR pass

environmenttext · Vaikimisi: "development": Näidisväärtusdevelopment; Bubble avaldise näideApp Settings' selected_environment; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

pass_idtext · Vaikimisi: —: Näidisväärtus<pass_id returned by Issue>; Bubble avaldise näideSelected Admission's pass_id; Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

Tagastatavad väärtused

pass_id · textrevoked · yes/no

Olekud ja sündmused

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

Olekud

scanner_status · text

Selle toimingu praegune tulemus. Kasutage sobivat lõpetamise sündmust enne edu salvestamist. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Selle toimingu praegune tulemus. Kasutage sobivat lõpetamise sündmust enne edu salvestamist. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Selle üksuse või tegevuse identifikaator. Säilita see vastava rakenduse kirje juures. Kasuta sama päringu identifikaatorit ebakindla tulemuse kordamisel.

pass_label · text

Valitud üksuse praegune väärtus. Loe see pärast seotud sündmust. empty,access,event,coupon,membership

receipt_id · text

Selle üksuse või tegevuse identifikaator. Säilita see vastava rakenduse kirje juures. Kasuta sama päringu identifikaatorit ebakindla tulemuse kordamisel.

error_code · text

Vea teave viimase toimingu kohta. Kuva abistav sõnum ja paku asjakohast kordamist.

is_busy · yes/no

Töö on endiselt pooleli. Oota enne järgmise toimingu alustamist.

is_scanning · yes/no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

torch_enabled · yes/no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

scan_source · text

Valitud üksuse praegune väärtus. Loe see pärast seotud sündmust. empty,camera,fixture

pending_redemption · yes/no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

scanned_pass_token · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.