comhéadan scanóir QR. Tá gníomhartha pas úsáide amháin beartaithe.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Tóg ticéid aon-úsáide, deimhnithe bailithe nó cúpóin. Scanann an fhoireann an cód, seiceann siad an toradh, réamhamharc ar an ordú agus deimhníonn siad an úsáid ach nuair atá sé réidh.

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.

Tóg an sreabhadh oibre ↓Socruithe breiseáin ↗Native Lab

Doiciméadú athbhreithnithe 6 Samhain 2026

Samplaí praiticiúla

Isteach le húsáid aonair d’imeacht an lae céanna

Is féidir glacadh scáileán de luach QR gnáth a athúsáid ag níos mó ná ceann iontrála amháin.

Stórálann d'aip taifead Admission agus `request_id` cobhsaí don eisiúint; úsáid an `label=event` ceadaithe agus `ttl_seconds` laistigh den teorainn 1–86400 soicind.

Rithann eisitheoir údaraithe Issue QR pass agus seachadann sé go príobháideach an QR a fuarthas. Scanann an fhoireann → Check QR pass → deimhnigh ach amháin má tá `ok=yes` agus `status=available` → Confirm QR redemption le ID iarratais chobhsaí stóráilte.

Ní údaraíonn ach `status=redeemed` in éineacht le `receipt_id` admháil iontrála d'aip. Stóráil tagairt an phas agus na hadmhála sa taifead Admission; ná nocht ábhar an QR do sheirbhísí anailísíochta.

Le haghaidh `outcome_unknown`, aisghabh an t-iarratas céanna leis an úsáideoir, an timpeallacht agus an pas céanna; ná gin ID deimhnithe nua riamh. Láimhseáil expired, revoked agus stáit úsáide cheana mar thorthaí ar leith.

Beartaithe. Ní úsáideann scanadh ná seiceáil an pas; is é deimhniú sainráite amháin a úsáideann é.

Bain leas as sochar gearrthéarmach uair amháin ag cuntar comhpháirtí

Teastaíonn torthaí deimhnithe úsáidte/ná húsáidte ó chomhpháirtí in ionad muinín a chur i íomhá QR nó i mbunú scáileáin.

`label=coupon`; sainíonn taifead Sochair na haipe incháilíocht agus fuinneog bhailíochta gearr roimh ghníomh eisiúna údaraithe.

Eisigh pas tar éis sheiceáil incháilíochta d'aip amháin. Ag an gcuntar, taispeánann Check QR pass an bhfuil sé ar fáil gan é a úsáid. Tar éis don bhall foirne seachadadh an tsochair a dheimhniú, rith Confirm QR redemption.

Féadfaidh do thaifead Benefit `receipt_id` agus am na húsáide deimhnithe a stóráil tar éis `status=redeemed`. Bainistíonn an breiseán staid an phas; bainistíonn d'aip an sochar agus an caidreamh leis an gcustaiméir.

Má chuirtear sochar ar ceal roimh úsáid, is féidir leis an eisitheoir údaraithe céanna Revoke QR pass a úsáid lena `pass_id`. Ná fógair aisíocaíocht ná úsáid rathúil an phas ó `ok=yes` amháin.

Beartaithe. Ní úsáideann scanadh ná seiceáil an pas; is é deimhniú sainráite amháin a úsáideann é.

Deimhnigh bailiú trealaimh nó orduithe an lae céanna.

Ní mór do shruth oibre foirne idirdhealú a dhéanamh idir scanadh tagairt bailiúcháin agus seachadadh míre i ndáiríre.

Coinníonn taifead Collection d'aip féin an t-údarú, an mhír atá le bailiú agus IDanna iarratais cobhsaí ar leith don eisiúint agus don úsáid; úsáid pas gearrthéarmach `label=access`.

Tar éis d'aip an bailiú a údarú, úsáid Issue QR pass. Scanann an fhoireann agus úsáideann siad Check, scrúdaíonn siad an Collection comhoiriúnach i d'aip, agus ansin deimhníonn siad go sainráite gur tugadh an mhír don duine agus úsáideann siad Confirm QR redemption.

Níor cheart do shreabhadh oibre Collection a mharcáil mar tugtha don duine ach tar éis admháil dheimhnithe `redeemed`. Coinnigh `receipt_id` mar nasc le toradh an phas.

Féadfaidh scanadh athdhéanta already_used a thabhairt; taispeáin an taifead aipe atá ann seachas mír eile a sholáthar. Aisghabh deimhniú éiginnte leis an ID agus na hionchurí céanna.

Beartaithe. Ní úsáideann scanadh ná seiceáil an pas; is é deimhniú sainráite amháin a úsáideann é.

Cad a oibríonn anois

Béta príobháideach. Tá rialuithe ceamara agus ceadanna ag an scanóir reatha. Tá sé beartaithe cártaí aon-úsáide a chruthú, a sheiceáil agus a dheimhniú, ach níl sé réidh le húsáid i d’aip fós.

Tóg an sreabhadh oibre

Pleanáilte

Sreabhú oibre beartaithe. Níl sé ar fáil sa bhéite reatha fós.

Úsáideann na samplaí seo taifid aipe cosúil le Lesson, Message agus Order. Cuir ionad orthu le do chineálacha sonraí agus ainmneacha eilimintí féin. Ní mór seoltaí meán sampla a chur in ionad le do chomhaid féin.

Beartaithe: úsáideann fostaí údaraithe Issue QR pass do Admission nó Order. Sampla: label=event, ttl_seconds=900, environment=development. Coinnigh request_id cobhsaí don eisiúint sin agus sábháil pass_id leis an taifead.
Taispeáin an QR a filleadh don úinéir beartaithe. Scanann an fhoireann é. Sa sreabhadh oibre pas earmhraithe, bain úsáid as workflow_mode=yes agus léigh scanned_pass_token tar éis pass_scanned. Níl na socruithe sreabhadh-pas seo ar fáil sa scanóir reatha.
Rith Check QR pass le pass_token = QR Scanner's scanned_pass_token. Seiceann sé gan an pas a úsáid. Maidir le status=available, taispeáin na sonraí ordú nó iontrála comhoiriúnacha ionas gur féidir leis an fhoireann iad a athbhreithniú.
Ní rithtear Confirm QR redemption ach le cnaipe Deimhnigh ar leith le pass_token céanna, request_id cobhsaí agus confirm=yes. Ar status=redeemed, sábháil receipt_id agus marcáil an t-ordú nó iontráil sin mar iomlán.
Ciallaíonn already_used, expired, revoked nó invalid nár cheart cead isteach a thabhairt ná an t-ordú a thabhairt don duine. Ní chríochnaíonn scanadh ná Check rathúil leis féin an t-idirbheart riamh.

Cairt sreabhchair – ní íomhá scáileáin app é

Cumraigh uair amháin

Cruthaigh nó roghnaigh do thionscadal aipe Bubble i BestPlugins → Dashboard → Plugins. Roghnaigh Xodera QR Passes Native, cóipeáil a eochair, ansin oscail Bubble → Plugins → Xodera QR Passes Native agus greamaigh í i project_api_key. Sábháil uair amháin; ansin úsáid na gníomhartha thíos. Tá a eochair féin ag gach breiseán i ngach tionscadal.

Éilíonn scanadh ceadú an cheamara. Le haghaidh pasanna úsáide aonair, cinneadh cé a d'fhéadfadh pasanna a chruthú agus cé a d'fhéadfadh iad a sheiceáil ag an doras nó ag an bpointe bailithe. Ní gá do chustaiméirí gnáth ní ról foirne.

`qr_issuer_permission_field`

qr_pass_issuer · Ainm an réimse yes/no ar User a mharcálann fostaithe a bhfuil cead acu pasanna a chruthú nó a chúlghairm. Sampla/réamhshocrú: qr_pass_issuer. Cuir ainm an réimse anseo, ní yes ná no. Níor cheart ach riarthóir údaraithe an cead sin a athrú ar úsáideoir.

`qr_staff_permission_field`

qr_staff · Ainm an réimse yes/no ar User a mharcálann baill foirne a bhfuil cead acu úsáid a sheiceáil agus a dheimhniú. Sampla/réamhshocrú: qr_staff. Ní theastaíonn an cead seo ó shealbhóir ticéid. Ná cuir i bhfoirmeacha cláraithe poiblí ná próifíle é.

Cumraigh uair amháin

Cruthaigh nó roghnaigh do thionscadal aipe Bubble ag BestPlugins → Dashboard → Plugins.
Roghnaigh an breiseán seo agus cóipeáil a eochair tionscadail.
Oscail Bubble → Plugins → Xodera QR Passes Native; greamaigh an eochair i project_api_key agus sábháil.
Cuir an eilimint leis, roghnaigh do shonraí aipe agus cruthaigh an sreabhú oibre thíos.
Rochtain béite phríobháideach ach faoi láthair. Níl suiteáil poiblí agus gníomhachtú íoctha ar oscailt fós.

Suiteáil agus síntiús

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.

Sábháil an toradh i d’aip

Sampla Admission nó Pickup: sábháil an t-ordú nó an t-imeacht gaolmhar, pass_id, expires_at agus issue_request_id. Tar éis úsáid dheimhnithe, cuir receipt_id, redeemed_at agus an fostaí a dheimhnigh leis. Ná marcáil an taifead mar chríochnaithe nuair nach bhfuil déanta ach an cód a scanadh nó a sheiceáil. Ní fhíoraíonn cód QR céannacht duine.

Teip, cealú agus aisghabháil

Má outcome_unknown=yes, coinnigh an pas céanna, request_id agus na hionchurtha agus tú ag seiceáil an toradh arís. Ná cruthaigh deimhniú nua. Is torthaí gnó deiridh iad already_used, expired agus revoked. Má diúltaítear cead, iarr ar riarthóir údaraithe ról an fhostaí a athbhreithniú. Athshocraíonn Clear session an scanóir; ní féidir leis úsáid chríochnaithe a chur ar ceal.

Cumais agus teorainneacha

Tá pasanna beartaithe aon-úsáide, bailí ar feadh 1–86400 soicind; is é 900 an réamhshocrú. Cineálacha pas: access, event, coupon agus membership. Ní chuireann seiceáil pas in áirithe. Teastaíonn rochtain Idirlín chun pas a úsáid. Gan próiseáil íocaíochtaí, seiceáil céannachta ná cárta ballraíochta fadtéarmach in-athúsáidte. Tá léamh gnáthluacha QR ar leith ó sheiceáil pas.

Socruithe, gníomhartha agus torthaí

Úsáid na hainmneacha seo i Bubble. Tá gnéithe beartaithe marcáilte ar leith.

Socruithe béite ar fáil

Socruithe eilimint

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

Stáit

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

Imeachtaí

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Gníomhartha agus a n-ionchur

Clear session

Socruithe eilimint · 5

Sreabhú oibre beartaithe. Níl sé ar fáil sa bhéite reatha fós.

disabledyes/no · Réamhshocrú: false: Luach samplano; Sampla de shlonn BubbleGuideHost's is_busy (your yes/no custom state); Díchumasaigh an eilimint agus tá d’aip gnóthach nó nach bhfuil an gníomh seo ar fáil.

is_activeyes/no · Réamhshocrú: true: Luach samplayes; Sampla de shlonn BubbleGuideHost's view_is_active (your yes/no custom state); Socraigh yes fad atá an t-amharc seo oscailte. Socraigh no agus tú á fhágáil, ionas gur féidir leis an athsheinm nó leis an obair reatha stopadh.

ui_text_jsontext · Réamhshocrú: "{}": Luach sampla{}; Sampla de shlonn BubbleApp Settings' player_labels_json (supported keys only); JSON roghnach le lipéid cnaipe tacaithe. Fág folamh chun an téacs ionsuite a úsáid.

languagetext · Réamhshocrú: "auto": Luach samplauk; Sampla de shlonn BubbleCurrent User's preferred_language; Socraigh language=auto chun teanga an ghléis nó an bhrabhsálaí a leanúint, má thacaítear leis an teanga sin. Cuir isteach cód teanga tacaithe chun an teanga a roghnú go sainráite.

workflow_modeyes/no · Réamhshocrú: false: Luach samplayes; Sampla de shlonn BubbleApp Settings' use_qr_business_actions; Beartaithe: ceadaigh an luach QR a scanaíodh a úsáid ag Check QR pass. Ní dheimhníonn scanadh amháin iontráil nó bailiú.

Gníomhartha agus a n-ionchur · 5

Sreabhú oibre beartaithe. Níl sé ar fáil sa bhéite reatha fós.

Clear session

Gan paraiméadair gníomhaíochta

Issue QR pass

environmenttext · Réamhshocrú: "development": Luach sampladevelopment; Sampla de shlonn BubbleApp Settings' selected_environment; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

request_idtext · Réamhshocrú: —: Luach samplapickup-123-issue-v1; Sampla de shlonn BubbleCurrent Admission's stable_request_id; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

labeltext · Réamhshocrú: "access": Luach samplaevent; Sampla de shlonn BubbleSelected Admission's pass_label; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

ttl_secondsnumber · Réamhshocrú: 900: Luach sampla900; Sampla de shlonn BubbleEvent Settings' pass_ttl_seconds; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

Aischur

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

Check QR pass

environmenttext · Réamhshocrú: "development": Luach sampladevelopment; Sampla de shlonn BubbleApp Settings' selected_environment; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

pass_tokentext · Réamhshocrú: —: Luach sampla<opaque token returned by Issue / camera scan>; Sampla de shlonn BubbleQR Pass Scanner's scanned_pass_token (capture before Check); Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

Aischur

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Réamhshocrú: "development": Luach sampladevelopment; Sampla de shlonn BubbleApp Settings' selected_environment; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

pass_tokentext · Réamhshocrú: —: Luach sampla<opaque token returned by Issue / camera scan>; Sampla de shlonn BubbleQR Pass Scanner's scanned_pass_token (capture before Check); Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

request_idtext · Réamhshocrú: —: Luach samplapickup-123-redeem-v1; Sampla de shlonn BubbleCurrent Admission's stable_redemption_request_id; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

confirmyes/no · Réamhshocrú: false: Luach samplayes — explicit confirmation only; Sampla de shlonn BubbleConfirm Checkbox is checked; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

Aischur

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

Revoke QR pass

environmenttext · Réamhshocrú: "development": Luach sampladevelopment; Sampla de shlonn BubbleApp Settings' selected_environment; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

pass_idtext · Réamhshocrú: —: Luach sampla<pass_id returned by Issue>; Sampla de shlonn BubbleSelected Admission's pass_id; Bain úsáid as luach taifid ghnó reatha; bailíochta i gcoinne na teorann thíos.

Aischur

pass_id · textrevoked · yes/no

Stáit agus imeachtaí

Sreabhú oibre beartaithe. Níl sé ar fáil sa bhéite reatha fós.

Stáit

scanner_status · text

Toradh reatha an ghnímh seo. Úsáid an imeacht críochnaithe comhoiriúnach sula sábhálfar an rath. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Toradh reatha an ghnímh seo. Úsáid an imeacht críochnaithe comhoiriúnach sula sábhálfar an rath. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Aitheantóir don mhír nó gníomh seo. Coinnigh é leis an taifead aipe comhoiriúnach. Úsáid an t-aithint iarratais chéanna nuair a dhéantar iarracht eile ar thoradh neamhchinnte.

pass_label · text

Luach reatha don mhír roghnaithe. Léigh é tar éis an imeachta gaolmhar. empty,access,event,coupon,membership

receipt_id · text

Aitheantóir don mhír nó gníomh seo. Coinnigh é leis an taifead aipe comhoiriúnach. Úsáid an t-aithint iarratais chéanna nuair a dhéantar iarracht eile ar thoradh neamhchinnte.

error_code · text

Faisnéis earráide don ghníomh deireanach. Taispeáin teachtaireacht chabhrach agus tairg an atriail chuí.

is_busy · yes/no

Tá an obair fós ar siúl. Fan sula dtosaíonn tú gníomh eile.

is_scanning · yes/no

Luach reatha don mhír roghnaithe. Léigh é tar éis an imeachta gaolmhar.

torch_enabled · yes/no

Luach reatha don mhír roghnaithe. Léigh é tar éis an imeachta gaolmhar.

scan_source · text

Luach reatha don mhír roghnaithe. Léigh é tar éis an imeachta gaolmhar. empty,camera,fixture

pending_redemption · yes/no

Luach reatha don mhír roghnaithe. Léigh é tar éis an imeachta gaolmhar.

scanned_pass_token · text

Luach reatha don mhír roghnaithe. Léigh é tar éis an imeachta gaolmhar.