نمای کلی شناسه های مجموعه

این صفحه شناسه های استفاده شده توسط پروتکل Smart Tap را شرح می دهد.

بررسی اجمالی

پروتکل Smart Tap اطلاعات مربوط به مجوز ذخیره شده در برنامه Google Wallet کاربر و برنامه ترمینال را منتقل می کند. نمودار زیر جریان ارتباط بین ترمینال و Google Wallet را خلاصه می کند:

جریان ارتباط با توافق بر سر پروتکل برای استفاده، تبادل کلید و سپس تبادل پاس شروع می شود.

از آنجا که تاجران ممکن است از چندین کسب و کار یا پیمانکار برای توسعه مجوزهای خود استفاده کنند، Google از سه شناسه برای تسهیل ارسال اطلاعات بین Google Wallet و پایانه‌ها استفاده می‌کند. این به تاجرانی که از یک ارائه‌دهنده ترمینال خاص استفاده می‌کنند اجازه می‌دهد تا مجوزهای توسعه‌دهندگان مختلف را پس‌خرید کنند. شناسه‌های زیر سه «شناسه مجموعه» هستند که در پروتکل Smart Tap استفاده می‌شوند.

شناسه صادرکننده بازخرید

شناسه صادرکننده Redemption نوع خاصی از شناسه صادرکننده است. شناسه صادرکننده Redemption معمولاً نشان دهنده یک تاجر است. در مقابل، شناسه صادرکننده برای یک توسعه‌دهنده مجوز ممکن است نشان‌دهنده پلتفرمی باشد که کلاس‌های عبور را برای بسیاری از تاجران مختلف ذخیره می‌کند. پلتفرمی که کلاس‌های عبور را برای چندین بازرگان ذخیره می‌کند، Aggregator نیز نامیده می‌شود.

Redemption Issuers برای مواردی بیش از Smart Tap استفاده می شود. برای مثال، Redemption Issuer همچنین برای ارائه یادآوری‌های اعلان مبتنی بر جغرافیا بر اساس مکان‌های Redemption Issuer استفاده می‌شود. بنابراین، شناسه صادرکننده‌ای که به‌عنوان صادرکننده بازخرید در یک پاس فهرست شده است ممکن است برای Smart Tap پیکربندی نشود.

شناسه صادرکننده بازخرید در مقابل شناسه صادرکننده

شناسه صادرکننده یک شناسه منحصر به فرد حساب صادرکننده کیف پول Google است. شناسه صادرکننده را می‌توانید در Google Pay & Wallet Console پیدا کنید.

یک صادرکننده می‌تواند نماینده یک تاجر (مانند یک رستوران)، یک ارائه‌دهنده پیشنهاد، یا یک سازنده پایانه و موارد دیگر باشد. وقتی کلاس‌ها و اشیاء پاس توسعه می‌یابند، به شناسه صادرکننده خاصی مرتبط می‌شوند. شناسه صادرکننده در هر دو شناسه کلاس پاس و شناسه شی گنجانده شده است.

شناسه قالب یادداشت
شناسه کلاس issuerId.classSuffix classSuffix یک مقدار منحصر به فرد و تعریف شده توسط توسعه دهنده برای یک کلاس عبور خاص (مثلاً یک ردیف وفاداری) است.
شناسه شی issuerId.objectSuffix objectSuffix یک مقدار منحصر به فرد و تعریف شده توسط توسعه دهنده برای یک شی عبور خاص (مانند شناسه کاربر) است.

یک صادرکننده می تواند به تعداد مورد نیاز کلاس ایجاد کند.

شناسه گردآورنده

اگر تاجری از Smart Tap در پایانه‌های خود پشتیبانی کند، صادرکننده Redemption او یک شناسه جمع‌آوری خواهد داشت. شناسه جمع کننده یک شناسه عددی (8 رقمی) است که پایانه ها برای شناسایی خود از آن استفاده می کنند. از آنجایی که ممکن است یک صادرکننده Redemption از چندین تاجر پشتیبانی کند، شناسه جمع‌آوری برای درخواست مجوز یک تاجر خاص استفاده می‌شود.

هنگامی که کاربر دستگاه خود را به ترمینال دارای Smart Tap می‌زند، پایانه شناسه جمع‌آوری را به دستگاه کاربر ارسال می‌کند. سپس دستگاه با استفاده از کلید عمومی برای شناسه جمع کننده با ترمینال احراز هویت می شود. برای اطلاعات بیشتر به جریان ارتباط مراجعه کنید.

یادداشت های مهم:

  • فقط یک شناسه جمع کننده به شناسه صادرکننده اختصاص داده شده است
  • شناسه گردآورنده در همه شناسه‌های صادرکننده منحصربه‌فرد است

برای دریافت شناسه جمع‌آوری برای شناسه صادرکننده، به پیکربندی تاجر مراجعه کنید.

شناسه کلاس را پاس کنید

شناسه کلاس یک ردیف یا نوع پاس خاص را مشخص می کند. شناسه کلاس از فرمت زیر پیروی می کند:

issuerId.classSuffix

پسوند کلاس یک مقدار تعریف شده توسط توسعه دهنده است که منحصر به این کلاس عبور است. یک شیء عبور که به این شناسه کلاس ارجاع می‌دهد در برنامه Google Wallet کاربر ذخیره می‌شود.