Rhyngwyneb sganer QR. Cynlluniwyd gweithredoedd pas un defnydd.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Crëwch docynnau un-defnydd, cadarnhadau casglu neu gwponau. Mae staff yn sganio'r cod, gwirio'r canlyniad, edrych ar ragolwg o'r archeb a chadarnhau'r defnydd dim ond pan fyddant yn barod.

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.

Creu'r gweithdull ↓Gosodiadau ategyn ↗Native Lab

Dogfennaeth wedi’i hadolygu ar 6 Tachwedd 2026

Enghreifftiau ymarferol

Caniatâd un-defnydd ar gyfer digwyddiad un diwrnod

Gall llun sgrin o werth QR arferol gael ei ailddefnyddio mewn mwy nag un mynediad.

Mae eich ap yn storio cofnod Admission a `request_id` sefydlog ar gyfer rhoi'r pas; defnyddiwch y `label=event` a ddewiswyd a `ttl_seconds` o fewn y terfyn 1–86400 eiliad.

Mae rhoddwr awdurdodedig yn rhedeg Issue QR pass ac yn anfon y QR a ddychwelwyd yn breifat. Mae staff yn sganio → Check QR pass → cadarnhau dim ond os oes `ok=yes` a `status=available` → Confirm QR redemption gyda ID cais sefydlog wedi'i storio.

Dim ond `status=redeemed` a `receipt_id` sy'n awdurdodi derbynneb eich app. Storio'r cyfeiriad pas/derbynneb ar y Caniatâd; peidiwch â datgelu cynnwys QR i ddadansoddiadau.

Ar gyfer `outcome_unknown`, adferwch yr un cais gyda'r un defnyddiwr, amgylchedd a phas; peidiwch byth â chynhyrchu ID cadarnhau newydd. Triniwch expired, revoked a chyflyrau a ddefnyddiwyd eisoes fel canlyniadau gwahanol.

Cynlluniedig. Nid yw sganio na gwirio yn cyfrif fel defnydd o'r pas; dim ond cadarnhad penodol sy'n cyfrif fel ei ddefnyddio.

Defnyddio budd byrhoedlog unwaith wrth gownter partner

Mae partner angen canlyniad wedi'i gadarnhau wedi'i ddefnyddio/heb ei ddefnyddio yn lle dibynnu ar ddelwedd QR neu animeiddiad sgrin.

`label=coupon`; mae cofnod Budd yr app yn diffinio cymhwysedd a ffenestr dilysrwydd fyr cyn gweithred awdurdodedig o gyhoeddi.

Rhowch bas dim ond ar ôl i'ch ap wirio cymhwysedd. Wrth y cownter, mae Check QR pass yn dangos argaeledd heb ddefnyddio'r pas. Ar ôl i'r aelod o staff gadarnhau bod y budd wedi'i roi, rhedwch Confirm QR redemption.

Gall eich cofnod Benefit storio `receipt_id` ac amser y defnydd wedi'i gadarnhau ar ôl `status=redeemed`. Mae'r ategyn yn rheoli cyflwr y pas; mae eich ap yn rheoli'r budd a'r berthynas â'r cwsmer.

Os caiff budd ei ganslo cyn ei ddefnyddio, gall yr un rhoddwr awdurdodedig redeg Revoke QR pass gan ddefnyddio ei `pass_id`. Peidiwch â chyhoeddi ad-daliad na defnydd llwyddiannus o'r pas ar sail `ok=yes` yn unig.

Cynlluniedig. Nid yw sganio na gwirio yn cyfrif fel defnydd o'r pas; dim ond cadarnhad penodol sy'n cyfrif fel ei ddefnyddio.

Cadarnhewch gasglu offer neu archeb yr un diwrnod.

Mae llif gwaith staff angen gwahaniaethu rhwng sganio cyfeiriad casgliad a rhoi'r eitem mewn gwirionedd.

Mae cofnod Collection eich ap ei hun yn cadw'r awdurdodiad, yr eitem fwriadedig ac IDau cais sefydlog ar wahân ar gyfer rhoi a defnyddio'r pas; defnyddiwch bas byrhoedlog `label=access`.

Ar ôl i'ch ap awdurdodi casglu'r eitem, rhedwch Issue QR pass. Mae staff yn sganio ac yn defnyddio Check, yn archwilio'r Collection cyfatebol yn eich ap, ac yna'n cadarnhau'n benodol bod yr eitem wedi'i rhoi i'r person ac yn rhedeg Confirm QR redemption.

Dim ond ar ôl cadarnhad `redeemed` y dylai eich llif gwaith farcio Collection fel un sydd wedi'i roi i'r person. Cadwch `receipt_id` fel y ddolen i ganlyniad y pas.

Gall sganio ailadroddus ddychwelyd already_used; dangos y cofnod app presennol yn lle trosglwyddo eitem arall. Adfer cadarnhad ansicr gyda'r un ID a mewnbynnau.

Cynlluniedig. Nid yw sganio na gwirio yn cyfrif fel defnydd o'r pas; dim ond cadarnhad penodol sy'n cyfrif fel ei ddefnyddio.

Beth sy'n gweithio nawr

Beta breifat. Mae'r sganer cyfredol yn cynnwys rheolaethau camera a chaniatâd. Mae creu, gwirio a chadarnhau pasiau un-defnydd wedi'i gynllunio ac nid yw'n barod i'w ddefnyddio yn eich app eto.

Creu'r gweithdull

Cynlluniedig

Llif gwaith wedi'i gynllunio. Nid yw ar gael yn y beta presennol eto.

Defnyddir y enghreifftiau hyn cofnodion app fel Lesson, Message a Order. Disodlwch nhw gyda'ch mathau data eich hun a enwau elfennau. Rhaid disodli cyfeiriadau cyfryngau enghreifftiol gyda'ch ffeiliau eich hun.

Cynlluniedig: mae gweithiwr awdurdodedig yn defnyddio Issue QR pass ar gyfer Admission neu Order. Enghraifft: label=event, ttl_seconds=900, environment=development. Cadwch request_id sefydlog ar gyfer y rhoi hwnnw a chadwch pass_id gyda'r cofnod.
Dangoswch QR a ddychwelwyd i'r deiliad bwriedig. Mae staff yn ei sganio. Yn y llif gwaith pas wedi'i gynllunio, defnyddiwch workflow_mode=yes a darllen scanned_pass_token ar ôl pass_scanned. Nid yw'r gosodiadau llif gwaith pas hyn ar gael yn y sganer cyfredol.
Rhedwch Check QR pass gyda pass_token = QR Scanner's scanned_pass_token. Mae'n gwirio heb ddefnyddio'r pas. Ar gyfer status=available, dangoswch fanylion yr archeb neu'r mynediad cyfatebol fel y gall staff eu hadolygu.
Dim ond botwm Confirm ar wahân sy'n rhedeg Confirm QR redemption gyda'r un pass_token, request_id sefydlog a confirm=yes. Ar status=redeemed, cadwch receipt_id a marciwch yr archeb neu'r mynediad hwnnw fel un wedi'i gwblhau.
Mae already_used, expired, revoked neu invalid yn golygu peidio â chaniatáu mynediad na rhoi'r archeb i'r person. Nid yw sgan na Check llwyddiannus ar ei ben ei hun byth yn cwblhau'r trafodyn.

Diagram llif gwaith — nid sgrinlun app

Ffurfweddu unwaith

Creuwch neu dewiswch eich prosiect app Bubble yn BestPlugins → Dashboard → Plugins. Dewiswch Xodera QR Passes Native, copïwch ei allwedd, yna agorwch Bubble → Plugins → Xodera QR Passes Native a'i gludo i project_api_key. Cadwch unwaith; yna defnyddiwch y gweithredoedd isod. Mae gan bob ategyn mewn pob prosiect ei allwedd ei hun.

Mae sganio angen caniatâd camera. Ar gyfer pasiau un-defnydd, penderfynwch pwy all greu pasiau a phwy all eu gwirio wrth y drws neu'r pwynt casglu. Nid oes angen rôl staff i gwsmeriaid arferol.

`qr_issuer_permission_field`

qr_pass_issuer · Enw'r maes yes/no ar User sy'n nodi gweithwyr sydd â chaniatâd i greu neu ddiddymu pasiau. Enghraifft/rhagosodiad: qr_pass_issuer. Rhowch enw'r maes yma, nid yes na no. Dim ond gweinyddwr awdurdodedig ddylai newid y caniatâd hwn ar ddefnyddiwr.

`qr_staff_permission_field`

qr_staff · Enw'r maes yes/no ar User sy'n nodi staff sydd â chaniatâd i wirio a chadarnhau defnydd. Enghraifft/rhagosodiad: qr_staff. Nid oes angen y caniatâd hwn ar ddeiliad tocyn. Cadwch ef allan o ffurflenni cofrestru a phroffil cyhoeddus.

Ffurfweddu unwaith

Creuwch neu dewiswch eich prosiect app Bubble yn BestPlugins → Dashboard → Plugins.
Dewiswch yr ategyn hwn a chopiwch ei allwedd prosiect.
Agorwch Bubble → Plugins → Xodera QR Passes Native; gludo'r allwedd i project_api_key a chadw.
Ychwanegwch yr elfen, dewiswch eich data app a chreu'r llif gwaith isod.
Mynediad beta preifat dim ond ar hyn o bryd. Nid yw gosod cyhoeddus a gweithrediad taledig ar gael eto.

Gosod a thanysgrifiad

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.

Cadw'r canlyniad yn eich ap

Enghraifft Admission neu Pickup: cadwch yr archeb neu'r digwyddiad cysylltiedig, pass_id, expires_at ac issue_request_id. Ar ôl defnydd wedi'i gadarnhau, ychwanegwch receipt_id, redeemed_at a'r gweithiwr a gadarnhaodd. Peidiwch â marcio'r cofnod fel un wedi'i gwblhau pan fo'r cod wedi'i sganio neu ei wirio yn unig. Nid yw cod QR yn gwirio hunaniaeth person.

Methiant, canslo a adfer

Os yw outcome_unknown=yes, cadwch yr un pas, request_id a'r mewnbynnau wrth wirio'r canlyniad eto. Peidiwch â chreu cadarnhad newydd. Mae already_used, expired a revoked yn ganlyniadau busnes terfynol. Os caiff caniatâd ei wrthod, gofynnwch i weinyddwr awdurdodedig adolygu rôl y gweithiwr. Mae Clear session yn ailosod y sganer; ni all ddadwneud defnydd wedi'i gwblhau.

Galluoedd a chyfyngiadau

Mae'r pasiau sydd wedi'u cynllunio ar gyfer un defnydd, gyda chyfnod dilysrwydd o 1–86400 eiliad; y rhagosodiad yw 900. Mathau pas: access, event, coupon a membership. Nid yw gwirio yn cadw pas o'r neilltu. Mae angen mynediad i'r rhyngrwyd i ddefnyddio pas. Dim prosesu taliadau, gwirio hunaniaeth na cherdyn aelodaeth hirdymor y gellir ei ailddefnyddio. Mae darllen gwerth QR arferol ar wahân i wirio pas.

Gosodiadau, gweithredoedd a chanlyniadau

Defnyddiwch y enwau hyn yn Bubble. Nodir nodweddion a gynlluniwyd ar wahân.

Gosodiadau beta ar gael

Gosodiadau elfen

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

Cyflyrau

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

Digwyddiadau

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Gweithredoedd a'u mewnbynnau

Clear session

Gosodiadau elfen · 5

Llif gwaith wedi'i gynllunio. Nid yw ar gael yn y beta presennol eto.

disabledyes/no · Rhagosodedig: false: Gwerth enghreifftiolno; Enghraifft o fynegiad BubbleGuideHost's is_busy (your yes/no custom state); Analluogwch yr elfen tra mae eich app yn brysur neu mae'r weithred hon ddim ar gael.

is_activeyes/no · Rhagosodedig: true: Gwerth enghreifftiolyes; Enghraifft o fynegiad BubbleGuideHost's view_is_active (your yes/no custom state); Gosodwch yes tra bo'r olygfa hon ar agor. Gosodwch no wrth adael, fel y gall chwarae neu'r gwaith cyfredol stopio.

ui_text_jsontext · Rhagosodedig: "{}": Gwerth enghreifftiol{}; Enghraifft o fynegiad BubbleApp Settings' player_labels_json (supported keys only); JSON dewisol gyda labeli botwm sy'n cael eu cefnogi. Gadewch yn wag i ddefnyddio'r testun mewnol.

languagetext · Rhagosodedig: "auto": Gwerth enghreifftioluk; Enghraifft o fynegiad BubbleCurrent User's preferred_language; Gosodwch language=auto i ddilyn iaith y ddyfais neu'r porwr, os yw'r iaith honno'n cael ei chefnogi. Rhowch god iaith a gefnogir i ddewis yr iaith yn benodol.

workflow_modeyes/no · Rhagosodedig: false: Gwerth enghreifftiolyes; Enghraifft o fynegiad BubbleApp Settings' use_qr_business_actions; Cynlluniedig: caniatáu i'r gwerth QR a sganiwyd gael ei ddefnyddio gan Check QR pass. Nid yw sganio ar ei ben ei hun yn cadarnhau mynediad na chasglu.

Gweithredoedd a'u mewnbynnau · 5

Llif gwaith wedi'i gynllunio. Nid yw ar gael yn y beta presennol eto.

Clear session

Dim paramedrau gweithred

Issue QR pass

environmenttext · Rhagosodedig: "development": Gwerth enghreifftioldevelopment; Enghraifft o fynegiad BubbleApp Settings' selected_environment; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

request_idtext · Rhagosodedig: —: Gwerth enghreifftiolpickup-123-issue-v1; Enghraifft o fynegiad BubbleCurrent Admission's stable_request_id; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

labeltext · Rhagosodedig: "access": Gwerth enghreifftiolevent; Enghraifft o fynegiad BubbleSelected Admission's pass_label; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

ttl_secondsnumber · Rhagosodedig: 900: Gwerth enghreifftiol900; Enghraifft o fynegiad BubbleEvent Settings' pass_ttl_seconds; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

Dychweliadau

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

Check QR pass

environmenttext · Rhagosodedig: "development": Gwerth enghreifftioldevelopment; Enghraifft o fynegiad BubbleApp Settings' selected_environment; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

pass_tokentext · Rhagosodedig: —: Gwerth enghreifftiol<opaque token returned by Issue / camera scan>; Enghraifft o fynegiad BubbleQR Pass Scanner's scanned_pass_token (capture before Check); Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

Dychweliadau

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Rhagosodedig: "development": Gwerth enghreifftioldevelopment; Enghraifft o fynegiad BubbleApp Settings' selected_environment; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

pass_tokentext · Rhagosodedig: —: Gwerth enghreifftiol<opaque token returned by Issue / camera scan>; Enghraifft o fynegiad BubbleQR Pass Scanner's scanned_pass_token (capture before Check); Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

request_idtext · Rhagosodedig: —: Gwerth enghreifftiolpickup-123-redeem-v1; Enghraifft o fynegiad BubbleCurrent Admission's stable_redemption_request_id; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

confirmyes/no · Rhagosodedig: false: Gwerth enghreifftiolyes — explicit confirmation only; Enghraifft o fynegiad BubbleConfirm Checkbox is checked; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

Dychweliadau

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

Revoke QR pass

environmenttext · Rhagosodedig: "development": Gwerth enghreifftioldevelopment; Enghraifft o fynegiad BubbleApp Settings' selected_environment; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

pass_idtext · Rhagosodedig: —: Gwerth enghreifftiol<pass_id returned by Issue>; Enghraifft o fynegiad BubbleSelected Admission's pass_id; Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.

Dychweliadau

pass_id · textrevoked · yes/no

Cyflyrau a digwyddiadau

Llif gwaith wedi'i gynllunio. Nid yw ar gael yn y beta presennol eto.

Cyflyrau

scanner_status · text

Canlyniad cyfredol y weithred hon. Defnyddiwch y digwyddiad cwblhau cyfatebol cyn arbed llwyddiant. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Canlyniad cyfredol y weithred hon. Defnyddiwch y digwyddiad cwblhau cyfatebol cyn arbed llwyddiant. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Dynodydd ar gyfer yr eitem neu'r weithred hon. Cadwch ef gyda'r cofnod app cyfatebol. Defnyddiwch yr un dynodydd cais wrth ail-geisio canlyniad ansicr.

pass_label · text

Gwerth cyfredol yr eitem ddewisiedig. Darllenwch ef ar ôl y digwyddiad cysylltiedig. empty,access,event,coupon,membership

receipt_id · text

Dynodydd ar gyfer yr eitem neu'r weithred hon. Cadwch ef gyda'r cofnod app cyfatebol. Defnyddiwch yr un dynodydd cais wrth ail-geisio canlyniad ansicr.

error_code · text

Gwybodaeth gwall am y weithred diwethaf. Dangoswch neges ddefnyddiol a chynnig y ceisiad ailadrodd perthnasol.

is_busy · yes/no

Mae'r gwaith dal yn mynd rhagddo. Arhoswch cyn cychwyn gweithred arall.

is_scanning · yes/no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

torch_enabled · yes/no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

scan_source · text

Gwerth cyfredol yr eitem ddewisiedig. Darllenwch ef ar ôl y digwyddiad cysylltiedig. empty,camera,fixture

pending_redemption · yes/no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

scanned_pass_token · text

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.