QR स्कैनर इंटरफ़ेस। एक-बार पास क्रियाएँ नियोजित हैं।

Xodera Plugins · Bubble Native

Xodera QR Passes Native

एक‑बार उपयोग टिकट, पिक‑अप पुष्टि या कूपन बनाएं। स्टाफ कोड स्कैन करता है, परिणाम जांचता है, ऑर्डर का पूर्वावलोकन करता है और तैयार होने पर उपयोग की पुष्टि करता है।

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.

वर्कफ़्लो बनाएं ↓प्लगइन सेटिंग्स ↗Native Lab

दस्तावेज़ की समीक्षा की गई 6 नवंबर 2026

व्यावहारिक उदाहरण

एक ही दिन के इवेंट के लिए एक‑बार उपयोग प्रवेश

एक सामान्य QR मान का स्क्रीनशॉट अन्य प्रवेश द्वारों पर पुनः उपयोग किया जा सकता है।

आपका ऐप एक Admission रिकॉर्ड और एक स्थिर issue `request_id` संग्रहीत करता है; क्यूरेटेड `label=event` और `ttl_seconds` का उपयोग 1–86400-सेकंड अनुबंध के भीतर करें।

एक अधिकृत जारीकर्ता Issue QR pass चलाता है और लौटाए गए QR को निजी रूप से प्रदान करता है। स्टाफ स्कैन करता है → Check QR pass → केवल तभी पुष्टि करता है जब `ok=yes` और `status=available` हों → Confirm QR redemption एक संग्रहीत स्थिर अनुरोध ID के साथ।

केवल `status=redeemed` प्लस `receipt_id` आपके ऐप की admission रसीद को अधिकृत करता है। Admission पर पास/रसीद संदर्भ संग्रहीत करें; QR की सामग्री को विश्लेषण में उजागर न करें।

`outcome_unknown` के लिए, समान उपयोगकर्ता/पर्यावरण/पास के साथ वही अनुरोध पुनः प्राप्त करें; कभी नया पुष्टि ID न बनाएं। expired, revoked और पहले उपयोग किए गए स्थितियों को अलग परिणामों के रूप में संभालें।

योजना बनाई गई। स्कैनिंग और जांच पास का उपयोग नहीं करती; केवल स्पष्ट पुष्टि करती है।

एक साझेदार काउंटर पर एक अल्पकालिक लाभ एक बार रिडीम करें

एक साझेदार को एक पुष्टि किया गया उपयोग/अप्रयुक्त परिणाम चाहिए, न कि QR छवि या स्क्रीन एनीमेशन पर भरोसा करना।

`label=coupon`; ऐप का Benefit रिकॉर्ड पात्रता और एक अल्प वैधता विंडो को परिभाषित करता है, इससे पहले कि अधिकृत issue कार्रवाई हो।

आपके ऐप की पात्रता जांच के बाद ही पास जारी करें। काउंटर पर, Check QR pass उपलब्धता दिखाता है बिना इसे खर्च किए। स्टाफ सदस्य लाभ की डिलीवरी की पुष्टि करने के बाद, Confirm QR redemption चलाएँ।

आपका Benefit रिकॉर्ड `receipt_id` और `status=redeemed` के बाद पुष्टि किया गया रिडेम्प्शन समय संग्रहीत कर सकता है। प्लगइन पास की स्थिति प्रबंधित करता है; आपका ऐप लाभ और ग्राहक संबंध प्रबंधित करता है।

यदि कोई लाभ उपयोग से पहले रद्द किया जाता है, तो वही अधिकृत जारीकर्ता अपने `pass_id` का उपयोग करके Revoke QR pass कर सकता है। केवल `ok=yes` से रिफंड या सफल रिडेम्प्शन की घोषणा न करें।

एक ही दिन के उपकरण या ऑर्डर पिकअप की पुष्टि करें

स्टाफ वर्कफ़्लो को पिकअप संदर्भ को स्कैन करने और वास्तव में आइटम सौंपने में अंतर करना आवश्यक है।

आपके ऐप का स्वामित्व वाला Collection रिकॉर्ड प्राधिकरण, इच्छित आइटम और अलग स्थिर issue/रिडेम्प्शन अनुरोध IDs को रखता है; एक अल्पकालिक `label=access` पास का उपयोग करें।

आपके ऐप द्वारा पिकअप को अधिकृत करने के बाद, Issue QR pass। स्टाफ स्कैन और जांच करता है, आपके ऐप में मिलते-जुलते Collection की जाँच करता है, फिर स्पष्ट रूप से हैंडओवर और Confirm QR redemption की पुष्टि करता है।

केवल पुष्टि किए गए `redeemed` रसीद के बाद ही आपका वर्कफ़्लो Collection को सौंपा हुआ सेट करे। `receipt_id` को पास परिणाम के लिंक के रूप में रखें।

एक दोहराया स्कैन already_used लौट सकता है; दूसरे आइटम को सौंपने के बजाय मौजूदा ऐप रिकॉर्ड दिखाएँ। समान ID और इनपुट के साथ अनिश्चित पुष्टि को पुनः प्राप्त करें।

वर्तमान में क्या काम करता है

निजी बीटा। वर्तमान स्कैनर में कैमरा और अनुमति नियंत्रण हैं। एक‑बार उपयोग पास बनाना, जांचना और पुष्टि करना नियोजित है और अभी आपके ऐप में उपयोग के लिए तैयार नहीं है।

वर्कफ़्लो बनाएं

योजना बनाई गई

योजना किया गया कार्यप्रवाह। वर्तमान बीटा में अभी उपलब्ध नहीं है।

इन उदाहरणों में Lesson, Message और Order जैसे ऐप रिकॉर्ड का उपयोग किया गया है। इन्हें अपने डेटा प्रकारों और तत्व नामों से बदलें। उदाहरण मीडिया पते को अपने फ़ाइलों से बदलना आवश्यक है।

योजना बनाई गई: एक अधिकृत कर्मचारी Issue QR pass का उपयोग प्रवेश या Order के लिए करता है। उदाहरण: label=event, ttl_seconds=900, environment=development। उस जारी करने के लिए स्थिर request_id रखें और रिकॉर्ड के साथ pass_id सहेजें।
वापसी किए गए QR को उसके इच्छित धारक को दिखाएँ। स्टाफ इसे स्कैन करता है। योजना पास वर्कफ़्लो में, workflow_mode=yes का उपयोग करें और scanned_pass_token को pass_scanned के बाद पढ़ें। ये पास‑वर्कफ़्लो सेटिंग्स वर्तमान स्कैनर में उपलब्ध नहीं हैं।
Check QR pass को pass_token = QR Scanner's scanned_pass_token के साथ चलाएँ। यह पास का उपयोग किए बिना जांच करता है। status=available के लिए, मिलते‑जुलते ऑर्डर या एंट्री विवरण दिखाएँ ताकि स्टाफ उन्हें समीक्षा कर सके।
केवल अलग Confirm बटन Confirm QR redemption को समान pass_token, स्थिर request_id और confirm=yes के साथ चलाता है। status=redeemed पर, receipt_id सहेजें और उस ऑर्डर या एंट्री को पूर्ण चिह्नित करें।
already_used, expired, revoked या invalid का अर्थ है प्रवेश या ऑर्डर न देना। केवल स्कैन या सफल Check अकेले लेन‑देन को पूर्ण नहीं करता।

वर्कफ़्लो आरेख — ऐप स्क्रीनशॉट नहीं

एक बार कॉन्फ़िगर करें

BestPlugins → Dashboard → Plugins में अपना Bubble ऐप प्रोजेक्ट बनाएँ या चुनें। Xodera QR Passes Native चुनें, उसकी कुंजी कॉपी करें, फिर Bubble → Plugins → Xodera QR Passes Native खोलें और उसे project_api_key में पेस्ट करें। एक बार सहेजें; फिर नीचे दी गई कार्रवाइयों का उपयोग करें। प्रत्येक प्रोजेक्ट के प्रत्येक प्लगइन की अपनी कुंजी होती है।

स्कैनिंग के लिए कैमरा अनुमति आवश्यक है। एक‑बार उपयोग पासों के लिए तय करें कि कौन पास बना सकता है और कौन द्वार या पिक‑अप पॉइंट पर उन्हें जांच सकता है। सामान्य ग्राहकों को स्टाफ भूमिका की आवश्यकता नहीं है।

`qr_issuer_permission_field`

qr_pass_issuer · उपयोगकर्ता का वह हाँ/नहीं फ़ील्ड जिसका नाम कर्मचारियों को पास बनाने या रद्द करने की अनुमति दर्शाता है। उदाहरण/डिफ़ॉल्ट: qr_pass_issuer। यहाँ फ़ील्ड का नाम रखें, न कि हाँ या नहीं। केवल अधिकृत प्रशासक को ही उपयोगकर्ता पर यह अनुमति बदलनी चाहिए।

`qr_staff_permission_field`

qr_staff · उपयोगकर्ता का वह हाँ/नहीं फ़ील्ड जिसका नाम स्टाफ को उपयोग की जाँच और पुष्टि करने की अनुमति दर्शाता है। उदाहरण/डिफ़ॉल्ट: qr_staff। टिकट धारक को यह अनुमति नहीं चाहिए। इसे सार्वजनिक साइन‑अप और प्रोफ़ाइल फ़ॉर्म में न रखें।

एक बार कॉन्फ़िगर करें

अपने Bubble ऐप प्रोजेक्ट को BestPlugins → Dashboard → Plugins पर बनाएं या चुनें।
इस प्लगइन को चुनें और उसका प्रोजेक्ट कुंजी कॉपी करें।
Bubble खोलें → Plugins → Xodera QR Passes Native; कुंजी को project_api_key में पेस्ट करें और सहेजें।
एलिमेंट जोड़ें, अपना ऐप डेटा चुनें और नीचे दिया गया वर्कफ़्लो बनाएं।
अभी केवल निजी बीटा एक्सेस उपलब्ध है। सार्वजनिक इंस्टॉलेशन और भुगतान सक्रियण अभी खुला नहीं है।

स्थापना और सदस्यता

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.

परिणाम को अपने ऐप में सहेजें

उदाहरण प्रवेश या पिक‑अप: संबंधित ऑर्डर/इवेंट, pass_id, expires_at और issue_request_id को सहेजें। पुष्टि उपयोग के बाद, receipt_id, redeemed_at और पुष्टि करने वाले कर्मचारी को जोड़ें। जब कोड केवल स्कैन या जांचा गया हो तो रिकॉर्ड को पूर्ण न चिह्नित करें। QR कोड व्यक्ति की पहचान की पुष्टि नहीं करता।

विफलता, रद्दीकरण और पुनर्प्राप्ति

यदि outcome_unknown=yes, परिणाम फिर से जांचते समय वही पास, request_id और इनपुट रखें। नया पुष्टि न बनाएं। already_used, expired और revoked अंतिम व्यावसायिक परिणाम हैं। यदि अनुमति अस्वीकृत हो, तो अधिकृत प्रशासक से कर्मचारी की भूमिका की समीक्षा करवाएँ। Clear session स्कैनर रीसेट करता है; यह पूर्ण उपयोग को पूर्ववत नहीं कर सकता।

क्षमताएँ और सीमाएँ

योजना बनाई गई पास एक‑बार उपयोग के हैं, जिनका जीवनकाल 1–86400 सेकंड है; डिफ़ॉल्ट 900। पास प्रकार: access, event, coupon और membership। जांच पास को आरक्षित नहीं करती। पास उपयोग के लिए इंटरनेट एक्सेस आवश्यक है। कोई भुगतान प्रक्रिया, पहचान जांच या पुन: उपयोग योग्य दीर्घकालिक सदस्यता कार्ड नहीं है। सामान्य QR मान पढ़ना पास जांच से अलग है।

सेटिंग्स, क्रियाएँ और परिणाम

इन नामों का उपयोग Bubble में करें। नियोजित सुविधाएँ अलग से चिह्नित हैं।

उपलब्ध बीटा सेटिंग्स

एलिमेंट सेटिंग्स

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

स्थितियाँ

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

इवेंट्स

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

क्रियाएँ और उनके इनपुट

Clear session

एलिमेंट सेटिंग्स · 5

योजना किया गया कार्यप्रवाह। वर्तमान बीटा में अभी उपलब्ध नहीं है।

disabledyes/no · डिफ़ॉल्ट: false: उदाहरण मानno; उदाहरण Bubble अभिव्यक्तिGuideHost's is_busy (your yes/no custom state); जब आपका ऐप व्यस्त हो या यह कार्रवाई उपलब्ध न हो, तो तत्व को निष्क्रिय करें।

is_activeyes/no · डिफ़ॉल्ट: true: उदाहरण मानyes; उदाहरण Bubble अभिव्यक्तिGuideHost's view_is_active (your yes/no custom state); जब यह दृश्य खुला हो तो हाँ सेट करें। बाहर निकलते समय नहीं सेट करें, ताकि प्लेबैक या वर्तमान कार्य रोक सके।

ui_text_jsontext · डिफ़ॉल्ट: "{}": उदाहरण मान{}; उदाहरण Bubble अभिव्यक्तिApp Settings' player_labels_json (supported keys only); वैकल्पिक JSON समर्थित बटन लेबल के साथ। अंतर्निहित टेक्स्ट उपयोग करने के लिए खाली छोड़ें।

languagetext · डिफ़ॉल्ट: "auto": उदाहरण मानuk; उदाहरण Bubble अभिव्यक्तिCurrent User's preferred_language; language=auto को समर्थित डिवाइस या ब्राउज़र भाषा के अनुसार सेट करें। स्पष्ट रूप से चुनने के लिए समर्थित भाषा कोड दर्ज करें।

workflow_modeyes/no · डिफ़ॉल्ट: false: उदाहरण मानyes; उदाहरण Bubble अभिव्यक्तिApp Settings' use_qr_business_actions; योजना: स्कैन किए गए QR मान को Check QR pass द्वारा उपयोग करने की अनुमति दें। केवल स्कैनिंग प्रवेश या पिकअप की पुष्टि नहीं करती।

क्रियाएँ और उनके इनपुट · 5

योजना किया गया कार्यप्रवाह। वर्तमान बीटा में अभी उपलब्ध नहीं है।

Clear session

कोई कार्रवाई पैरामीटर नहीं

Issue QR pass

environmenttext · डिफ़ॉल्ट: "development": उदाहरण मानdevelopment; उदाहरण Bubble अभिव्यक्तिApp Settings' selected_environment; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

request_idtext · डिफ़ॉल्ट: —: उदाहरण मानpickup-123-issue-v1; उदाहरण Bubble अभिव्यक्तिCurrent Admission's stable_request_id; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

labeltext · डिफ़ॉल्ट: "access": उदाहरण मानevent; उदाहरण Bubble अभिव्यक्तिSelected Admission's pass_label; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

ttl_secondsnumber · डिफ़ॉल्ट: 900: उदाहरण मान900; उदाहरण Bubble अभिव्यक्तिEvent Settings' pass_ttl_seconds; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

वापसी

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

Check QR pass

environmenttext · डिफ़ॉल्ट: "development": उदाहरण मानdevelopment; उदाहरण Bubble अभिव्यक्तिApp Settings' selected_environment; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

pass_tokentext · डिफ़ॉल्ट: —: उदाहरण मान<opaque token returned by Issue / camera scan>; उदाहरण Bubble अभिव्यक्तिQR Pass Scanner's scanned_pass_token (capture before Check); वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

वापसी

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · डिफ़ॉल्ट: "development": उदाहरण मानdevelopment; उदाहरण Bubble अभिव्यक्तिApp Settings' selected_environment; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

pass_tokentext · डिफ़ॉल्ट: —: उदाहरण मान<opaque token returned by Issue / camera scan>; उदाहरण Bubble अभिव्यक्तिQR Pass Scanner's scanned_pass_token (capture before Check); वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

request_idtext · डिफ़ॉल्ट: —: उदाहरण मानpickup-123-redeem-v1; उदाहरण Bubble अभिव्यक्तिCurrent Admission's stable_redemption_request_id; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

confirmyes/no · डिफ़ॉल्ट: false: उदाहरण मानyes — explicit confirmation only; उदाहरण Bubble अभिव्यक्तिConfirm Checkbox is checked; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

वापसी

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

Revoke QR pass

environmenttext · डिफ़ॉल्ट: "development": उदाहरण मानdevelopment; उदाहरण Bubble अभिव्यक्तिApp Settings' selected_environment; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

pass_idtext · डिफ़ॉल्ट: —: उदाहरण मान<pass_id returned by Issue>; उदाहरण Bubble अभिव्यक्तिSelected Admission's pass_id; वर्तमान व्यवसाय रिकॉर्ड का मान उपयोग करें; इसे नीचे दिए गए सीमाओं के विरुद्ध सत्यापित करें।

वापसी

pass_id · textrevoked · yes/no

स्थिति और इवेंट्स

योजना किया गया कार्यप्रवाह। वर्तमान बीटा में अभी उपलब्ध नहीं है।

स्थितियाँ

scanner_status · text

इस कार्रवाई का वर्तमान परिणाम। सफलता सहेजने से पहले मिलते-जुलते पूर्णता इवेंट का उपयोग करें। idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

इस कार्रवाई का वर्तमान परिणाम। सफलता सहेजने से पहले मिलते-जुलते पूर्णता इवेंट का उपयोग करें। empty,available,redeemed,already_used,expired,revoked

pass_id · text

इस आइटम या कार्रवाई का पहचानकर्ता। इसे मिलते‑जुलते ऐप रिकॉर्ड के साथ रखें। अनिश्चित परिणाम को पुनः प्रयास करते समय वही अनुरोध पहचानकर्ता उपयोग करें।

pass_label · text

चयनित आइटम का वर्तमान मान। संबंधित इवेंट के बाद इसे पढ़ें। empty,access,event,coupon,membership

receipt_id · text

error_code · text

पिछली कार्रवाई की त्रुटि जानकारी। सहायक संदेश दिखाएँ और संबंधित पुनः प्रयास प्रदान करें।

is_busy · yes/no

काम अभी भी प्रगति में है। कोई अन्य कार्रवाई शुरू करने से पहले प्रतीक्षा करें।

is_scanning · yes/no

चयनित आइटम का वर्तमान मान। संबंधित इवेंट के बाद इसे पढ़ें।

torch_enabled · yes/no

चयनित आइटम का वर्तमान मान। संबंधित इवेंट के बाद इसे पढ़ें।

scan_source · text

चयनित आइटम का वर्तमान मान। संबंधित इवेंट के बाद इसे पढ़ें। empty,camera,fixture

pending_redemption · yes/no

चयनित आइटम का वर्तमान मान। संबंधित इवेंट के बाद इसे पढ़ें।

scanned_pass_token · text

चयनित आइटम का वर्तमान मान। संबंधित इवेंट के बाद इसे पढ़ें।