ویژگی ثبت نام کارت هدیه (ورود به سیستم) به کاربران اجازه می دهد تا کارت هدیه را جستجو کرده و آن را به کیف پول Google اضافه کنند. کاربران برای تکمیل فرآیند به وب سایت سازگار با موبایل شما هدایت می شوند و پس از آن می توانند کارت خود را به Google Wallet اضافه کنند.
این راهنما یک نمای کلی از مراحل پیاده سازی مورد نیاز برای فعال کردن برنامه کارت هدیه شما برای این ویژگی ارائه می دهد.
نمای کلی
برای شروع، مطمئن شوید که قبلا پروژه خود را راه اندازی کرده اید و به Google Wallet API دسترسی دارید.
برای اجرای ویژگی ورود به سیستم برای برنامه کارت هدیه خود باید این چهار مرحله را دنبال کنید:
- یک کلاس آزمایشی در Google Wallet برای آزمایش جریان ورود به سیستم خود راه اندازی کنید.
- صفحات ورود به سیستم را توسعه دهید که از Google Wallet
SharedDataTypeاستفاده می کنند. - پس از ورود به سیستم، کارت هدیه را به Google Wallet بازگردانید.
- درخواست تایید و فعال سازی.
یک کلاس آزمایشی در Google Wallet راه اندازی کنید
URL ورود به سیستم، لوگوی برنامه خود را تعیین کنید. سپس، از فیلدهای تودرتوی discoverableProgram در giftcardclass برای تنظیم مقادیر مناسب استفاده کنید.
مقادیر را در discoverableProgram تنظیم کنید تا یک نسخه پیش نویس از برنامه کارت هدیه فعال شده ورود به سیستم خود ایجاد کنید. برای اطمینان از اینکه این مورد برای آزمایش‌کنندگان قابل مشاهده است، بررسی کنید که آزمایش‌کنندگان به Google Pay و کنسول Wallet شما دسترسی دارند. برای جزئیات در مورد نحوه اشتراک گذاری دسترسی Google Pay و Wallet Console خود با افراد دیگر، به صفحه اطلاعات کاربران مراجعه کنید.
برای تکمیل تأیید عملکرد پیاده‌سازی خود در طول فرآیند توسعه، با استفاده از ابزارک پشتیبانی تماس در Google Pay و Wallet Console با ما تماس بگیرید. هنگامی که در کنسول هستید، Google Wallet API را در موضوع انتخاب کنید و ورود به کارت هدیه را در موضوع فرعی انتخاب کنید.
صفحه ورود به سیستم را ایجاد کنید که از داده های کاربر Google Wallet استفاده می کند
هنگامی که کاربر انتخاب می کند کارت هدیه شما را اضافه کند، به یک صفحه اختصاصی در وب سایت شما هدایت می شود تا فرآیند ورود به سیستم را تکمیل کند.
شما باید یک URL ورود به سیستم ارائه دهید که در آن کاربر می تواند به یک حساب موجود وارد شود.
صفحه ورود شما باید شرایط زیر را داشته باشد:
- یک تجربه کاربری سازگار با موبایل ارائه دهید.
- به کاربر اجازه دهید تا ورود به سیستم را در یک صفحه کامل کند.
- از رمزگذاری
HTTPSبا گواهی معتبر برای اطمینان از انتقال ایمن داده های کاربر استفاده کنید. - حداقل 99.9% آپتایم صفحه ورود خود را تضمین کنید.
هنگام ارائه صفحه ورود به سیستم، Google Wallet یک WebView Android ایجاد می کند و یک درخواست POST به URL ارائه شده شما ارسال می شود. داده های کاربر در پارامتر SharedDataType ارائه می شود که در درخواست POST با استفاده از نوع محتوای application/x-www-form-urlencoded و رمزگذاری UTF-8 گنجانده شده است. مقدار پارامتر SharedDataType یک شی JSON کدگذاری شده Base64 است.
بازگرداندن فوری کارت هدیه به Google Wallet
پس از احراز هویت (ورود به سیستم)، صفحه شما باید بلافاصله کارت هدیه کاربر را به Google Wallet بازگرداند.
می‌توانید با هدایت کردن به پیوندی که ساختار را دنبال می‌کند، کارت هدیه را به Google Wallet بازگردانید
https://pay.google.com/gp/v/save/{jwt_generated}طول امن برای URL 2000 کاراکتر است. پیوندهای شما باید زیر این محدودیت باقی بمانند. اشیایی که در JWT کدگذاری می شوند باید کوچک باشند و فقط حاوی داده هایی باشند که مختص کاربر است. سعی کنید بیشتر داده ها را در کلاس شیء نگه دارید و قبل از ساخت JWT آن را ایجاد کنید. برای اشیاء بزرگتر که با محدودیت مطابقت ندارند، ابتدا شیء را در Google Wallet API ایجاد کنید و فقط شناسه شی را در JWT ارسال کنید.
جریان ارتباطی معمولی
جریان ارتباطی برای کاربر در حال تکمیل ورود به سیستم در تصویر زیر نشان داده شده است. تمامی اقدامات بین "سرور شما" مسئولیت اجرای شماست.
درخواست تایید و فعال سازی
پس از تکمیل کار توسعه و آزمایش جریان ورود به سیستم، درخواستی را از طریق ابزارک پشتیبانی تماس Google Pay و Wallet Console ارسال کنید.
پس از بررسی کامل اجرای شما که ویژگی صحیح را در ترکیب با برنامه Google Wallet تأیید می‌کند، ویژگی ورود به سیستم کارت هدیه به صورت عمومی برای برنامه کارت هدیه شما راه‌اندازی می‌شود. این به هر کاربری اجازه می دهد تا برنامه را ببیند و از این ویژگی استفاده کند.
به منظور اطمینان از تجربه کاربری بهینه، بررسی های مکرر اجرای ورود به سیستم شما برای اطمینان از انطباق مداوم با الزامات ویژگی انجام می شود. در صورت وجود مغایرت به شما اطلاع داده می شود و ممکن است ویژگی ورود به سیستم تا رفع مشکل غیرفعال شود.
سوالات متداول
- آیا برای تصاویر استفاده شده در برنامه کارت هدیه من شرایطی وجود دارد؟
- بله، تصاویر شما باید در مکان
HTTPSمیزبانی شوند زیرا در غیر این صورت در Google Wallet قابل مشاهده نخواهند بود.
- بله، تصاویر شما باید در مکان
- آیا ابزاری وجود دارد که پیاده سازی و اشکال زدایی JWT ها را ساده کند؟
- بله، پلتفرم‌هایی مانند www.jwt.io به شما امکان می‌دهند توکن‌های خود را در طول فرآیند توسعه خود رمزگشایی و اشکال‌زدایی کنید و به شما امکان می‌دهند محتوایی را که ارسال می‌کنید تأیید کنید. توجه داشته باشید که Google هیچ وابستگی ندارد و به طور خاص هیچ یک از این اشخاص ثالث را توصیه نمی کند.
- چگونه داده های SharedDataType رمزگذاری شده Base64 را به درستی مدیریت کنیم؟
- اطمینان حاصل کنید که در طول فرآیند خود از رمزگذاری UTF-8 استفاده می کنید. رشته JSON ابتدا با UTF-8 کدگذاری می شود و سپس با استفاده از android.util.Base64 با گزینه های NO_WRAP و URL_SAFE کدگذاری می شود. این با بخش 4 RFC 3548 مطابقت دارد.