QR skannari viðmót. Einferðispassgerðir eru áætlað.
QR skannari viðmót. Einferðispassgerðir eru áætlað.
← Allar Bubble Native-vegleiðingar

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Ger atgongumerki, uppheintingarváttanir ella avsláttarseðlar, sum kunnu nýtast eina ferð. Starvsfólk skanna kodan, kanna úrslitið, hyggja eftir bíleggingini og vátta nýtsluna bert, tá tey eru klár.

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.

Vegleiðingar eftirkannaðar 6 november 2026

Praktisk dømir

Einnýtsluatgongd til eitt tiltak sama dag

Ein skjáavbild av einum vanligum QR virði kann annars nýtast á fleiri enn einum inngangi.

Appin goymir eina Admission-skrá og eitt støðugt `request_id` fyri útgávuna; nýt tað ásetta `label=event` og eitt `ttl_seconds` innan fyri 1–86400 sekundir.

Ein útgevari við heimild koyrir Issue QR pass og sendir QR-kodan privat til móttakaran. Starvsfólk skanna → Check QR pass → vátta bert, um `ok=yes` og `status=available` → Confirm QR redemption við einum goymdum, støðugum fyrispurningar-ID.

Bert `status=redeemed` saman við `receipt_id` gevur grundarlag fyri atgonguváttanini í appini. Goym tilvísingina til merkið og váttanina í Admission-skránni; send ikki innihaldið í QR-kodanum til greiningartænastur.

Við `outcome_unknown` skalt tú endurheimta sama fyrispurning við óbroyttum brúkara, umhvørvi og QR-merki; ger ongantíð eitt nýtt váttanar-ID. Handfar expired, revoked og longu brúkt sum ymisk úrslit.

Plánerað. Skanning og eftirlit nýtir ikki passið; bert beinleiðis váttaning ger tað.

Nýt ein stuttgildan fyrimun eina ferð við avgreiðsluna hjá einum samstarvsfelaga

Ein samstarvsfelagi hevur tørv á einum váttaðum úrsliti um, hvørt merkið er brúkt ella óbrúkt, heldur enn at líta á eina QR-mynd ella eina rørslu á skíggjanum.

`label=coupon`; Benefit-skráin í appini ásetir, hvør hevur rætt til fyrimunin, og eina stutta gildistíð, áðrenn útgávan verður framd við neyðugari heimild.

Gev merkið út bert eftir, at appin hevur kannað rættin til fyrimunin. Við avgreiðsluna vísir Check QR pass, um merkið er tøkt, uttan at brúka tað. Eftir at starvsfólkið hevur váttað, at fyrimunurin er latin, koyr Confirm QR redemption.

Benefit-skráin kann goyma `receipt_id` og váttaða nýtslutíð eftir `status=redeemed`. Ískoytið umsitur støðuna hjá QR-merkinum; appin umsitur fyrimunin og kundasambandið.

Verður ein fyrimunur avlýstur áðrenn nýtslu, kann sami útgevari við heimild koyra Revoke QR pass við tess `pass_id`. Boða ikki frá endurgjaldi ella væleydnaðari nýtslu út frá `ok=yes` einsamøllum.

Plánerað. Skanning og eftirlit nýtir ikki passið; bert beinleiðis váttaning ger tað.

Vátta uppheinting av útgerð ella bílegging sama dag

Arbeiðsgongdin hjá starvsfólkinum má skilja millum at skanna eina uppheintingartilvísing og at handa ein lut út í veruleikanum.

Appurin tín eigur Collection-skrá, sum varðveitir heimild, áætlaða lut og serligar støðugar útgávu/innleysingarbøn ID-ar; nýtt eitt stuttlívt `label=access` pass.

Eftir at appin hevur givið loyvi til uppheinting, koyr Issue QR pass. Starvsfólk skanna og koyra Check, kanna samsvarandi Collection-skrá í appini og vátta síðani beinleiðis, at luturin er handaður, við Confirm QR redemption.

Bert eftir eina váttaða `redeemed`-kvittan skal arbeiðsgongdin merkja Collection sum handaða út. Varðveit `receipt_id` sum tilvísing til úrslitið fyri QR-merkið.

Ein endurtekning av skanni kann avgera already_used; víðvísa núverandi app-skrá í stað at handa eitt annað lut. Endurheimta óvissa staðfesting við sama ID og innsløgum.

Plánerað. Skanning og eftirlit nýtir ikki passið; bert beinleiðis váttaning ger tað.

Hvat virkar nú

Privat beta. Verandi skannari hevur stýringar til myndatól og loyvi. At stovna, kanna og vátta QR-merki til einnýtslu er ætlað, men enn ikki klárt til nýtslu í appini.

Bygg verkfløðina

Áætlað

Áætlað arbeiðsfløga. Enn ikki tøkt í núverandi beta.

Hesi dømi nýta skrár í appini, til dømis Lesson, Message og Order. Skift tær út við tínum egnu dátusløgum og elementnøvnum. Skift miðlaadressurnar í dømunum út við tínum egnu fílum.

  1. Ætlað: eitt starvsfólk við heimild nýtir Issue QR pass fyri eina Admission- ella Order-skrá. Dømi: label=event, ttl_seconds=900, environment=development. Varðveit eitt støðugt request_id fyri hesa útgávuna og goym pass_id saman við skránni.

  2. Vís tað afturkomna QR til tann ásetta eigaran. Starvsfólk skannar tað. Í skipaða pass-arbeiðsgongd, nýt workflow_mode=yes og les scanned_pass_token eftir pass_scanned. Hesir pass-arbeiðsgongd stillingar eru ikki tøkar í núverandi skannara.

  3. Koyr Check QR pass við pass_token = QR Scanner's scanned_pass_token. Tað kannar merkið uttan at brúka tað. Fyri status=available skalt tú vísa samsvarandi bílegging ella atgonguupplýsingar, so starvsfólk kunnu kanna tær.

  4. Bert ein serstakur váttanarknappur koyrir Confirm QR redemption við sama pass_token, einum støðugum request_id og confirm=yes. Tá status=redeemed, goym receipt_id og merk bíleggingina ella atgonguna sum fullførda.

  5. already_used, expired, revoked ella invalid merkir, at atgongd ikki skal veitast og bíleggingin ikki skal handast út. Ein skanning ella ein væleydnað Check fullførir ongantíð viðskiftagerðina einsamøll.

Arbeiðsflæðiskema — ikki app-skermavmynd

Stilla einaferð

Stovna ella vel títt Bubble appverkætlan í BestPlugins → Dashboard → Plugins. Vel Xodera QR Passes Native, avrita nøklini, og opna síðani Bubble → Plugins → Xodera QR Passes Native og lím hana inn í project_api_key. Goym einaferð; brúka síðan gerðirnar nedanfor. Hvørt ískoyti í hvørjum verkætlan hevur sín egna nøkl.

Skanning krevur loyvi til myndatólið. Fyri QR-merki til einnýtslu skalt tú avgera, hvør hevur loyvi at stovna tey, og hvør kann kanna tey við inngongdina ella uppheintingarstaðið. Vanligir kundar hava ikki tørv á nøkrum av hesum starvsfólkaheimildum.

qr_issuer_permission_field

qr_pass_issuer · Navnið á einum yes/no-felti á User, ið merkir starvsfólk við loyvi at stovna ella afturkalla QR-merki. Dømi/standard: qr_pass_issuer. Skriva feltnavnið her, ikki yes ella no. Bert ein fyrisitari við neyðugari heimild eigur at broyta hetta loyvið á einum brúkara.

qr_staff_permission_field

qr_staff · Navnið á einum yes/no-felti á User, ið merkir starvsfólk við loyvi at kanna og vátta nýtslu. Dømi/standard: qr_staff. Tann, ið hevur atgongumerkið, hevur ikki tørv á hesum loyvi. Hav tað ikki við í almennum skrásetingar- ella profiloyðubløðum.

Stilla einaferð
  1. Stovna ella vel títt Bubble appverkætlan á BestPlugins → Dashboard → Plugins.
  2. Vel henda ískoytið og avrita verkætlanarnøkl.
  3. Opna Bubble → Plugins → Xodera QR Passes Native; lím nøklina inn í project_api_key og goym.
  4. Legg til elementið, vel tína appdátuna og bygg arbeiðsfløguna niðanfyri.
  5. Privat beta‑atgongd bert nú. Almannuppsetan og gjaldt virkisgerð eru enn ikki tøkar.
Uppsetning og abonnement

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.

Goym úrslitið í tína app

Dømi Admission ella Pickup: goym viðkomandi bílegging ella tiltak, pass_id, expires_at og issue_request_id. Eftir váttaða nýtslu skalt tú leggja receipt_id, redeemed_at og starvsfólkið, ið váttaði, afturat. Merk ikki skránna sum lidna, tá kodin bert er skannaður ella kannaður. Ein QR-kodi staðfestir ikki samleikan hjá einum persóni.

Feil, avlýsing og endurheimting

Um outcome_unknown=yes, varðveit sama QR-merki, sama request_id og somu inntaksvirði, tá úrslitið verður kannað aftur. Stovna ikki eina nýggja váttan. already_used, expired og revoked eru endalig úrslit av viðskiftagerðini. Verður loyvi noktað, bið ein fyrisitara við neyðugari heimild kanna heimildina hjá starvsfólkinum. Clear session nullstillir skannaran; tað kann ikki gera eina fullførda nýtslu ógilda.

Møguleikar og avmarkingar

Ætlaðu merkini kunnu nýtast eina ferð og eru gild í 1–86400 sekundir; standard er 900. Sløg: access, event, coupon og membership. Ein kanning bíleggur ikki merkið. Nýtslan krevur netsamband. Eingin gjaldsviðgerð, samleikakanning ella endurnýtandi langtíðarlimakort. At lesa eitt vanligt QR-virði er ikki tað sama sum at kanna eitt merki.

Stillingar, handlingar og úrslit

Nýt hesi nøvn í Bubble. Ætlaðar funktiónir eru merktar fyri seg.

Tøkt beta-innstillingar

Elementstillingar

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

Støður

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

Hendingar

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Handlingar og teirra innsløg

Clear session
Elementstillingar · 5

Áætlað arbeiðsfløga. Enn ikki tøkt í núverandi beta.

disabledyes/no · Standardvirði: false
Dømi um virðino
Dømi um Bubble-úttrykkGuideHost's is_busy (your yes/no custom state)
Óvirk elementið meðan appurin er upptekinn ella henda atgerð er ótøkt.
is_activeyes/no · Standardvirði: true
Dømi um virðiyes
Dømi um Bubble-úttrykkGuideHost's view_is_active (your yes/no custom state)
Set yes, meðan henda sýningin er opin. Set no, tá farið verður burtur úr henni, so avspæling ella verandi arbeiði kann steðga.
ui_text_jsontext · Standardvirði: "{}"
Dømi um virði{}
Dømi um Bubble-úttrykkApp Settings' player_labels_json (supported keys only)
Valfrítt JSON við stuðlaðum knappalabelum. Lat tómt fyri at nýta innbyggda tekst.
languagetext · Standardvirði: "auto"
Dømi um virðiuk
Dømi um Bubble-úttrykkCurrent User's preferred_language
Set language=auto fyri at fylgja málinum á tólinum ella í kaganum, um málið er stuðlað. Skriva ein stuðlaðan málkota fyri at velja málið beinleiðis.
workflow_modeyes/no · Standardvirði: false
Dømi um virðiyes
Dømi um Bubble-úttrykkApp Settings' use_qr_business_actions
Plánerað: loyva at skannaða QR virði verður nýtt av Check QR pass. Skanning eins er ikki nógvir til at staðfesta innkomu ella avhending.
Handlingar og teirra innsløg · 5

Áætlað arbeiðsfløga. Enn ikki tøkt í núverandi beta.

Clear session

Eingi atgerðaparametrar

Issue QR pass
environmenttext · Standardvirði: "development"
Dømi um virðidevelopment
Dømi um Bubble-úttrykkApp Settings' selected_environment
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
request_idtext · Standardvirði: —
Dømi um virðipickup-123-issue-v1
Dømi um Bubble-úttrykkCurrent Admission's stable_request_id
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
labeltext · Standardvirði: "access"
Dømi um virðievent
Dømi um Bubble-úttrykkSelected Admission's pass_label
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
ttl_secondsnumber · Standardvirði: 900
Dømi um virði900
Dømi um Bubble-úttrykkEvent Settings' pass_ttl_seconds
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.

Úrslit

pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/no
Check QR pass
environmenttext · Standardvirði: "development"
Dømi um virðidevelopment
Dømi um Bubble-úttrykkApp Settings' selected_environment
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
pass_tokentext · Standardvirði: —
Dømi um virði<opaque token returned by Issue / camera scan>
Dømi um Bubble-úttrykkQR Pass Scanner's scanned_pass_token (capture before Check)
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.

Úrslit

pass_label · textexpires_at · text
Confirm QR redemption
environmenttext · Standardvirði: "development"
Dømi um virðidevelopment
Dømi um Bubble-úttrykkApp Settings' selected_environment
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
pass_tokentext · Standardvirði: —
Dømi um virði<opaque token returned by Issue / camera scan>
Dømi um Bubble-úttrykkQR Pass Scanner's scanned_pass_token (capture before Check)
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
request_idtext · Standardvirði: —
Dømi um virðipickup-123-redeem-v1
Dømi um Bubble-úttrykkCurrent Admission's stable_redemption_request_id
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
confirmyes/no · Standardvirði: false
Dømi um virðiyes — explicit confirmation only
Dømi um Bubble-úttrykkConfirm Checkbox is checked
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.

Úrslit

pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/no
Revoke QR pass
environmenttext · Standardvirði: "development"
Dømi um virðidevelopment
Dømi um Bubble-úttrykkApp Settings' selected_environment
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.
pass_idtext · Standardvirði: —
Dømi um virði<pass_id returned by Issue>
Dømi um Bubble-úttrykkSelected Admission's pass_id
Nýt virðið í verandi virkisskrá; kanna, at tað er innan fyri mørkini niðanfyri.

Úrslit

pass_id · textrevoked · yes/no
Støður og hendingar

Áætlað arbeiðsfløga. Enn ikki tøkt í núverandi beta.

Støður

scanner_status · text

Núverandi úrslit av hesari gerð. Nýt samsvarandi fullføringarhending áðrenn tú goymir avrik. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Núverandi úrslit av hesari gerð. Nýt samsvarandi fullføringarhending áðrenn tú goymir avrik. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Eyðkenni fyri henda lut ella hesa handling. Varðveit tað saman við samsvarandi skrá í appini. Nýt sama fyrispurningar-ID, tá tú roynir aftur eftir eitt óvist úrslit.

pass_label · text

Verandi virði fyri valda lutin. Les tað eftir viðkomandi hending. empty,access,event,coupon,membership

receipt_id · text

Eyðkenni fyri henda lut ella hesa handling. Varðveit tað saman við samsvarandi skrá í appini. Nýt sama fyrispurningar-ID, tá tú roynir aftur eftir eitt óvist úrslit.

error_code · text

Feilmelding fyri síðstu atgerð. Vís hjálpsama boð og bjóð á viðkomandi roynd aftur.

is_busy · yes/no

Arbeið er framvegis í gongd. Bíða áðrenn tú byrjar eina aðra handling.

is_scanning · yes/no

Verandi virði fyri valda lutin. Les tað eftir viðkomandi hending.

torch_enabled · yes/no

Verandi virði fyri valda lutin. Les tað eftir viðkomandi hending.

scan_source · text

Verandi virði fyri valda lutin. Les tað eftir viðkomandi hending. empty,camera,fixture

pending_redemption · yes/no

Verandi virði fyri valda lutin. Les tað eftir viðkomandi hending.

scanned_pass_token · text

Verandi virði fyri valda lutin. Les tað eftir viðkomandi hending.

Hendingar

scanner_started

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

scanner_paused

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

scanner_cancelled

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

permission_denied

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

pass_scanned

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

validation_started

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

validation_completed

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

redemption_started

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

pass_redeemed

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

redemption_rejected

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

redemption_pending

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

fixture_decoded

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

qr_error

Tá henda hendingin kemur, les so viðkomandi støður frá sama elementi.

Spurningar, sum menningarmenn leggja fram

Hvat merkja tey tvø eru loyvi innstillingarnar?

Navnið á einum yes/no-felti á User, ið merkir starvsfólk við loyvi at stovna ella afturkalla QR-merki. Dømi/standard: qr_pass_issuer. Skriva feltnavnið her, ikki yes ella no. Bert ein fyrisitari við neyðugari heimild eigur at broyta hetta loyvið á einum brúkara. Navnið á einum yes/no-felti á User, ið merkir starvsfólk við loyvi at kanna og vátta nýtslu. Dømi/standard: qr_staff. Tann, ið hevur atgongumerkið, hevur ikki tørv á hesum loyvi. Hav tað ikki við í almennum skrásetingar- ella profiloyðubløðum.

Kundi somu starvsfólk skapa og kanna pass?

Ja, um ein fyrisitari við neyðugari heimild gevur starvsfólkinum bæði loyvini. Hetta krevur ikki ein annan verkætlanarlykil. Kundar hava vanliga ikki tørv á nøkrum av loyvunum. Lat ikki brúkarar geva sær sjálvum hesi loyvi.

Hví brúka Check eftir Scan?

Scan lesir kóðan. Check spyr um passið er tøkt uttan at brúka tað. Starvsfólk kunnu hyggja á bestillingina fyrst. Bert tann serstaka Confirm QR redemption atgerð brúkar passið einferð.

Hvussu virkar abonnementið?

Ætlað prísseting: tað er ókeypis at leggja ískoytið inn í Bubble. Atgongd til BestPlugins krevur eitt serstakt hald fyri hvørt ískoyti í hvørjari Bubble-appverkætlan: 7 dagar ókeypis, síðani US$1.50 um mánaðin. Development og Live eru við. Einki fast mark er fyri talinum á atgerðum; mørk fyri fílustødd og funktiónir eru framvegis galdandi. Enn ber ikki til at keypa. Virkingarsíðan fer at vísa fyrsta gjaldsdagin og treytirnar fyri at siga haldið upp.

Tilknyttar vegleiðingar

Marketplace útgáva í bíð

Forumbókleiðing ikki lagt út

Hevur tú tørv á hjálp, sig okkum, hvat ískoyti og hvat tól tú nýtir, hvørja handling tú royndi, og hvat hendi. Nýt eitt dømi uttan persónsupplýsingar. Deil ongantíð lykilin ella privatar fílur.