QR tarayıcı arayüzü. Tek kullanımlık geçiş eylemleri planlanmaktadır.

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Tek kullanımlık biletler, teslim onayları veya kuponlar oluşturun. Personel kodu tarar, sonucu kontrol eder, siparişi ön izler ve hazır olduğunda kullanımı onaylar.

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.

İş akışını oluşturun ↓Eklenti ayarları ↗Native Lab

6 belgeleri November 2026 incelendi.

Pratik örnekler

Aynı gün etkinliği için tek kullanımlık giriş

Sıradan bir QR değerinin ekran görüntüsü başka bir girişte birden fazla kez yeniden kullanılabilir.

Uygulamanız bir Admission kaydı ve sabit bir `request_id` saklar; `label=event` ve `ttl_seconds`'yi 1–86400 saniyelik sözleşme içinde kullanın.

Yetkili bir sağlayıcı Issue QR pass çalıştırır ve dönen QR'yi özel olarak teslim eder. Personel tarar → Check QR pass → yalnızca `ok=yes` ve `status=available` ise Confirm QR redemption'yi, saklanan sabit istek kimliğiyle onaylar.

Yalnızca `status=redeemed` ve `receipt_id`, uygulamanızın admission makbuzunu yetkilendirir. Pass/makbuz referansını Admission üzerinde saklayın; QR içeriğini analizlere açmayın.

`outcome_unknown` için, aynı kullanıcı/ortam/pass ile aynı isteği geri alın; yeni bir onay kimliği oluşturmayın. expired, revoked ve zaten kullanılmış durumları ayrı sonuçlar olarak işleyin.

Planlandı. Tarama ve kontrol pass'i kullanmaz; yalnızca açık onay kullanır.

Ortak bir kontuar’da kısa ömürlü faydayı bir kez kullanın

Bir ortak, QR görüntüsüne veya ekran animasyonuna güvenmek yerine onaylanmış kullanıldı/kullanılmadı sonucuna ihtiyaç duyar.

`label=coupon`; uygulamanın Benefit kaydı, uygunluğu ve yetkili bir işlemden önce kısa bir geçerlilik süresini tanımlar.

Uygulamanızın uygunluk kontrolünden sonra yalnızca bir pass oluşturun. Kontuar’da, Check QR pass kullanılmadan kullanılabilirliği gösterir. Personel faydayı teslim ettiğini onayladıktan sonra Confirm QR redemption çalıştırın.

Benefit kaydınız `receipt_id` ve `status=redeemed` sonrası onaylanmış kullanım zamanını saklayabilir. Eklenti pass durumunu yönetir; uygulamanız faydayı ve müşteri ilişkisini yönetir.

Bir fayda kullanılmadan iptal edilirse, aynı yetkili sağlayıcı Revoke QR pass'yi `pass_id` kullanarak yapabilir. Tek başına `ok=yes`'den bir geri ödeme veya başarılı kullanım duyurmayın.

Planlandı. Tarama ve kontrol pass'i kullanmaz; yalnızca açık onay kullanır.

Aynı gün ekipman veya sipariş teslim alımını onaylayın

Personel iş akışı, bir teslim alma referansını taramayı bir öğeyi gerçekten teslim etmekten ayırmalıdır.

Uygulamanızın sahip olduğu Collection kaydı yetkilendirmeyi, hedef öğeyi ve ayrı sabit oluşturma/kullanma istek kimliklerini tutar; kısa ömürlü bir `label=access` pass kullanın.

Uygulamanız teslim almayı onayladıktan sonra Issue QR pass. Personel tarar ve kontrol eder, uygulamanızdaki eşleşen Collection'ı inceler, ardından teslimatı ve Confirm QR redemption'yi açıkça onaylar.

Yalnızca onaylanmış bir `redeemed` makbuzu alındıktan sonra iş akışınız Collection'ı teslim edildi olarak işaretlemelidir. `receipt_id`'yi pass sonucuna bağlayan link olarak tutun.

Tekrarlanan bir tarama already_used döndürebilir; başka bir öğe teslim etmek yerine mevcut uygulama kaydını gösterin. Aynı kimlik ve girdilerle belirsiz bir onayı geri alın.

Planlandı. Tarama ve kontrol pass'i kullanmaz; yalnızca açık onay kullanır.

Şu anda çalışanlar

Özel beta. Mevcut tarayıcı kamera ve izin kontrollerine sahiptir. Tek kullanımlık geçişlerin oluşturulması, kontrol edilmesi ve onaylanması planlanıyor ve henüz uygulamanızda kullanıma hazır değil.

İş akışını oluşturun

Planlandı

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

Bu örnekler Lesson, Message ve Order gibi uygulama kayıtlarını kullanır. Bunları kendi veri tipleriniz ve öğe adlarınızla değiştirin. Örnek medya adresleri kendi dosyalarınızla değiştirilmelidir.

Planlanan: yetkili bir çalışan Issue QR pass'yi bir Giriş veya Order için kullanır. Örnek: label=event, ttl_seconds=900, environment=development. Bu işlem için sabit bir request_id tutun ve pass_id'yi kayıtla birlikte kaydedin.
Geri dönen QR'yi ilgili sahibine gösterin. Personel tarar. Planlanan geçiş iş akışında, workflow_mode=yes'yi kullanın ve pass_scanned'den sonra scanned_pass_token'yi okuyun. Bu geçiş iş akışı ayarları mevcut tarayıcıda bulunmamaktadır.
Check QR pass'yi pass_token = QR Scanner's scanned_pass_token ile çalıştırın. Geçişi kullanmadan kontrol eder. status=available için, personelin inceleyebilmesi amacıyla eşleşen sipariş veya giriş detaylarını gösterin.
Yalnızca ayrı bir Onay düğmesi, aynı pass_token, sabit bir request_id ve confirm=yes ile Confirm QR redemption'yi çalıştırır. status=redeemed üzerinde receipt_id'yi kaydedin ve ilgili sipariş veya girişi tamamlanmış olarak işaretleyin.
already_used, expired, revoked veya invalid, girişe izin vermeme ve siparişi teslim etmeme anlamına gelir. Tek bir tarama veya başarılı bir Kontrol, işlemi asla tamamlamaz.

İş akışı diyagramı — uygulama ekran görüntüsü değil

Bir kez yapılandırın

Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin. Xodera QR Passes Native öğesini seçin, anahtarını kopyalayın, ardından Bubble → Plugins → Xodera QR Passes Native açın ve project_api_key içine yapıştırın. Bir kez kaydedin; ardından aşağıdaki eylemleri kullanın. Her proje içindeki her eklentinin kendi anahtarı vardır.

Tarama kamera izni gerektirir. Tek kullanımlık geçişler için, kimlerin geçiş oluşturabileceğine ve kimlerin kapıda veya teslim noktasında kontrol edebileceğine karar verin. Normal müşterilerin ne personel rolüne ne de buna ihtiyacı yoktur.

`qr_issuer_permission_field`

qr_pass_issuer · Geçiş oluşturma veya iptal etme izni verilen çalışanları işaretleyen Kullanıcı evet/hayır alanının adı. Örnek/varsayılan: qr_pass_issuer. Buraya alan adını yazın, evet ya da hayır değil. Bu izni yalnızca yetkili bir yönetici bir kullanıcıda değiştirmelidir.

`qr_staff_permission_field`

qr_staff · Kullanımını kontrol edip onaylayabilen personele izin veren Kullanıcı evet/hayır alanının adı. Örnek/varsayılan: qr_staff. Bilet sahibi bu izne ihtiyaç duymaz. Bunu genel kayıt ve profil formlarından çıkarın.

Bir kez yapılandırın

Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin.
Bu eklentiyi seçin ve proje anahtarını kopyalayın.
Bubble → Plugins → Xodera QR Passes Native açın; anahtarı project_api_key içine yapıştırın ve kaydedin.
Öğeyi ekleyin, uygulama verilerinizi seçin ve aşağıdaki iş akışını oluşturun.
Şimdilik yalnızca özel beta erişimi. Genel kurulum ve ücretli aktivasyon henüz açık değil.

Kurulum ve abonelik

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.

Sonucu uygulamanıza kaydedin

Örnek Giriş veya Teslim: ilgili sipariş/etkinliği, pass_id, expires_at ve issue_request_id kaydedin. Kullanım onaylandıktan sonra receipt_id, redeemed_at ve onayı veren çalışanı ekleyin. Kod yalnızca tarandığında veya kontrol edildiğinde kaydı tamamlanmış olarak işaretlemeyin. QR kodu bir kişinin kimliğini doğrulamaz.

Başarısızlık, iptal ve kurtarma

outcome_unknown=yes ise, sonucu tekrar kontrol ederken aynı geçişi, request_id ve girdileri koruyun. Yeni bir onay oluşturmayın. already_used, expired ve revoked nihai iş sonuçlarıdır. İzin reddedilirse, yetkili bir yöneticiden çalışanın rolünü gözden geçirmesini isteyin. Clear session tarayıcıyı sıfırlar; tamamlanmış bir kullanımı geri alamaz.

Yetenekler ve sınırlamalar

Planlanan geçişler tek kullanımlıktır ve 1–86400 saniye ömür süresine sahiptir; varsayılan 900. Geçiş türleri: access, event, coupon ve membership. Kontrol, bir geçişi rezerve etmez. Geçiş kullanımı için internet erişimi gerekir. Ödeme işleme, kimlik kontrolü veya yeniden kullanılabilir uzun vadeli üyelik kartı yoktur. Normal bir QR değerini okumak, bir geçişi kontrol etmekten ayrı bir işlemdir.

Ayarlar, eylemler ve sonuçlar

Bu adları Bubble içinde kullanın. Planlanan özellikler ayrı olarak işaretlenmiştir.

Kullanılabilir beta ayarları

Öğe ayarları

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

Durumlar

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

Olaylar

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Eylemler ve girdileri

Clear session

Öğe ayarları · 5

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

disabledyes/no · Varsayılan: false: Örnek değerno; Örnek Bubble ifadesiGuideHost's is_busy (your yes/no custom state); Uygulamanız meşgulken veya bu eylem kullanılamazken öğeyi devre dışı bırakın.

is_activeyes/no · Varsayılan: true: Örnek değeryes; Örnek Bubble ifadesiGuideHost's view_is_active (your yes/no custom state); Bu görünüm açıkken evet ayarlayın. Ayrılırken hayır ayarlayın, böylece oynatma veya mevcut çalışma durabilir.

ui_text_jsontext · Varsayılan: "{}": Örnek değer{}; Örnek Bubble ifadesiApp Settings' player_labels_json (supported keys only); Desteklenen düğme etiketleriyle isteğe bağlı JSON. Yerleşik metni kullanmak için boş bırakın.

languagetext · Varsayılan: "auto": Örnek değeruk; Örnek Bubble ifadesiCurrent User's preferred_language; language=auto'yi desteklenen bir cihazı veya tarayıcı dilini izlemek için ayarlayın. Açıkça seçmek için desteklenen bir dil kodu girin.

workflow_modeyes/no · Varsayılan: false: Örnek değeryes; Örnek Bubble ifadesiApp Settings' use_qr_business_actions; Planlandı: taranan QR değerinin Check QR pass tarafından kullanılmasına izin verin. Sadece tarama giriş veya teslimi onaylamaz.

Eylemler ve girdileri · 5

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

Clear session

Eylem parametresi yok

Issue QR pass

environmenttext · Varsayılan: "development": Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

request_idtext · Varsayılan: —: Örnek değerpickup-123-issue-v1; Örnek Bubble ifadesiCurrent Admission's stable_request_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

labeltext · Varsayılan: "access": Örnek değerevent; Örnek Bubble ifadesiSelected Admission's pass_label; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

ttl_secondsnumber · Varsayılan: 900: Örnek değer900; Örnek Bubble ifadesiEvent Settings' pass_ttl_seconds; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

İadeler

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

Check QR pass

environmenttext · Varsayılan: "development": Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

pass_tokentext · Varsayılan: —: Örnek değer<opaque token returned by Issue / camera scan>; Örnek Bubble ifadesiQR Pass Scanner's scanned_pass_token (capture before Check); Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

İadeler

pass_label · textexpires_at · text

Confirm QR redemption

environmenttext · Varsayılan: "development": Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

pass_tokentext · Varsayılan: —: Örnek değer<opaque token returned by Issue / camera scan>; Örnek Bubble ifadesiQR Pass Scanner's scanned_pass_token (capture before Check); Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

request_idtext · Varsayılan: —: Örnek değerpickup-123-redeem-v1; Örnek Bubble ifadesiCurrent Admission's stable_redemption_request_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

confirmyes/no · Varsayılan: false: Örnek değeryes — explicit confirmation only; Örnek Bubble ifadesiConfirm Checkbox is checked; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

İadeler

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

Revoke QR pass

environmenttext · Varsayılan: "development": Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

pass_idtext · Varsayılan: —: Örnek değer<pass_id returned by Issue>; Örnek Bubble ifadesiSelected Admission's pass_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

İadeler

pass_id · textrevoked · yes/no

Durumlar ve olaylar

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

Durumlar

scanner_status · text

Bu eylemin mevcut sonucu. Başarıyı kaydetmeden önce eşleşen tamamlama olayını kullanın. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Bu eylemin mevcut sonucu. Başarıyı kaydetmeden önce eşleşen tamamlama olayını kullanın. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Bu öğe veya eylem için tanımlayıcı. Eşleşen uygulama kaydıyla birlikte tutun. Belirsiz bir sonucu yeniden denerken aynı istek tanımlayıcısını kullanın.

pass_label · text

Seçili öğenin mevcut değeri. İlgili olaydan sonra okuyun. empty,access,event,coupon,membership

receipt_id · text

Bu öğe veya eylem için tanımlayıcı. Eşleşen uygulama kaydıyla birlikte tutun. Belirsiz bir sonucu yeniden denerken aynı istek tanımlayıcısını kullanın.

error_code · text

Son eylem için hata bilgisi. Yardımcı bir mesaj gösterin ve ilgili yeniden denemeyi sunun.

is_busy · yes/no

İş hâlâ devam ediyor. Başka bir eyleme başlamadan önce bekleyin.

is_scanning · yes/no

Seçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.

torch_enabled · yes/no

Seçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.

scan_source · text

Seçili öğenin mevcut değeri. İlgili olaydan sonra okuyun. empty,camera,fixture

pending_redemption · yes/no

Seçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.

scanned_pass_token · text

Seçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.