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 արժեքի էկրանակադրը հակառակ դեպքում կարելի է կրկին օգտագործել մեկից ավելի մուտքերում։

Ձեր հավելվածը պահում է ընդունման գրառում և կայուն 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 գրառման մեջ․ QR-ի բովանդակությունը մի փոխանցեք վերլուծական համակարգերին։

`outcome_unknown`-ի դեպքում վերականգնեք նույն հարցման արդյունքը՝ նույն օգտատիրոջ, միջավայրի և անցագրի համար․ երբեք նոր հաստատման ID մի ստեղծեք։ expired, revoked և already-used վիճակները մշակեք որպես առանձին արդյունքներ։

Պլանավորված։ Սկանավորումը և ստուգումը չեն օգտագործում պասը; միայն հստակ հաստատումը է օգտագործում։

Գործընկերոջ սպասարկման կետում մեկ անգամ օգտագործեք կարճաժամկետ արտոնությունը։

Գործընկերին անհրաժեշտ է հաստատված օգտագործված/չօգտագործված արդյունք՝ փոխարենը վստահելու QR պատկերին կամ էկրանի անիմացիային։

`label=coupon`; հավելվածի օգուտի գրառումը սահմանում է իրավունքները և կարճ ժամկետի պատուհանը թույլատրված issue գործողությունից առաջ։

Անցագիր թողարկեք միայն այն բանից հետո, երբ ձեր հավելվածը ստուգել է արտոնությունից օգտվելու իրավունքը։ Սպասարկման կետում Check QR pass-ը ցույց է տալիս անցագրի հասանելիությունը՝ առանց այն սպառելու։ Երբ աշխատակիցը հաստատում է արտոնության տրամադրումը, գործարկեք Confirm QR redemption։

Ձեր օգուտի գրառումը կարող է պահել `receipt_id`-ը և հաստատված օգտագործման ժամանակը `status=redeemed`-ի հետո։ Պլագինը կառավարում է պասի վիճակը; ձեր հավելվածը կառավարում է օգուտը և հաճախորդների հարաբերությունները։

Եթե օգուտը չեղարկվում է օգտագործման առաջ, նույն թույլատրված թողարկողը կարող է Revoke QR pass օգտագործելով իր `pass_id`-ը։ Մի հայտարարեք վերադարձ կամ հաջողված օգտագործում միայն `ok=yes`-ից։

Պլանավորված։ Սկանավորումը և ստուգումը չեն օգտագործում պասը; միայն հստակ հաստատումը է օգտագործում։

Հաստատեք նույնօրվա սարքի կամ պատվերի վերցնումը։

Աշխատակազմի աշխատանքային հոսքը պետք է տարբերակի պատվերը կամ ապրանքը վերցնելու հղման սկանավորումը ապրանքն իրականում հանձնելուց։

Ձեր հավելվածին պատկանող Collection գրառումը պահում է ապրանքը վերցնելու թույլտվությունը, նախատեսված ապրանքը և թողարկման ու օգտագործման հաստատման առանձին կայուն հարցման ID-ները․ օգտագործեք կարճաժամկետ `label=access` անցագիր։

Երբ ձեր հավելվածը թույլատրի ապրանքը վերցնելը, գործարկեք Issue QR pass։ Աշխատակիցները սկանավորում և ստուգում են անցագիրը, ձեր հավելվածում դիտում համապատասխան Collection գրառումը, ապա հստակ հաստատում ապրանքի հանձնումը և գործարկում Confirm QR redemption։

Միայն հաստատված `redeemed` արդյունքի հաստատումը ստանալուց հետո ձեր աշխատանքային հոսքը պետք է Collection գրառումը նշի որպես հանձնված։ Պահեք `receipt_id`-ը՝ որպես անցագրի արդյունքի հետ կապ։

Կրկնակի սկանավորումը կարող է վերադարձնել already_used; ցույց տվեք գոյություն ունեցող հավելվածի գրառումը այլ նյութի փոխանցման փոխարեն։ Վերականգնեք անորոշ հաստատումը նույն ID-ով և մուտքագրություններով։

Պլանավորված։ Սկանավորումը և ստուգումը չեն օգտագործում պասը; միայն հստակ հաստատումը է օգտագործում։

Ինչ է աշխատում հիմա

Փակ beta։ Ընթացիկ սկաները ունի տեսախցիկի և թույլտվությունների կառավարում։ Մեկանգամյա անցագրերի ստեղծումը, ստուգումը և հաստատումը պլանավորված են և դեռ պատրաստ չեն օգտագործման ձեր հավելվածում։

Ստեղծեք աշխատանքային հոսքը

Պլանավորված

Պլանավորված աշխատանքային հոսք։ Դեռ հասանելի չէ ընթացիկ բետայում։

Այս օրինակները օգտագործում են հավելվածի գրառումներ, ինչպիսիք են 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 նշանակում են չընդունել կամ չհանձնել պատվերը։ Միակ սկանավորումը կամ հաջողված ստուգումը երբեք չի ավարտում գործարքը։

Աշխատանքային հոսքի դիագրամ — ոչ հավելվածի սկրինշոտ

Կարգավորեք մեկ անգամ

Ստեղծեք կամ ընտրեք ձեր Bubble հավելվածի նախագիծը BestPlugins → Dashboard → Plugins-ում։ Ընտրեք Xodera QR Passes Native, պատճենեք նրա բանալին, ապա բացեք Bubble → Plugins → Xodera QR Passes Native և տեղադրեք այն project_api_key-ում։ Պահպանեք մեկ անգամ; ապա օգտագործեք ներքևում գտնվող գործողությունները։ Յուրաքանչյուր պլագին յուրաքանչյուր նախագծում ունի իր սեփական բանալին։

Սքանավորումը պահանջում է տեսախցիկի թույլտվություն։ Միակ օգտագործման պասների համար որոշեք, թե ով կարող է ստեղծել պասներ և ով կարող է ստուգել դրանք դռում կամ վերցնելու կետում։ Սովորական հաճախորդները չեն պահանջում որևէ աշխատակազմի դեր։

`qr_issuer_permission_field`

qr_pass_issuer · User տիպի yes/no դաշտի անունը, որը նշում է անցագրեր ստեղծելու կամ չեղարկելու իրավունք ունեցող աշխատակիցներին։ Օրինակ/լռելյայն՝ qr_pass_issuer։ Այստեղ մուտքագրեք դաշտի անունը, ոչ թե yes կամ no։ Միայն լիազորված ադմինիստրատորը պետք է փոխի օգտատիրոջ այդ թույլտվությունը։

`qr_staff_permission_field`

qr_staff · User տիպի yes/no դաշտի անունը, որը նշում է օգտագործումը ստուգելու և հաստատելու իրավունք ունեցող աշխատակիցներին։ Օրինակ/լռելյայն՝ 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); Սահմանեք yes, քանի դեռ այս տեսքը բաց է։ Դուրս գալիս սահմանեք no, որպեսզի նվագարկումը կամ ընթացիկ աշխատանքը կարողանա դադարել։

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

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։