ממשק סורק 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 רגיל יכול במקומות אחרים לשמש ביותר משער אחד.

האפליקציה שלך מאחסנת רשומת כניסה ו‑`request_id` יציב; השתמש ב‑`label=event` מותאם ו‑`ttl_seconds` בתוך החוזה של 1–86400 שניות.

מנפיק מורשה מריץ Issue QR pass ומספק באופן פרטי את QR שהוחזר. הצוות סורק → Check QR pass → מאשר רק אם `ok=yes` ו‑`status=available` → Confirm QR redemption עם מזהה בקשה יציב שמור.

רק `status=redeemed` יחד עם `receipt_id` מאשרים את קבלת הכניסה של האפליקציה שלך. שמור את הפנייה לכרטיס/קבלה על רשומת הכניסה; אל תחשוף את תוכן QR לניתוחים.

עבור `outcome_unknown`, שחזרו את אותה בקשה עם משתמש/סביבה/כרטיס זהים; אל תייצרו מזהה אישור חדש. טיפול ב‑expired, revoked ובמצבים שכבר שומשו ככתוצאות נפרדות.

מתוכנן. סריקה ובדיקה אינן מממשות את הכרטיס; רק אישור מפורש מממש אותו.

מימוש הטבה קצרה טווח פעם אחת בדלפק של שותף

שותף צריך תוצאה מאושרת של בשימוש/לא בשימוש במקום לסמוך על תמונת QR או אנימציית מסך.

`label=coupon`; לפני פעולת ההנפקה המורשית, רשומת ההטבה של האפליקציה מגדירה את הזכאות ואת חלון התוקף הקצר.

הנפיקו כרטיס רק לאחר בדיקת הזכאות של האפליקציה שלכם. בדלפק, Check QR pass מציג זמינות ללא צריכה. לאחר שהצוות מאשר מסירת ההטבה, הפעלו Confirm QR redemption.

רשומת ההטבה שלכם עשויה לאחסן `receipt_id` ואת זמן המימוש המאושר לאחר `status=redeemed`. התוסף מנהל את מצב הכרטיס; האפליקציה שלכם מנהלת את ההטבה ואת הקשר עם הלקוח.

אם הטבה מבוטלת לפני השימוש, המנפיק המורשה יכול לבצע Revoke QR pass באמצעות `pass_id` שלו. אל תודיעו על החזר או מימוש מוצלח רק מ‑`ok=yes`.

מתוכנן. סריקה ובדיקה אינן מממשות את הכרטיס; רק אישור מפורש מממש אותו.

אשר איסוף ציוד או הזמנה באותו היום

תהליך עבודה של צוות צריך להבדיל בין סריקת הפנייה לאיסוף לבין מסירת הפריט בפועל.

רשומת Collection שבבעלות האפליקציה שלך, המשמשת לאיסוף הפריט, שומרת את האישור, הפריט המיועד ואת מזהי בקשות ההנפקה/הפדיון הנפרדים והיציבים; השתמש בכרטיס `label=access` קצר‑טווח.

לאחר שהאפליקציה שלך מאשרת את איסוף הפריט, הפעל Issue QR pass. הצוות סורק ומבצע בדיקה, בוחן את רשומת Collection המתאימה באפליקציה שלך, ואז מאשר במפורש את מסירת הפריט ומפעיל Confirm QR redemption.

רק לאחר קבלה מאושרת של `redeemed` יש להגדיר בתהליך העבודה שרשומת Collection מסומנת כפריט שנמסר. שמור את `receipt_id` כקישור לתוצאה של הכרטיס.

סריקה חוזרת עשויה להחזיר already_used; הצג את רשומת האפליקציה הקיימת במקום להעביר פריט נוסף. שחזר את תוצאת האישור שאינה ודאית עם אותו מזהה ואותם נתוני קלט.

מתוכנן. סריקה ובדיקה אינן מממשות את הכרטיס; רק אישור מפורש מממש אותו.

מה עובד כעת

בטא פרטית. הסורק הנוכחי כולל שליטה במצלמה ובהרשאות. יצירה, בדיקה ואישור של כרטיסים חד‑פעמיים מתוכננים ועדיין אינם זמינים לשימוש באפליקציה שלך.

בנה את זרימת העבודה

מתוכנן

תהליך מתוכנן. עדיין אינו זמין בבטא הנוכחי.

דוגמאות אלו משתמשות ברשומות אפליקציה כגון 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 QR redemption עם אותו pass_token, request_id יציב ו‑confirm=yes. ב‑status=redeemed, שמור receipt_id וסמן את ההזמנה או הכניסה כשלמה.
already_used, expired, revoked או invalid משמעותם לא לאפשר כניסה או למסור את ההזמנה. סריקה או בדיקה מוצלחת בלבד לעולם אינן משלים את העסקה.

תרשים זרימת עבודה — לא צילום מסך של אפליקציה

הגדר פעם אחת

צור או בחר את פרויקט האפליקציה Bubble שלך ב‑BestPlugins → Dashboard → Plugins. בחר ב‑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; דוגמה לביטוי BubbleGuideHost's is_busy (your yes/no custom state); השבת את הרכיב כאשר האפליקציה שלך עסוקה או שהפעולה אינה זמינה.

is_activeyes/no · ברירת מחדל: true: ערך לדוגמהyes; דוגמה לביטוי BubbleGuideHost's view_is_active (your yes/no custom state); הגדר yes כל עוד התצוגה פתוחה. בעת היציאה הגדר no, כדי לאפשר את עצירת ההשמעה או העבודה הנוכחית.

ui_text_jsontext · ברירת מחדל: "{}": ערך לדוגמה{}; דוגמה לביטוי BubbleApp Settings' player_labels_json (supported keys only); JSON אופציונלי עם תוויות כפתורים נתמכות. השאר ריק כדי להשתמש בטקסט המובנה.

languagetext · ברירת מחדל: "auto": ערך לדוגמהuk; דוגמה לביטוי BubbleCurrent User's preferred_language; הגדר language=auto כדי להשתמש בשפת המכשיר או הדפדפן, אם היא נתמכת. הזן קוד שפה נתמך כדי לבחור שפה במפורש.

workflow_modeyes/no · ברירת מחדל: false: ערך לדוגמהyes; דוגמה לביטוי BubbleApp Settings' use_qr_business_actions; מתוכנן: לאפשר לערך הסרוק QR להיות בשימוש על ידי Check QR pass. סריקה בלבד אינה מאשרת כניסה או איסוף.

פעולות והקלטים שלהן · 5

תהליך מתוכנן. עדיין אינו זמין בבטא הנוכחי.

Clear session

אין פרמטרי פעולה

Issue QR pass

environmenttext · ברירת מחדל: "development": ערך לדוגמהdevelopment; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

request_idtext · ברירת מחדל: —: ערך לדוגמהpickup-123-issue-v1; דוגמה לביטוי BubbleCurrent Admission's stable_request_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

labeltext · ברירת מחדל: "access": ערך לדוגמהevent; דוגמה לביטוי BubbleSelected Admission's pass_label; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

ttl_secondsnumber · ברירת מחדל: 900: ערך לדוגמה900; דוגמה לביטוי BubbleEvent 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; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

pass_tokentext · ברירת מחדל: —: ערך לדוגמה<opaque token returned by Issue / camera scan>; דוגמה לביטוי BubbleQR Pass Scanner's scanned_pass_token (capture before Check); השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

ערכי החזרה

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · ברירת מחדל: "development": ערך לדוגמהdevelopment; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

pass_tokentext · ברירת מחדל: —: ערך לדוגמה<opaque token returned by Issue / camera scan>; דוגמה לביטוי BubbleQR Pass Scanner's scanned_pass_token (capture before Check); השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

request_idtext · ברירת מחדל: —: ערך לדוגמהpickup-123-redeem-v1; דוגמה לביטוי BubbleCurrent Admission's stable_redemption_request_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

confirmyes/no · ברירת מחדל: false: ערך לדוגמהyes — explicit confirmation only; דוגמה לביטוי BubbleConfirm Checkbox is checked; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

ערכי החזרה

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

Revoke QR pass

environmenttext · ברירת מחדל: "development": ערך לדוגמהdevelopment; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

pass_idtext · ברירת מחדל: —: ערך לדוגמה<pass_id returned by Issue>; דוגמה לביטוי BubbleSelected 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

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.