چک لیست ادغام

برای اطمینان از اینکه تمام مراحل مورد نیاز در ادغام وب خود را انجام داده‌اید، از چک لیست زیر استفاده کنید.

درباره محیط آزمایش

پیکربندی آزمایشی API گوگل پی اطلاعات پرداخت زنده و قابل پرداخت را برنمی‌گرداند، بلکه به شما امکان می‌دهد عناصر گردش کار خرید خود را آزمایش کنید. عناصر قابل آزمایش زیر هستند:

  • صفحات تأیید
  • رسیدها
  • آدرس پرداخت (اختیاری)
  • شماره تلفن صورتحساب (اختیاری)
  • آدرس ارسال (اختیاری)
  • آدرس ایمیل (اختیاری)

برای استفاده از یک محیط آزمایشی با یک پاسخ نمونه برای داده‌های پرداخت، یک PaymentsClient جدید را با یک شیء جاوا اسکریپت که حاوی یک ویژگی محیطی تنظیم شده روی TEST است، مقداردهی اولیه کنید.

نمونه کد زیر است: 
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

با کنسول توسعه‌دهندگان مرورگر خود تست کنید

وب‌سایت خود را روی آخرین نسخه یک مرورگر پشتیبانی‌شده آزمایش کنید. برای انجام این کار، ابزارهای توسعه‌دهنده مرورگر خود را باز کنید تا پیام‌های کنسول مربوط به وب‌سایت خود را مشاهده کنید. این پیام‌ها شامل خطاها یا هشدارهایی از کتابخانه کلاینت جاوا اسکریپت Google Pay API هستند. Google Pay API از Google Chrome، Mozilla Firefox، Apple Safari، Microsoft Edge، Opera و UCWeb UC Browser پشتیبانی می‌کند.

ممکن است پس از فراخوانی تابع loadPaymentData() ، خطاهای دیگری در پنجره انتخاب پرداخت گوگل نمایش داده شوند. هنگامی که پس از مشاهده پیام خطا، روی ادامه یا تأیید کلیک می‌کنید، ممکن است جزئیات بیشتری در Promise رد شده‌ای که توسط سایت شما مدیریت می‌شود، بازگردانده شود.

روی یک دستگاه سازگار تست کنید

اگرچه رابط برنامه‌نویسی کاربردی گوگل پی (Google Pay API) در بسیاری از بازارها موجود است، کارت‌های توکن‌دار فقط در زیرمجموعه‌ای از کشورها در دسترس هستند. اگر کارت‌های توکن‌دار به عنوان روش پرداخت مجاز تنظیم شده‌اند، آنها را روی یک دستگاه اندروید با کروم برای اندروید نسخه ۵۹ یا بالاتر و سرویس‌های گوگل پلی نسخه ۱۶.۰.۰ یا بالاتر آزمایش کنید. اگر روش پرداخت شما در کشور شما و توسط بانک صادرکننده شما پشتیبانی می‌شود، با کارتی که در برنامه گوگل پی ذخیره شده است، آزمایش کنید.

برای مشاهده خطاها و هشدارهای کنسول کروم برای اندروید، با اشکال‌زدایی از راه دور از کروم برای دسکتاپ آزمایش کنید. برای اطلاعات بیشتر در مورد خطاهای احتمالی، گزارش‌ها را از دستگاه اندروید خود مشاهده کنید. ممکن است بتوانید گزارش‌های خطا را با پنجره ابزار Logcat در اندروید استودیو ، با ابزار خط فرمان adb logcat یا درون یک گزارش اشکال اندروید مشاهده کنید. برای مشاهده پیام‌های خطای مربوط به API گوگل پی، WalletMerchantError را جستجو کنید.

نمونه کد زیر است:

adb logcat -s WalletMerchantError

ادغام خود را آزمایش کنید

قبل از اینکه ادغام خود را برای اعتبارسنجی با PaymentsClient پیکربندی شده برای یک محیط TEST به Google ارسال کنید، مطمئن شوید که معیارهای خروج را برای هر یک از بررسی‌های عملکردی و برندسازی زیر برآورده کرده‌اید.

۱. اصول اولیه

اطمینان حاصل کنید که بررسی‌ها و کنترل‌های ریسک موجود برای تراکنش‌های کارت یا PAN برای تراکنش‌های Google Pay نیز اعمال می‌شوند. اعتبارسنجی و بررسی‌های کلاهبرداری Google Pay قرار نیست جایگزین فرآیندهای مدیریت ریسک شما شوند.
اگر بر اساس معیارهای ریسک، به صورت انتخابی 3D Secure (احراز هویت پیشرفته) را برای تراکنش‌های معمولی کارت فعال می‌کنید، حتماً از همان معیارهای ریسک برای فعال کردن 3D Secure برای تراکنش‌های PAN PAN_ONLY گوگل پی نیز استفاده کنید.
مطمئن شوید که شرایط خدمات ما را خوانده‌اید و آماده پذیرش آن هستید. ثبت نام در API گوگل پی مستلزم آن است که آدرس ایمیل شما به یک حساب گوگل و ترجیحاً یک ایمیل تجاری مرتبط با دامنه کسب و کار شما، مانند "admin@myownpersonaldomain.com" مرتبط باشد. برای مرتبط کردن ایمیل خود با یک حساب گوگل، در فرآیند ایجاد حساب گوگل، گزینه " استفاده از آدرس ایمیل فعلی من به جای آن " را انتخاب کنید.
از داده‌های دریافتی از API گوگل پی فقط برای پردازش تراکنش‌ها استفاده کنید. سایر موارد استفاده نیاز به رضایت صریح و جداگانه کاربر دارند.
شبکه‌های کارت و روش‌های احراز هویت کارت را که توسط پردازنده پرداخت شما در کشورتان پذیرفته می‌شوند، تأیید کنید.
اگر یکپارچه‌سازی type DIRECT tokenizationSpecification را تکمیل کنید، باید سالانه کلید رمزگذاری عمومی خود را تغییر داده و با استفاده از کنسول Google Pay & Wallet، گواهی PCI را به گوگل ارائه دهید. گواهی PCI می‌تواند توسط یک شخص ثالث یا ارزیاب امنیتی واجد شرایط که توسط شورای استانداردهای امنیتی PCI تأیید شده است، ارسال شود و توسط یک فروشنده تأیید شده یا ارزیاب واجد شرایط تأیید شود.

۲. تست‌های برند

از دارایی‌های تأیید شده ما استفاده کنید و به تمام عناصر دستورالعمل‌های برند ما پایبند باشید.
مطمئن شوید که دکمه پرداخت گوگل پی فقط پس از تأیید توانایی پرداخت کاربر توسط سایت شما از طریق تابع isReadyToPay() ظاهر می‌شود.
تأیید کنید که ابعاد دکمه پرداخت Google Pay نمایش داده شده با دکمه‌ها و عناصر مشابه در صفحه مطابقت دارد.
بر اساس رنگ پس‌زمینه‌ی ناحیه‌ای که دکمه در آن ظاهر می‌شود، یک دکمه‌ی مناسب انتخاب کنید.

۳. آزمون‌های عملکردی

تأیید کنید که loadPaymentData() هنگام کلیک روی دکمه پرداخت Google Pay به صورت همزمان فراخوانی می‌شود و رفتار فعال‌سازی کاربر مرورگر را که به API Google Pay اجازه می‌دهد برگه پرداخت را نمایش دهد، حفظ می‌کند. تأیید کنید که برگه پرداخت Google Pay توسط مسدودکننده‌های پنجره‌های بازشو مسدود نشده باشد.

وقتی نوع روش پرداخت CARD را با احراز هویت کارت PAN_ONLY درخواست می‌کنید، مراحل زیر را برای انجام تست کارت‌ها در فایل انجام دهید:

  1. در صورت لزوم، تمام کارت‌های موجود در فایل pay.google.com را حذف کنید.
  2. به ادغام خود برگردید.
  3. روی گوگل پی کلیک کنید.
  4. تأیید کنید که گزینه افزودن کارت را می‌بینید.
  5. یک کارت از یک شبکه پشتیبانی‌شده، همانطور که در parameters.allowedCardNetworks تعریف شده است، اضافه کنید.
  6. تأیید کنید که کارت اضافه شده را با لوگوی شبکه در انتخابگر مشاهده می‌کنید.

آزمایش زیر فقط برای کروم در اندروید قابل اجرا است.

هنگام درخواست نوع روش پرداخت CARD با احراز هویت کارت CRYPTOGRAM_3DS ، مراحل زیر را برای انجام تست توکن دستگاه اندروید انجام دهید:

  1. بررسی کنید که صادرکننده کارت شما پشتیبانی می‌شود و یک کارت واجد شرایط را در برنامه Google Pay Android اضافه کنید.
  2. به ادغام خود برگردید.
  3. روی دکمه پرداخت گوگل پی کلیک کنید.
  4. تأیید کنید که کارت اضافه شده را به همراه طرح کارت، در انتخابگر مشاهده می‌کنید.

اگر تأیید کنید که پردازنده شما از احراز هویت کارت 3D-Secure پشتیبانی می‌کند، می‌توانید ادامه دهید، حتی اگر توکن دستگاه اندروید برای شما به عنوان کاربر اندروید یا دارنده کارت در دسترس نباشد.

اگر به آدرس ارسال نیاز دارید، پردازش آدرس ارسال را در حالت‌های مختلف تکمیل، مانند موارد زیر، آزمایش کنید:

  • مغایرت‌هایی در نام کامل که باید به فیلدهای ساختاریافته تجزیه شوند، مانند «جان»، «جان دو» و «جین دو اسمیت».
  • تمام خطوط آدرس برگردانده شده توسط API گوگل پی را به طور دقیق تجزیه و تحلیل کنید، که ممکن است از تعداد کل خطوط آدرسی که معمولاً در جریان پرداخت استاندارد شما جمع‌آوری می‌شوند، بیشتر باشد.
  • تأیید کنید که بخش کشور برگشتی آدرس با مقاصد حمل و نقل پشتیبانی شده سایت شما مطابقت دارد. اگر محدودیت‌های حمل و نقل را مشخص کرده‌اید، آنها را آزمایش کنید: یک آدرس حمل و نقل پشتیبانی نشده که در برگه پرداخت ما مجاز نیست را وارد کنید و ببینید آیا محدودیت‌ها کار می‌کنند یا خیر.

اگر از قابلیت پرداخت‌های مجاز (Authorize Payments) پشتیبانی می‌کنید، موارد زیر را تأیید کنید:

  • وقتی احراز هویت پرداخت با شکست مواجه می‌شود، یک ERROR transactionState و PaymentDataError با هدف PAYMENT_AUTHORIZATION برمی‌گرداند.

اگر از به‌روزرسانی‌های پویای قیمت پشتیبانی می‌کنید، مراحل زیر را انجام دهید:

  1. جزئیات کارت و آدرس را در برگه پرداخت اضافه کنید.
  2. گزینه‌های ارسال، لیست سفارشات و قیمت کل را به‌روزرسانی کنید.
    3. مهم : مطمئن شوید که قیمت کل با مبلغ تراکنش مطابقت دارد. در غیر این صورت، می‌تواند بر ارزش شاخص تجارت الکترونیک (ECI) و طرف مسئول تأثیر بگذارد.
  3. یک آدرس ارسال اضافه و انتخاب کنید.
  4. گزینه‌های ارسال، لیست سفارشات و قیمت کل را به‌روزرسانی کنید.
  5. یک گزینه ارسال را انتخاب کنید.
  6. لیست سفارشات و قیمت کل را به‌روزرسانی کنید.
  7. نتایج خود را تأیید کنید:
    • اگر آدرس ارسال، گزینه‌های ارسال موجود را ندارد، با استفاده از SHIPPING_ADDRESS ، دریافت PaymentDataError را تأیید کنید.
    • اگر گزینه ارسال انتخاب شده نامعتبر است، با استفاده از هدف SHIPPING_OPTION ، تأیید کنید که PaymentDataError دریافت می‌کنید.
    • اگر احراز هویت پرداخت با شکست مواجه شد، با استفاده از هدف PAYMENT_AUTHORIZATION ، دریافت ERROR transactionState و PaymentDataError را تأیید کنید.
اگر به شماره تلفن نیاز دارید، آن را از آدرس صورتحساب درخواست کنید. سپس، بررسی کنید که آیا می‌توانید شماره تلفن را با استانداردهای داده وب‌سایت خود با فرمت‌های مختلف مانند "+8005550100"، "18005550100" و "(800) 555-0100" تجزیه و ذخیره کنید.
مطمئن شوید که گوگل پی (Google Pay) به طور مساوی با سایر روش‌های پرداخت شخص ثالث نمایش داده می‌شود.
برای کاربرانی که قبلاً هنگام پرداخت، Google Pay را انتخاب کرده و Google Pay را به عنوان روش پرداخت ترجیحی خود در وب‌سایت شما مشخص کرده‌اند، Google Pay باید به عنوان روش پرداخت پیش‌فرض برای خرید بعدی آنها انتخاب شود.
قبل از پردازش تراکنش، باید قیمت نهایی به کاربر نمایش داده شود. اگر مبلغ قابل پرداخت بر اساس داده‌های دریافتی از API گوگل پی متفاوت باشد، انتظار می‌رود صفحه تأییدی با قیمت نهایی نمایش داده شود.