QR eskaneatzaile interfazea. Erabilera bakarreko pasako ekintzak planifikatuak dira.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Eraiki erabili bakarreko tiketak, jasotze-berrespenak edo kupoiak. Langileek kodea eskaneatzen dute, emaitza egiaztatzen dute, eskaera aurreikusten dute eta erabilera baieztatzen dute prest daudenean bakarrik.

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.

Eraiki lan-fluxua ↓Plugin ezarpenak ↗Native Lab

Dokumentazioa berrikusi da 6 azaroan 2026

Adibide praktikoak

Egun bereko ekitaldirako erabilera bakarreko sarrera

QR balio arrunt baten pantaila-argazki bat bestela sarrera bat baino gehiagotan berrerabili daiteke.

Zure aplikazioak Admission erregistroa eta `request_id` egonkorrak gordetzen ditu; erabili `label=event` kuratua eta `ttl_seconds` 1‑86400 segunduko kontratuan.

Baimendutako jaulkitzaileak Issue QR pass exekutatzen du eta itzulitako QR modu pribatuan entregatzen du. Langileek eskaneatzen dute → Check QR pass → baieztatu `ok=yes` eta `status=available` baldin → Confirm QR redemption biltegiratutako eskaera ID egonkorrarekin.

`status=redeemed` eta `receipt_id` soilik baimentzen dute zure aplikazioaren admission agiria. Gorde pas/agiriaren erreferentzia Admissionean; ez erakutsi QR edukia analitiketan.

`outcome_unknown` gertatuz gero, berreskuratu eskaera bera erabiltzaile, ingurune eta QR txartel berarekin; ez sortu inoiz berrespen ID berririk. Tratatu expired eta revoked egoerak eta dagoeneko erabilitako txartelak emaitza bereizi gisa.

Planifikatua. Eskaneatzeak eta egiaztapenak ez dute pas-a erabiltzen; baieztapen esplizitua bakarrik egiten du.

Erabili behin iraupen laburrezko onura bat bazkide kontuarrean

Bazkide batek emaitza erabilita/erabili gabe baieztatua behar du, QR irudi edo pantaila animazioan konfidantza jartzearen ordez.

`label=coupon`; aplikazioaren Onura erregistroak eligibilitatea eta baliozkotasun leiho laburra zehazten du baimendutako jaulkipen ekintza aurretik.

Jaulki pas-a zure aplikazioaren eligibilitate egiaztapena egin ondoren soilik. Kontuarrean, Check QR pass erabilgarritasuna erakusten du kontsumitu gabe. Langileak onuraren entrega baieztatu ondoren, exekutatu Confirm QR redemption.

Zure Onura erregistroak `receipt_id` eta `status=redeemed` ondorengo baieztatutako erreskatze denbora gorde ditzake. Pluginak pas-egoera kudeatzen du; zure aplikazioak onura eta bezeroaren harremana kudeatzen ditu.

Onura bat erabilera aurretik bertan behera uzten bada, baimendutako jaulkitzaile bera Revoke QR pass egin dezake bere `pass_id` erabiliz. Ez iragarri itzulketa edo erreskatze arrakastatsua `ok=yes` bakarrik.

Planifikatua. Eskaneatzeak eta egiaztapenak ez dute pas-a erabiltzen; baieztapen esplizitua bakarrik egiten du.

Berretsi eguna berean ekipamendu edo eskaera jasotzea

Langileen lan-fluxuak bereiztu behar du bilduma erreferentzia eskaneatzea elementua benetan entregatzeaz.

Zure aplikazioaren jabetzako Bilduma erregistroak baimena, helburuko elementua eta jaulkipen/erreskatze eskaera ID egonkorrak gordetzen ditu; erabili iraupen laburrezko `label=access` pas-a.

Zure aplikazioak bilduma baimendu ondoren, Issue QR pass. Langileek eskaneatzen eta egiaztatzen dute, zure aplikazioan bat datorren Bilduma aztertzen dute, eta gero esplizituki baieztatzen dute entregapena eta Confirm QR redemption.

Baieztatutako `redeemed` agiria jaso ondoren soilik zure lan-fluxuak Bilduma entregaturik ezarri behar du. Mantendu `receipt_id` pas-emaeraren lotura gisa.

Eskaneatze errepikatu batek already_used itzuli dezake; erakutsi existitzen den aplikazio erregistroa elementu berri bat entregatu ordez. Berreskuratu baieztapen zalantzatsua ID eta sarrera berdinekin.

Planifikatua. Eskaneatzeak eta egiaztapenak ez dute pas-a erabiltzen; baieztapen esplizitua bakarrik egiten du.

Orain funtzionatzen duena

Beta pribatu. Uneko eskaneatzaileak kamera eta baimen-kontrolak ditu. Erabili bakarreko pasak sortzea, egiaztatzea eta baieztatzea planifikatuak dira eta oraindik ez daude zure aplikazioan erabilgarri.

Eraiki lan-fluxua

Planifikatuta

Planifikatutako lan-fluxua. Oraindik ez dago erabilgarri uneko beta bertsioan.

Adibide hauek Lesson, Message eta Order bezalako aplikazio erregistroak erabiltzen dituzte. Ordeztu zure datu motak eta elementu izenak erabiliz. Adibide media helbideak zure fitxategiekin ordeztu behar dira.

Planifikatuta: baimendutako langile batek Issue QR pass erabiltzen du Sarrera edo Order egiteko. Adibidea: label=event, ttl_seconds=900, environment=development. Mantendu request_id egonkor bat jaulkipen horretarako eta gorde pass_id erregistroarekin.
Erakutsi itzulitako QR bere hartzaileari. Langileek eskaneatzen dute. Planifikatutako pasoen lan-fluxuan, erabili workflow_mode=yes eta irakurri scanned_pass_token pass_scanned ondoren. Pasoen lan-fluxu ezarpen hauek ez daude erabilgarri uneko eskaneatzailean.
Exekutatu Check QR pass pass_token = QR Scanner's scanned_pass_token-rekin. Pasoa erabili gabe egiaztatzen du. status=available-rako, erakutsi dagokion eskaera edo sarrera xehetasunak langileek berrikusi ahal izateko.
Bakarrik bereizi Confirm botoi batek exekutatzen du Confirm QR redemption pass_token bera, request_id egonkorra eta confirm=yes. status=redeemed-n, gorde receipt_id eta markatu eskaera edo sarrera hori osatuta.
already_used, expired, revoked edo invalid esanahi du ez onartu edo ez eman eskaera. Eskaneatze bat edo Egiaztapen arrakastatsua bakarrik ez du transakzioa inoiz osatzen.

Lan-fluxuaren diagrama — ez da aplikazioaren pantaila-argazkia

Konfiguratu behin

Sortu edo aukeratu zure Bubble aplikazio-proiektua BestPlugins → Dashboard → Plugins. Aukeratu Xodera QR Passes Native, kopiatu bere gakoa, eta gero ireki Bubble → Plugins → Xodera QR Passes Native eta itsatsi project_api_key. Gorde behin; gero erabili beheko ekintzak. Proiektu bakoitzeko plugin bakoitzak bere gakoa du.

Eskaneatzeak kamera baimena behar du. Erabilera bakarreko pasoei, erabaki zeinek pasak sor ditzake eta zeinek atean edo jasotze puntuan egiaztatu ditzake. Bezero arruntek ez dute langileen rolarik behar.

`qr_issuer_permission_field`

qr_pass_issuer · Pasak sortzeko edo ezeztatzeko baimena duten langileak markatzen dituen User motako bai/ez eremuaren izena. Adibidea/lehenetsia: qr_pass_issuer. Idatzi eremuaren izena hemen, ez bai edo ez. Baimendutako administratzaile batek bakarrik aldatu beharko luke erabiltzaile baten baimen hori.

`qr_staff_permission_field`

qr_staff · Erabilera egiaztatzeko eta baieztatzeko baimena duten langileak markatzen dituen User motako bai/ez eremuaren izena. Adibidea/lehenetsia: qr_staff. Txartelaren titularrak ez du baimen hau behar. Mantendu eremu hau izen-emate eta profil inprimaki publikoetatik kanpo.

Konfiguratu behin

Sortu edo aukeratu zure Bubble aplikazio proiektua BestPlugins → Dashboard → Plugins.
Aukeratu plugin hau eta kopiatu bere proiektu gakoa.
Ireki Bubble → Plugins → Xodera QR Passes Native; itsatsi gakoa project_api_key-n eta gorde.
Gehitu elementua, aukeratu zure aplikazio datuak eta eraiki beheko lan-fluxua.
Beta pribatu sarbidea soilik momentuz. Instalazio publikoa eta aktibazio ordaindua oraindik ez daude irekita.

Instalazioa eta harpidetza

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.

Gorde emaitza zure aplikazioan

Adibidez Sarrera edo Jaso: gorde lotutako eskaera/gertaera, pass_id, expires_at eta issue_request_id. Erabilera baieztatu ondoren, gehitu receipt_id, redeemed_at eta baieztatu duen langilea. Ez markatu erregistroa osatuta kodea soilik eskaneatu edo egiaztatu denean. QR kodeak ez du pertsona baten identitatea egiaztatzen.

Hutsegitea, bertan behera uztea eta berreskuratzea

outcome_unknown=yes bada, mantendu pasak, request_id eta sarrerak emaitza berriro egiaztatzean. Ez sortu berrespen berririk. already_used, expired eta revoked negozio-emaitza finalak dira. Baimena ukatzen bada, eskatu baimendutako administratzaile bati langilearen rola berrikusteko. Clear session eskaneatzailea berrezartzen du; ezin du erabilera osatua desegin.

Gaitasunak eta mugak

Planifikatutako pasoak bakarra erabilerakoak dira, 1–86400 segunduko bizitza-aldiarekin; lehenetsia 900. Pasoen motak: access, event, coupon eta membership. Egiaztatzeak ez du pasoa erreserbatu. Internet sarbidea behar da pasoa erabiltzeko. Ez dago ordainketa prozesurik, identitate egiaztaketarik edo berrerabilgarri den epe luzeko bazkide-txartelik. QR balio arrunt bat irakurtzea pasoa egiaztatzeaz bereizten da.

Ezarpenak, ekintzak eta emaitzak

Erabili izen hauek Bubble-n. Planifikatutako ezaugarriak bereizita markatuta daude.

Beta ezarpen erabilgarriak

Elementu ezarpenak

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

Egoerak

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

Gertaerak

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Ekintzak eta haien sarrerak

Clear session

Elementu ezarpenak · 5

Planifikatutako lan-fluxua. Oraindik ez dago erabilgarri uneko beta bertsioan.

disabledyes/no · Lehenetsia: false: Adibide balioano; Adibide Bubble adierazpenaGuideHost's is_busy (your yes/no custom state); Ezgaitu elementua zure aplikazioa lanpetuta dagoen edo ekintza hau ez dago erabilgarri dagoen bitartean.

is_activeyes/no · Lehenetsia: true: Adibide balioayes; Adibide Bubble adierazpenaGuideHost's view_is_active (your yes/no custom state); Ezarri bai ikuspegi hau irekita dagoen bitartean. Ezarri ez irtetean, horrela erreprodukzioa edo uneko lana gelditu daiteke.

ui_text_jsontext · Lehenetsia: "{}": Adibide balioa{}; Adibide Bubble adierazpenaApp Settings' player_labels_json (supported keys only); Aukerako JSON onartutako botoi-etiketeekin. Utzi hutsik integratutako testua erabiltzeko.

languagetext · Lehenetsia: "auto": Adibide balioauk; Adibide Bubble adierazpenaCurrent User's preferred_language; Ezarri language=auto onartutako gailu edo nabigatzaile hizkuntza jarraitzeko. Sartu onartutako hizkuntza kodea hura esplizituki aukeratzeko.

workflow_modeyes/no · Lehenetsia: false: Adibide balioayes; Adibide Bubble adierazpenaApp Settings' use_qr_business_actions; Planifikatua: baimendu eskaneatutako QR balioa Check QR pass erabiltzea. Eskaneatzeak bakarrik ez du sarrera edo jasotzea baieztatzen.

Ekintzak eta haien sarrerak · 5

Planifikatutako lan-fluxua. Oraindik ez dago erabilgarri uneko beta bertsioan.

Clear session

Ekintza-parametrorik ez

Issue QR pass

environmenttext · Lehenetsia: "development": Adibide balioadevelopment; Adibide Bubble adierazpenaApp Settings' selected_environment; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

request_idtext · Lehenetsia: —: Adibide balioapickup-123-issue-v1; Adibide Bubble adierazpenaCurrent Admission's stable_request_id; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

labeltext · Lehenetsia: "access": Adibide balioaevent; Adibide Bubble adierazpenaSelected Admission's pass_label; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

ttl_secondsnumber · Lehenetsia: 900: Adibide balioa900; Adibide Bubble adierazpenaEvent Settings' pass_ttl_seconds; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

Itzulketa

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

Check QR pass

environmenttext · Lehenetsia: "development": Adibide balioadevelopment; Adibide Bubble adierazpenaApp Settings' selected_environment; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

pass_tokentext · Lehenetsia: —: Adibide balioa<opaque token returned by Issue / camera scan>; Adibide Bubble adierazpenaQR Pass Scanner's scanned_pass_token (capture before Check); Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

Itzulketa

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Lehenetsia: "development": Adibide balioadevelopment; Adibide Bubble adierazpenaApp Settings' selected_environment; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

pass_tokentext · Lehenetsia: —: Adibide balioa<opaque token returned by Issue / camera scan>; Adibide Bubble adierazpenaQR Pass Scanner's scanned_pass_token (capture before Check); Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

request_idtext · Lehenetsia: —: Adibide balioapickup-123-redeem-v1; Adibide Bubble adierazpenaCurrent Admission's stable_redemption_request_id; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

confirmyes/no · Lehenetsia: false: Adibide balioayes — explicit confirmation only; Adibide Bubble adierazpenaConfirm Checkbox is checked; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

Itzulketa

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

Revoke QR pass

environmenttext · Lehenetsia: "development": Adibide balioadevelopment; Adibide Bubble adierazpenaApp Settings' selected_environment; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

pass_idtext · Lehenetsia: —: Adibide balioa<pass_id returned by Issue>; Adibide Bubble adierazpenaSelected Admission's pass_id; Erabili uneko negozio-erregistroaren balioa; balioztatu beheko mugen aurka.

Itzulketa

pass_id · textrevoked · yes/no

Egoerak eta gertaerak

Planifikatutako lan-fluxua. Oraindik ez dago erabilgarri uneko beta bertsioan.

Egoerak

scanner_status · text

Ekintza honen uneko emaitza. Erabili bat datorren osatze-gertaera arrakasta gordetzeko aurretik. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Ekintza honen uneko emaitza. Erabili bat datorren osatze-gertaera arrakasta gordetzeko aurretik. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Elementu edo ekintza honen identifikatzailea. Mantendu aplikazioaren erregistro dagokionarekin. Erabili eskaera-identifikatzaile bera emaitza zalantz bat berriro saiatzeko.

pass_label · text

Hautatutako elementuarentzako uneko balioa. Irakurri erlazionatutako ekitaldiaren ondoren. empty,access,event,coupon,membership

receipt_id · text

Elementu edo ekintza honen identifikatzailea. Mantendu aplikazioaren erregistro dagokionarekin. Erabili eskaera-identifikatzaile bera emaitza zalantz bat berriro saiatzeko.

error_code · text

Azken ekintzaren errore informazioa. Erakutsi mezu lagungarria eta eskaini dagokion saiakera berriro.

is_busy · yes/no

Lana oraindik lanean dago. Itxaron beste ekintza bat hasteko.

is_scanning · yes/no

Hautatutako elementuaren uneko balioa. Irakurri erlazionatutako gertaeraren ondoren.

torch_enabled · yes/no

Hautatutako elementuaren uneko balioa. Irakurri erlazionatutako gertaeraren ondoren.

scan_source · text

Hautatutako elementuarentzako uneko balioa. Irakurri erlazionatutako ekitaldiaren ondoren. empty,camera,fixture

pending_redemption · yes/no

Hautatutako elementuaren uneko balioa. Irakurri erlazionatutako gertaeraren ondoren.

scanned_pass_token · text

Hautatutako elementuaren uneko balioa. Irakurri erlazionatutako gertaeraren ondoren.