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` آپ کی ایپ کے داخلے کی رسید کو اختیار دیتے ہیں۔ پاس/رسید کا حوالہ داخلے پر محفوظ کریں؛ QR کے مواد کو تجزیات کے لیے ظاہر نہ کریں۔

`outcome_unknown` کے لیے، ایک ہی صارف/ماحول/پاس کے ساتھ وہی درخواست بحال کریں؛ کبھی نیا تصدیقی ID نہ بنائیں۔ expired، revoked اور پہلے استعمال شدہ حالتوں کو مختلف نتائج کے طور پر سنبھالیں۔

منصوبہ بند۔ اسکیننگ اور جانچ پاس کے ایک بار استعمال کا حق خرچ نہیں کرتیں؛ صرف واضح تصدیق سے وہ حق استعمال ہوتا ہے۔

شریک کاؤنٹر پر ایک بار مختصر مدت کے فائدے کو استعمال کریں

ایک شریک کو QR کی تصویر یا اسکرین اینیمیشن پر بھروسہ کرنے کے بجائے تصدیق شدہ استعمال شدہ/غیر استعمال شدہ نتیجہ چاہیے۔

`label=coupon`؛ ایپ کا فائدے کا ریکارڈ اہلیت اور ایک مختصر درستگی کی مدت کو متعین کرتا ہے جو مجاز جاری کرنے کے عمل سے پہلے ہوتی ہے۔

اپنی ایپ کی اہلیت کی جانچ کے بعد ہی پاس جاری کریں۔ کاؤنٹر پر، Check QR pass دستیابی دکھاتا ہے بغیر اسے استعمال کیے۔ عملے کے رکن کے فائدے کی فراہمی کی تصدیق کے بعد، Confirm QR redemption چلائیں۔

آپ کا فائدے کا ریکارڈ `receipt_id` اور `status=redeemed` کے بعد تصدیق شدہ ریڈیمپشن وقت محفوظ کر سکتا ہے۔ پلگ ان پاس کی حالت کو منظم کرتا ہے؛ آپ کی ایپ فائدے اور گاہک کے تعلقات کو منظم کرتی ہے۔

اگر فائدہ استعمال سے پہلے منسوخ ہو جائے تو وہی مجاز جاری کرنے والا اپنے `pass_id` کا استعمال کرتے ہوئے Revoke QR pass کر سکتا ہے۔ صرف `ok=yes` سے واپسی یا کامیاب ریڈیمپشن کا اعلان نہ کریں۔

ایک ہی دن کے آلات یا آرڈر کی وصولی کی تصدیق کریں

عملے کے ورک فلو کو سامان یا آرڈر کی وصولی کے حوالے کو اسکین کرنے اور واقعی آئٹم حوالے کرنے میں فرق کرنا چاہیے۔

آپ کی ایپ کا ملکیتی کلیکشن ریکارڈ اجازت، مطلوبہ آئٹم اور الگ الگ مستحکم جاری/ریڈیمپشن درخواست IDs محفوظ رکھتا ہے؛ مختصر مدت کا `label=access` پاس استعمال کریں۔

آپ کی ایپ کی جانب سے سامان یا آرڈر کی وصولی کی اجازت دینے کے بعد، Issue QR pass۔ عملہ اسکین اور چیک کرتا ہے، ایپ میں مماثل کلیکشن کا معائنہ کرتا ہے، پھر واضح طور پر ہینڈ اوور اور Confirm QR redemption کی تصدیق کرتا ہے۔

صرف تصدیق شدہ `redeemed` رسید کے بعد ہی آپ کا ورک فلو کلیکشن کو ہینڈ اوور شدہ مقرر کرے۔ `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 استعمال کریں اور pass_scanned کے بعد scanned_pass_token پڑھیں۔ یہ پاس-ورک فلو سیٹنگز موجودہ اسکینر میں دستیاب نہیں ہیں۔
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 · وہ یوزر ہاں/نہ فیلڈ کا نام جو ملازمین کو پاس بنانے یا منسوخ کرنے کی اجازت دیتا ہے۔ مثال/ڈیفالٹ: qr_pass_issuer۔ یہاں فیلڈ کا نام درج کریں، ہاں یا نہ نہیں۔ صرف مجاز ایڈمنسٹریٹر کو ہی اس اجازت کو یوزر پر تبدیل کرنا چاہیے۔

`qr_staff_permission_field`

qr_staff · وہ یوزر ہاں/نہ فیلڈ کا نام جو اسٹاف کو استعمال کی جانچ اور تصدیق کی اجازت دیتا ہے۔ مثال/ڈیفالٹ: qr_staff۔ ٹکٹ ہولڈر کو یہ اجازت درکار نہیں۔ اسے عوامی سائن‑اپ اور پروفائل فارم سے باہر رکھیں۔

ایک بار ترتیب دیں

BestPlugins → Dashboard → Plugins پر اپنا Bubble ایپ پروجیکٹ بنائیں یا منتخب کریں۔
یہ پلگ ان منتخب کریں اور اس کی پروجیکٹ کلید کاپی کریں۔
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

منتخب آئٹم کی موجودہ قدر۔ متعلقہ ایونٹ کے بعد اسے پڑھیں۔