Xodera Plugins · Bubble Native
Xodera QR Passes Native
Jenga tiketi za matumizi moja, uthibitisho wa kuchukua agizo au kuponi. Wafanyakazi huscan nambari, hukagua matokeo, kuangalia agizo na kuthibitisha matumizi tu wanapokuwa tayari.
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.
Nyaraka zilizokaguliwa 6 Novemba 2026
Mifano ya vitendo
Uingilio wa matumizi moja kwa tukio linalofanyika siku hiyo hiyo
Picha ya skrini ya thamani ya kawaida ya QR inaweza kutumika tena kwenye zaidi ya lango moja.
Programu yako huhifadhi rekodi ya Admission na `request_id` thabiti ya utoaji wa pasi; tumia `label=event` iliyochaguliwa na `ttl_seconds` iliyo ndani ya kikomo cha sekunde 1–86400.
Mtoaji aliyeidhinishwa huendesha Issue QR pass na hutoa kwa faragha QR iliyorejeshwa. Wafanyakazi huskania → Check QR pass → thibitisha tu ikiwa `ok=yes` na `status=available` → Confirm QR redemption kwa ID ya ombi thabiti iliyohifadhiwa.
Ni `status=redeemed` pamoja na `receipt_id` pekee vinavyoruhusu uthibitisho wa kuingia katika programu yako. Hifadhi rejea ya pasi/uthibitisho kwenye rekodi ya Admission; usifichue yaliyomo kwenye QR kwa mifumo ya uchanganuzi.
Kwa `outcome_unknown`, rudia ombi lile lile na mtumiaji/mazingira/pasi sawa; usizalie ID mpya ya uthibitisho. Shughulikia hali za expired, revoked na zilizotumika tayari kama matokeo tofauti.
Imepangwa. Kuskan na kukagua havitumii pasi; kitendo cha wazi cha kuthibitisha pekee ndicho huitumia.
Tumia faida ya muda mfupi mara moja katika kaunta ya washirika
Mshirika anahitaji matokeo yaliyothibitishwa ya kutumika/kusitumika badala ya kuamini picha ya QR au uhuishaji wa skrini.
`label=coupon`; rekodi ya Faida ya programu inaelezea kustahiki na dirisha fupi la uhalali kabla ya kitendo cha utoaji kilichoruhusiwa.
Toa pasi baada ya ukaguzi wa kustahiki wa programu yako. Katika kaunta, Check QR pass inaonyesha upatikanaji bila kuitumia. Baada mfanyakazi kuthibitisha utoaji wa faida, endesha Confirm QR redemption.
Rekodi yako ya Faida inaweza kuhifadhi `receipt_id` na wakati wa matumizi yaliyothibitishwa baada ya `status=redeemed`. Kiendelezo hushughulikia hali ya pasi; programu yako hushughulikia faida na uhusiano wa wateja.
Kama faida itaghairiwa kabla ya matumizi, mtoaji yule yule aliyeidhinishwa anaweza Revoke QR pass kwa kutumia `pass_id` ya pasi hiyo. Usitangaze kurejesha pesa au matumizi ya pasi yaliyofanikiwa kutoka `ok=yes` pekee.
Imepangwa. Kuskan na kukagua havitumii pasi; kitendo cha wazi cha kuthibitisha pekee ndicho huitumia.
Thibitisha ukusanyaji wa vifaa au agizo siku hiyo hiyo
Mtiririko wa kazi wa wafanyakazi unahitaji kutofautisha kuskani rejea ya kuchukua bidhaa na kuikabidhi bidhaa yenyewe.
Rekodi ya Collection inayomilikiwa na programu yako huhifadhi idhini, bidhaa iliyokusudiwa na vitambulisho tofauti na thabiti vya maombi ya kutoa pasi na kuthibitisha matumizi yake; tumia pasi ya muda mfupi yenye `label=access`.
Baada ya programu yako kuidhinisha kuchukua bidhaa, endesha Issue QR pass. Wafanyakazi huskan na kufanya Check, hukagua rekodi ya Collection inayolingana katika programu yako, kisha huthibitisha wazi kukabidhi bidhaa na kufanya Confirm QR redemption.
Ni baada ya risiti ya `redeemed` iliyothibitishwa pekee tu mtiririko wako wa kazi uweke rekodi ya Collection kuwa imekabidhiwa. Hifadhi `receipt_id` kama kiungo cha matokeo ya pasi.
Kuskan tena unaweza kurudisha already_used; onyesha rekodi iliyopo ya programu badala ya kutoa kipengee kingine. Rudisha uthibitisho usio na uhakika kwa ID na ingizo sawa.
Imepangwa. Kuskan na kukagua havitumii pasi; kitendo cha wazi cha kuthibitisha pekee ndicho huitumia.
Kinachofanya kazi sasa
Beta iliyofungwa. Skana ya sasa ina udhibiti wa kamera na ruhusa. Kuunda, kukagua na kuthibitisha pasi za matumizi mara moja vimepangwa lakini bado haviko tayari kutumika katika programu yako.
Jenga mtiririko wa kazi
Imepangwa
Mwendo wa kazi uliopangwa. Bado haipatikani katika beta ya sasa.
Mifano hii inatumia rekodi za programu kama Lesson, Message na Order. Zibadilishe kwa aina zako za data na majina ya vipengele. Anwani za media za mfano lazima zibadilishwe na faili zako.
Imepangwa: mfanyakazi aliyeidhinishwa anatumia Issue QR pass kwa rekodi ya Admission au Order. Mfano: label=event, ttl_seconds=900, environment=development. Hifadhi request_id thabiti kwa utoaji huo wa pasi na hifadhi pass_id pamoja na rekodi.
Onyesha QR iliyorejeshwa kwa mmiliki wake anayetarajiwa. Wafanyikazi wanai skana. Katika mtiririko wa kazi wa pasi uliopangwa, tumia workflow_mode=yes na soma scanned_pass_token baada ya pass_scanned. Mipangilio hii ya mtiririko wa pasi haipatikani katika skana ya sasa.
Endesha Check QR pass na pass_token = QR Scanner's scanned_pass_token. Inakagua bila kutumia pasi. Kwa status=available, onyesha agizo au maelezo yanayolingana ili wafanyikazi waweze kuyapitia.
Ni kitufe cha Confirm kilichotenganishwa pekee kinachotekeleza Confirm QR redemption kwa pass_token ileile, request_id thabiti na confirm=yes. Katika status=redeemed, hifadhi receipt_id na weka agizo au ingizo hilo likamilike.
already_used, expired, revoked au invalid ina maana usiruhusu mtu kuingia na usikabidhi agizo. Skani au Check iliyofanikiwa peke yake haikamilishi muamala kamwe.
Sanidi mara moja
Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins. Chagua Xodera QR Passes Native, nakili ufunguo wake, kisha fungua Bubble → Plugins → Xodera QR Passes Native na ubandike ndani ya project_api_key. Hifadhi mara moja; kisha tumia vitendo hapa chini. Kila plugin katika kila mradi ina ufunguo wake.
Kuskan kunahitaji ruhusa ya kamera. Kwa pasi za matumizi mara moja, amua nani anaweza kuziunda na nani anaweza kuzikagua mlangoni au mahali pa kuchukua agizo. Wateja wa kawaida hawahitaji jukumu la mfanyakazi anayeunda pasi wala la anayezikagua.
qr_issuer_permission_field
qr_pass_issuer · Jina la uga wa yes/no katika rekodi ya User unaoonyesha wafanyakazi wanaoruhusiwa kuunda au kubatilisha pasi. Mfano/chaguo-msingi: qr_pass_issuer. Weka jina la uga hapa, si yes au no. Ni msimamizi aliyeidhinishwa pekee anayepaswa kubadilisha ruhusa hiyo kwa mtumiaji.
qr_staff_permission_field
qr_staff · Jina la uga wa yes/no katika rekodi ya User unaoonyesha wafanyakazi wanaoruhusiwa kukagua na kuthibitisha matumizi. Mfano/chaguo-msingi: qr_staff. Mwenye tiketi hahitaji ruhusa hii. Usiuweke kwenye fomu za usajili wa umma na wasifu.
Sanidi mara moja
- Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins.
- Chagua plugin hii na nakili ufunguo wa mradi wake.
- Fungua Bubble → Plugins → Xodera QR Passes Native; bandika ufunguo ndani ya project_api_key na uhifadhi.
- Ongeza kipengele, chagua data ya programu yako na jenga mtiririko wa kazi hapa chini.
- Ufikiaji wa beta iliyofungwa kwa sasa tu. Usakinishaji wa umma na uanzishaji wa kulipia bado haujafunguliwa.
Ufungaji na usajili
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.
Hifadhi matokeo katika programu yako
Mfano wa Admission au Pickup: hifadhi agizo/tukio linalohusiana, pass_id, expires_at na issue_request_id. Baada ya matumizi kuthibitishwa, ongeza receipt_id, redeemed_at na mfanyakazi aliyethibitisha. Usiweke alama kuwa rekodi imekamilika ikiwa msimbo umeskaniwa au kukaguliwa tu. Msimbo wa QR hauhakiki utambulisho wa mtu.
Kushindwa, kughairi na urejeshaji
Kama outcome_unknown=yes, weka pasi ile ile, request_id na ingizo wakati unakagua matokeo tena. Usijenge uthibitisho mpya. already_used, expired na revoked ni matokeo ya mwisho ya biashara. Ikiwa ruhusa imekataliwa, muulize msimamizi aliyeidhinishwa akague jukumu la mfanyakazi. Clear session huweka upya skana; haiwezi kutengua matumizi yaliyokamilika.
Uwezo na vikwazo
Pasi zilizopangwa ni za matumizi moja, zikiwa na muda wa maisha wa 1–86400 sekunde; chaguo-msingi 900. Aina za pasi: access, event, coupon na membership. Ukaguzi hauweki pasi akiba kwa matumizi ya baadaye. Upatikanaji wa mtandao unahitajika kwa matumizi ya pasi. Hakuna usindikaji wa malipo, ukaguzi wa utambulisho, au kadi ya uanachama ya muda mrefu inayoweza kutumika tena. Kusoma thamani ya kawaida ya QR ni tofauti na kukagua pasi.
Mipangilio, vitendo na matokeo
Tumia majina haya katika Bubble. Vipengele vilivyopangwa vimewekwa alama kando.
Mipangilio ya beta inayopatikana
Mipangilio ya kipengele
disabled · yes/nois_active · yes/noui_text_json · textlanguage · textHali
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/noMatukio
scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_errorVitendo na ingizo lake
Clear sessionMipangilio ya kipengele · 5
Mwendo wa kazi uliopangwa. Bado haipatikani katika beta ya sasa.
disabledyes/no · Chaguo-msingi: false- Thamani ya mfano
no - Mfano wa usemi Bubble
GuideHost's is_busy (your yes/no custom state) - Zima kipengele wakati programu yako ina shughuli au kitendo hiki hakipatikani.
is_activeyes/no · Chaguo-msingi: true- Thamani ya mfano
yes - Mfano wa usemi Bubble
GuideHost's view_is_active (your yes/no custom state) - Weka yes (ndiyo) wakati mwonekano huu uko wazi. Weka no (hapana) unapoondoka, ili uchezaji au kazi ya sasa viweze kusimamishwa.
ui_text_jsontext · Chaguo-msingi: "{}"- Thamani ya mfano
{} - Mfano wa usemi Bubble
App Settings' player_labels_json (supported keys only) - JSON ya hiari yenye lebo za vitufe zinazotumika. Iache tupu ili kutumia maandishi yaliyojengewa ndani.
languagetext · Chaguo-msingi: "auto"- Thamani ya mfano
uk - Mfano wa usemi Bubble
Current User's preferred_language - Weka language=auto ili kufuata lugha inayotumika ya kifaa au kivinjari. Ingiza msimbo wa lugha inayotumika ili kuichagua mwenyewe.
workflow_modeyes/no · Chaguo-msingi: false- Thamani ya mfano
yes - Mfano wa usemi Bubble
App Settings' use_qr_business_actions - Imepangwa: ruhusu thamani ya QR iliyochanganuliwa itumike na Check QR pass. Kuchanganua pekee hakuthibitishi kuingia au kuchukua bidhaa.
Vitendo na ingizo lake · 5
Mwendo wa kazi uliopangwa. Bado haipatikani katika beta ya sasa.
Clear session
Hakuna vigezo vya kitendo
Issue QR pass
environmenttext · Chaguo-msingi: "development"- Thamani ya mfano
development - Mfano wa usemi Bubble
App Settings' selected_environment - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
request_idtext · Chaguo-msingi: —- Thamani ya mfano
pickup-123-issue-v1 - Mfano wa usemi Bubble
Current Admission's stable_request_id - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
labeltext · Chaguo-msingi: "access"- Thamani ya mfano
event - Mfano wa usemi Bubble
Selected Admission's pass_label - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
ttl_secondsnumber · Chaguo-msingi: 900- Thamani ya mfano
900 - Mfano wa usemi Bubble
Event Settings' pass_ttl_seconds - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Thamani zinazorejeshwa
pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/noCheck QR pass
environmenttext · Chaguo-msingi: "development"- Thamani ya mfano
development - Mfano wa usemi Bubble
App Settings' selected_environment - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
pass_tokentext · Chaguo-msingi: —- Thamani ya mfano
<opaque token returned by Issue / camera scan> - Mfano wa usemi Bubble
QR Pass Scanner's scanned_pass_token (capture before Check) - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Thamani zinazorejeshwa
pass_label · textexpires_at · textConfirm QR redemption
environmenttext · Chaguo-msingi: "development"- Thamani ya mfano
development - Mfano wa usemi Bubble
App Settings' selected_environment - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
pass_tokentext · Chaguo-msingi: —- Thamani ya mfano
<opaque token returned by Issue / camera scan> - Mfano wa usemi Bubble
QR Pass Scanner's scanned_pass_token (capture before Check) - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
request_idtext · Chaguo-msingi: —- Thamani ya mfano
pickup-123-redeem-v1 - Mfano wa usemi Bubble
Current Admission's stable_redemption_request_id - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
confirmyes/no · Chaguo-msingi: false- Thamani ya mfano
yes — explicit confirmation only - Mfano wa usemi Bubble
Confirm Checkbox is checked - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Thamani zinazorejeshwa
pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/noRevoke QR pass
environmenttext · Chaguo-msingi: "development"- Thamani ya mfano
development - Mfano wa usemi Bubble
App Settings' selected_environment - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
pass_idtext · Chaguo-msingi: —- Thamani ya mfano
<pass_id returned by Issue> - Mfano wa usemi Bubble
Selected Admission's pass_id - Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Thamani zinazorejeshwa
pass_id · textrevoked · yes/noHali na matukio
Mwendo wa kazi uliopangwa. Bado haipatikani katika beta ya sasa.
Hali
scanner_status · textMatokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded
server_status · textMatokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio. empty,available,redeemed,already_used,expired,revoked
pass_id · textKitambulisho cha kipengele hiki au kitendo. Kihifadhi pamoja na rekodi inayolingana ya programu. Tumia kitambulisho hicho hicho cha ombi wakati wa kujaribu tena matokeo yasiyo na uhakika.
pass_label · textThamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana. empty,access,event,coupon,membership
receipt_id · textKitambulisho cha kipengele hiki au kitendo. Kihifadhi pamoja na rekodi inayolingana ya programu. Tumia kitambulisho hicho hicho cha ombi wakati wa kujaribu tena matokeo yasiyo na uhakika.
error_code · textTaarifa ya hitilafu ya kitendo cha mwisho. Onyesha ujumbe wenye msaada na utoe chaguo linalofaa la kujaribu tena.
is_busy · yes/noKazi bado inaendelea. Subiri kabla ya kuanza kitendo kingine.
is_scanning · yes/noThamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.
torch_enabled · yes/noThamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.
scan_source · textThamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana. empty,camera,fixture
pending_redemption · yes/noThamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.
scanned_pass_token · textThamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.
Matukio
scanner_startedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
scanner_pausedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
scanner_cancelledWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
permission_deniedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
pass_scannedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
validation_startedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
validation_completedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
redemption_startedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
pass_redeemedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
redemption_rejectedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
redemption_pendingWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
fixture_decodedWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
qr_errorWakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.
Maswali yanayoulizwa na wasanidi programu
Mipangilio miwili ya ruhusa inamaanisha nini?
Jina la uga wa yes/no katika rekodi ya User unaoonyesha wafanyakazi wanaoruhusiwa kuunda au kubatilisha pasi. Mfano/chaguo-msingi: qr_pass_issuer. Weka jina la uga hapa, si yes au no. Ni msimamizi aliyeidhinishwa pekee anayepaswa kubadilisha ruhusa hiyo kwa mtumiaji. Jina la uga wa yes/no katika rekodi ya User unaoonyesha wafanyakazi wanaoruhusiwa kukagua na kuthibitisha matumizi. Mfano/chaguo-msingi: qr_staff. Mwenye tiketi hahitaji ruhusa hii. Usiuweke kwenye fomu za usajili wa umma na wasifu.
Je, mfanyakazi yule yule anaweza kutengeneza na kukagua pasi?
Ndiyo, ikiwa msimamizi aliyeidhinishwa anampa mfanyakazi huyo ruhusa zote mbili. Hii haihitaji ufunguo mwingine wa mradi. Wateja kwa kawaida hawahitaji ruhusa yoyote. Usiruhusu watumiaji kujipatia ruhusa hizi wenyewe.
Kwa nini tumia Check baada ya Scan?
Scan husoma msimbo. Check huuliza ikiwa pasi inapatikana bila kuitumia. Wafanyakazi wanaweza kukagua agizo kwanza. Kitendo tofauti cha Confirm QR redemption pekee ndicho hutumia pasi mara moja.
Usajili unafanya kazi vipi?
Bei iliyopangwa: kufunga plugin katika Bubble ni bure. Ufikiaji wa BestPlugins ni usajili wa kujitegemea kwa kila plugin katika kila mradi wa programu ya Bubble: siku 7 bure, kisha US$1.50 kwa mwezi. Development na Live zimejumuishwa. Hakuna kikomo kilichowekwa cha idadi ya shughuli; vikwazo vya ukubwa wa faili na vipengele bado vinatumika. Malipo hayajafunguliwa bado. Skrini ya uanzishaji itaonyesha tarehe ya bili ya kwanza na masharti ya kughairi.
Miongozo husika
Toleo la Marketplace linasubiri
Mwongozo wa jukwaa haujapostiwa
Kwa msaada, tuambie plugin na kifaa unachotumia, kitendo ulichojaribu na kilichotokea. Tumia mfano usio na data binafsi. Usishiriki ufunguo wako wala faili za kibinafsi.