Xodera Plugins · Bubble Native
Xodera QR Passes Native
Búðu til einnota miða, afhendingarstaðfestingar eða afsláttarmiðar. Starfsfólk skannar kóðann, athugar niðurstöðuna, forsýnir pöntunina og staðfestir notkun aðeins þegar það er tilbúið.
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.
Skjölun yfirfarin 6 nóvember 2026
Hagnýt dæmi
Aðgangur í eitt skipti að viðburði sama dag
Skjámynd venjulegs QR gildi getur annars verið endurnýtt á fleiri en einum inngangi.
Forritið þitt geymir Admission-færslu og stöðugt `request_id` fyrir útgáfu miðans; notaðu fyrirfram valið `label=event` og `ttl_seconds` innan 1–86400 sekúndna markanna.
Útgefandi með tilskilda heimild keyrir Issue QR pass og afhendir skilaða QR einkalega. Starfsfólk skannar → Check QR pass → staðfestir aðeins ef `ok=yes` og `status=available` → Confirm QR redemption með vistuðu, stöðugu beiðniauðkenni.
Aðeins `status=redeemed` ásamt `receipt_id` heimilar útgáfu aðgangskvittunar í forritinu þínu. Geymdu tilvísun í miða eða kvittun í Admission-færslunni; ekki senda innihald QR í greiningarkerfi.
Fyrir `outcome_unknown`, endurheimtu sömu beiðni með eins notanda/umhverfi/miða; aldrei búa til nýtt staðfestingarauðkenni. Meðhöndla expired, revoked og þegar notuð stöðu sem ólíka niðurstöðu.
Áætlað. Skönnun og athugun nota ekki upp eina notkun miðans; það gerist aðeins við skýra staðfestingu.
Nýta skammtímafríðindi einu sinni við þjónustustöð samstarfsaðila
Samstarfsaðili þarf staðfest niðurstöðu um notað/ónotað í stað þess að treysta á QR mynd eða hreyfimynd á skjánum.
`label=coupon`; áður en útgefandi með tilskilda heimild gefur miðann út skilgreinir Benefit-færsla forritsins hver á rétt á fríðindunum og stuttan gildistíma.
Gefðu miða aðeins út eftir að forritið þitt hefur athugað rétt til fríðindanna. Við afgreiðsluborðið sýnir Check QR pass hvort miðinn er tiltækur án þess að nota hann upp. Eftir að starfsmaður hefur staðfest afhendingu fríðindanna skaltu keyra Confirm QR redemption.
Benefit-færslan þín getur geymt `receipt_id` og staðfestan innlausnartíma eftir `status=redeemed`. Viðbótin heldur utan um stöðu miðans; forritið þitt heldur utan um fríðindin og viðskiptasambandið.
Ef hætt er við fríðindi áður en þau eru nýtt getur sami útgefandi með tilskilda heimild keyrt Revoke QR pass með `pass_id` miðans. Ekki tilkynna endurgreiðslu eða árangursríka innlausn út frá `ok=yes` einu saman.
Áætlað. Skönnun og athugun nota ekki upp eina notkun miðans; það gerist aðeins við skýra staðfestingu.
Staðfestu afhendingu búnaðar eða pöntunar sama dag
Vinnuflæði starfsfólks þarf að greina á milli þess að skanna tilvísun fyrir afhendingu og þess að afhenda hlutinn í raun.
Collection-færsla í eigu forritsins þíns geymir afhendingarheimild, hlutinn sem á að afhenda og aðskilin, stöðug beiðniauðkenni fyrir útgáfu og innlausn; notaðu `label=access` miða með stuttan gildistíma.
Eftir að forritið þitt hefur heimilað afhendingu skaltu keyra Issue QR pass. Starfsfólk skannar og athugar, skoðar samsvarandi Collection-færslu í forritinu, staðfestir síðan afhendinguna sérstaklega og keyrir Confirm QR redemption.
Aðeins eftir staðfesta `redeemed` kvittun á vinnuflæðið þitt að merkja Collection-færsluna sem afhenta. Haltu `receipt_id` sem tengingu við niðurstöðu miðans.
Endurtekin skönnun getur skilað already_used; birta núverandi forritsskrá í stað þess að afhenda annan hlut. Endurheimtu óvissa staðfestingu með sama auðkenni og inntökum.
Áætlað. Skönnun og athugun nota ekki upp eina notkun miðans; það gerist aðeins við skýra staðfestingu.
Hvað virkar núna
Einka-beta. Núverandi skönnunartæki hefur myndavél og heimildastýringar. Að búa til, athuga og staðfesta einnota aðgöngumiðar er í áætlun og er ekki enn tilbúið til notkunar í forritinu þínu.
Búðu til vinnuflæðið
Áætlað
Áætlað vinnuferli. Ekki tiltækt í núverandi beta enn.
Þessi dæmi nota gagnaskrár forritsins, svo sem Lesson, Message og Order. Skiptu þeim út fyrir þínar eigin gagnategundir og nöfn viðmótsþátta. Skiptu slóðum að dæmismiðlum út fyrir slóðir að þínum eigin skrám.
Áætlað: starfsmaður með tilskilda heimild notar Issue QR pass fyrir Admission-færslu eða Order. Dæmi: label=event, ttl_seconds=900, environment=development. Haltu stöðugu request_id fyrir þessa útgáfu miðans og vistaðu pass_id með færslunni.
Sýndu skilaða QR þeim handhafa sem hann er ætlaður. Starfsmenn skanna það. Í áætluðu skírteinavinnsluferli, notaðu workflow_mode=yes og lestu scanned_pass_token eftir pass_scanned. Þessi stillingar skírteinavinnslu eru ekki tiltækar í núverandi skönnunartæki.
Keyrðu Check QR pass með pass_token = QR Scanner's scanned_pass_token. Athugunin notar ekki upp eina notkun miðans. Fyrir status=available skaltu sýna viðeigandi pöntun eða upplýsingar um aðgang svo starfsfólk geti yfirfarið þær.
Aðeins sérstakur Staðfesta-hnappur keyrir Confirm QR redemption með sama pass_token, stöðugu request_id og confirm=yes. Við status=redeemed skaltu vista receipt_id og merkja pöntunina eða aðgangsfærsluna sem lokið.
already_used, expired, revoked eða invalid þýðir að ekki megi veita aðgang eða afhenda pöntunina. Skönnun eða árangursrík Check-aðgerð ein og sér lýkur aldrei viðskiptunum.
Stilla einu sinni
Búðu til eða veldu Bubble forritaverkefnið í BestPlugins → Dashboard → Plugins. Veldu Xodera QR Passes Native, afritaðu lykilinn, opnaðu síðan Bubble → Plugins → Xodera QR Passes Native og límdu hann í project_api_key. Vistaðu einu sinni; notaðu síðan aðgerðirnar hér að neðan. Hver viðbót í hverju verkefni hefur sinn eigin lykil.
Skönnun krefst aðgangs að myndavél. Fyrir einnota miða skaltu ákveða hver má gefa þá út og hver má athuga þá við inngang eða afhendingarstað. Venjulegir viðskiptavinir þurfa hvorugt starfsmannahlutverkið.
qr_issuer_permission_field
qr_pass_issuer · Nafn yes/no-reits á User sem gefur til kynna hvaða starfsmenn mega búa til eða afturkalla miða. Dæmi/sjálfgefið: qr_pass_issuer. Settu nafn reitsins hér, ekki yes eða no. Aðeins stjórnandi með tilskilda heimild á að breyta þessari heimild notanda.
qr_staff_permission_field
qr_staff · Nafn yes/no-reits á User sem gefur til kynna hvaða starfsmenn mega athuga miða og staðfesta notkun þeirra. Dæmi/sjálfgefið: qr_staff. Handhafi miða þarf ekki þessa heimild. Ekki hafa þennan reit á opinberum skráningar- eða notandasniðseyðublöðum.
Stilla einu sinni
- Búðu til eða veldu Bubble forritaverkefnið í BestPlugins → Dashboard → Plugins.
- Veldu þessa viðbót og afritaðu verkefnalykilinn.
- Opnaðu Bubble → Plugins → Xodera QR Passes Native; límdu lykilinn í project_api_key og vistaðu.
- Bættu við atriðinu, veldu forritagögnin þín og byggðu vinnuferlið hér að neðan.
- Einka-beta aðgangur aðeins í bili. Opinber uppsetning og greidd virkjun eru ekki opin enn.
Uppsetning og áskrift
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.
Vistaðu niðurstöðuna í forritinu þínu
Dæmi um Admission-færslu fyrir aðgang eða Pickup-færslu fyrir afhendingu: vistaðu tengda pöntun eða viðburð, pass_id, expires_at og issue_request_id. Eftir staðfesta notkun skaltu bæta við receipt_id, redeemed_at og starfsmanninum sem staðfesti. Ekki merkja færsluna sem lokið þegar kóðinn hefur aðeins verið skannaður eða athugaður. QR-kóði staðfestir ekki hver einstaklingur er.
Bilun, afturköllun og endurheimt
Ef outcome_unknown=yes, haltu sama skírteini, request_id og inntökum þegar niðurstaðan er athuguð aftur. Ekki búa til nýja staðfestingu. already_used, expired og revoked eru lokaákvarðanir í viðskiptum. Ef heimild er hafnað, biððu viðurkenndan stjórnanda um að yfirfara hlutverk starfsmannsins. Clear session endurstillir skönnunartækið; það getur ekki afturkallað lokið notkun.
Möguleikar og takmarkanir
Áætlaðir miðar eru einnota og gilda í 1–86400 sekúndur; sjálfgefið er 900. Miðategundir: access, event, coupon og membership. Athugun tekur miðann ekki frá. Nettenging er nauðsynleg til að nota miðann. Ekki er boðið upp á greiðsluvinnslu, sannprófun á því hver einstaklingur er eða endurnýtanlegt langtímaaðildarkort. Lestur venjulegs QR-gildis er aðskilinn frá athugun á miða.
Stillingar, aðgerðir og niðurstöður
Notaðu þessi nöfn í Bubble. Áætlaðir eiginleikar eru merktir aðskilt.
Fáanleg beta stillingar
Stillingar atriðis
disabled · yes/nois_active · yes/noui_text_json · textlanguage · textStöð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/noAtburðir
scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_errorAðgerðir og inntök þeirra
Clear sessionStillingar atriðis · 5
Áætlað vinnuferli. Ekki tiltækt í núverandi beta enn.
disabledyes/no · Sjálfgefið: false- Dæmi um gildi
no - Dæmi um Bubble-segð
GuideHost's is_busy (your yes/no custom state) - Óvirkjaðu þennan þátt þegar forritið er upptekið eða aðgerð er ekki tiltæk.
is_activeyes/no · Sjálfgefið: true- Dæmi um gildi
yes - Dæmi um Bubble-segð
GuideHost's view_is_active (your yes/no custom state) - Stilltu yes á meðan þessi sýn er opin. Stilltu no þegar hún er yfirgefin svo afspilun eða núverandi vinna geti stöðvast.
ui_text_jsontext · Sjálfgefið: "{}"- Dæmi um gildi
{} - Dæmi um Bubble-segð
App Settings' player_labels_json (supported keys only) - Valfrjálst JSON með studdum hnappamerkingum. Skildu eftir tómt til að nota innbyggðan texta.
languagetext · Sjálfgefið: "auto"- Dæmi um gildi
uk - Dæmi um Bubble-segð
Current User's preferred_language - Stilltu language=auto til að fylgja tungumáli tækisins eða vafrans ef stuðningur er við það. Sláðu inn studdan tungumálakóða til að velja tungumál sérstaklega.
workflow_modeyes/no · Sjálfgefið: false- Dæmi um gildi
yes - Dæmi um Bubble-segð
App Settings' use_qr_business_actions - Áætlað: leyfðu Check QR pass að nota skannaða QR-gildið. Skönnun ein og sér staðfestir hvorki aðgang né afhendingu.
Aðgerðir og inntök þeirra · 5
Áætlað vinnuferli. Ekki tiltækt í núverandi beta enn.
Clear session
Engir aðgerðarbreytur
Issue QR pass
environmenttext · Sjálfgefið: "development"- Dæmi um gildi
development - Dæmi um Bubble-segð
App Settings' selected_environment - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
request_idtext · Sjálfgefið: —- Dæmi um gildi
pickup-123-issue-v1 - Dæmi um Bubble-segð
Current Admission's stable_request_id - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
labeltext · Sjálfgefið: "access"- Dæmi um gildi
event - Dæmi um Bubble-segð
Selected Admission's pass_label - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
ttl_secondsnumber · Sjálfgefið: 900- Dæmi um gildi
900 - Dæmi um Bubble-segð
Event Settings' pass_ttl_seconds - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Skilagildi
pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/noCheck QR pass
environmenttext · Sjálfgefið: "development"- Dæmi um gildi
development - Dæmi um Bubble-segð
App Settings' selected_environment - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
pass_tokentext · Sjálfgefið: —- Dæmi um gildi
<opaque token returned by Issue / camera scan> - Dæmi um Bubble-segð
QR Pass Scanner's scanned_pass_token (capture before Check) - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Skilagildi
pass_label · textexpires_at · textConfirm QR redemption
environmenttext · Sjálfgefið: "development"- Dæmi um gildi
development - Dæmi um Bubble-segð
App Settings' selected_environment - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
pass_tokentext · Sjálfgefið: —- Dæmi um gildi
<opaque token returned by Issue / camera scan> - Dæmi um Bubble-segð
QR Pass Scanner's scanned_pass_token (capture before Check) - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
request_idtext · Sjálfgefið: —- Dæmi um gildi
pickup-123-redeem-v1 - Dæmi um Bubble-segð
Current Admission's stable_redemption_request_id - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
confirmyes/no · Sjálfgefið: false- Dæmi um gildi
yes — explicit confirmation only - Dæmi um Bubble-segð
Confirm Checkbox is checked - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Skilagildi
pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/noRevoke QR pass
environmenttext · Sjálfgefið: "development"- Dæmi um gildi
development - Dæmi um Bubble-segð
App Settings' selected_environment - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
pass_idtext · Sjálfgefið: —- Dæmi um gildi
<pass_id returned by Issue> - Dæmi um Bubble-segð
Selected Admission's pass_id - Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Skilagildi
pass_id · textrevoked · yes/noStöður og atburðir
Áætlað vinnuferli. Ekki tiltækt í núverandi beta enn.
Stöður
scanner_status · textNúverandi niðurstaða þessa aðgerðar. Notaðu samsvarandi lokaatburð áður en þú vistar árangur. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded
server_status · textNúverandi niðurstaða þessa aðgerðar. Notaðu samsvarandi lokaatburð áður en þú vistar árangur. empty,available,redeemed,already_used,expired,revoked
pass_id · textAuðkenni fyrir þennan hlut eða aðgerð. Halda því með samsvarandi forritsskrá. Notaðu sama beiðniauðkenni þegar þú reynir aftur óvissa niðurstöðu.
pass_label · textNúverandi gildi fyrir valda atriðið. Lestu það eftir tengda atburðinn. empty,access,event,coupon,membership
receipt_id · textAuðkenni fyrir þennan hlut eða aðgerð. Halda því með samsvarandi forritsskrá. Notaðu sama beiðniauðkenni þegar þú reynir aftur óvissa niðurstöðu.
error_code · textVillumeldingar og aðrar villuupplýsingar fyrir síðustu aðgerð. Sýndu gagnleg skilaboð og bjóddu viðeigandi endurtilraun.
is_busy · yes/noVerk er enn í vinnslu. Bíddu áður en þú byrjar aðra aðgerð.
is_scanning · yes/noNúverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.
torch_enabled · yes/noNúverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.
scan_source · textNúverandi gildi fyrir valda atriðið. Lestu það eftir tengda atburðinn. empty,camera,fixture
pending_redemption · yes/noNúverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.
scanned_pass_token · textNúverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.
Atburðir
scanner_startedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
scanner_pausedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
scanner_cancelledÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
permission_deniedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
pass_scannedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
validation_startedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
validation_completedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
redemption_startedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
pass_redeemedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
redemption_rejectedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
redemption_pendingÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
fixture_decodedÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
qr_errorÞegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.
Spurningar sem þróunaraðilar spyrja
Hvað merkja þessi tvö heimildarstillingar?
Nafn yes/no-reits á User sem gefur til kynna hvaða starfsmenn mega búa til eða afturkalla miða. Dæmi/sjálfgefið: qr_pass_issuer. Settu nafn reitsins hér, ekki yes eða no. Aðeins stjórnandi með tilskilda heimild á að breyta þessari heimild notanda. Nafn yes/no-reits á User sem gefur til kynna hvaða starfsmenn mega athuga miða og staðfesta notkun. Dæmi/sjálfgefið: qr_staff. Handhafi miða þarf ekki þessa heimild. Ekki hafa þennan reit á opinberum skráningar- eða notandasniðseyðublöðum.
Getur sami starfsmanninn búið til og athugað skírteini?
Já, ef viðurkenndur stjórnandi veitir starfsmanninum báðar heimildir. Þetta krefst ekki annarrar verkefnalykils. Viðskiptavinir þurfa venjulega hvorki heimild. Ekki leyfa notendum að úthluta þessum heimildum sjálfir.
Af hverju nota Check eftir Scan?
Scan les kóðann. Check spyr hvort skírteinið er í boði án þess að nota það. Starfsmenn geta yfirfarið pöntunina fyrst. Aðeins sérstaka Confirm QR redemption aðgerð notar skírteinið einu sinni.
Hvernig virkar áskriftin?
Áætluð verðlagning: uppsetning viðbótar í Bubble er ókeypis. BestPlugins aðgangur er sérstök áskrift fyrir hverja viðbót í hverju Bubble forritaverkefni: 7 dagar ókeypis, síðan US$1.50 á mánuði. Development og Live eru innifalin. Það er engin fast takmörk á fjölda aðgerða; takmörk á skráarstærð og eiginleikum gilda enn. Greiðsla er ekki opin enn. Virkjunarskjár sýnir fyrsta gjalddaginn og uppsagnarskilmála.
Tengdar leiðbeiningar
Bíður útgáfu á Marketplace
Umræðusvæðisleiðbeining ekki birt
Fyrir aðstoð, segðu okkur hvaða viðbót og tæki þú notar, aðgerðina sem þú reyndir og hvað gerðist. Notaðu dæmi án persónuupplýsinga. Deildu aldrei lykli þínum eða einkaskrám.