پرسشگان

این صفحه اطلاعات کلی و پرسشگان درباره Google Pay API را ارائه می‌دهد.

درباره Google Pay API

Google Pay تسویه‌حساب بی‌دردسر را برای برنامه و وب‌سایت شما امکان‌پذیر می‌کند. با Google Pay API، مشتریانتان می‌توانند از کارت‌های ذخیره‌شده در «حساب Google» خود برای تسویه‌حساب یکپارچه در برنامه‌ها و سایت‌های شما استفاده کنند.

نحوه دریافت پشتیبانی

در کنسول کیف پول و Google Pay ثبت‌نام کنید و «تماس با پشتیبانی» را انتخاب کنید. می‌توانیم به شما کمک کنیم ادغام‌هایتان را عیب‌یابی کنید. علاوه‌براین، برای اشکال‌زدایی ادغام خودتان، به راهنمای عیب‌یابی Android و راهنمای عیب‌یابی وب ما مراجعه کنید.

ویژگی‌های پشتیبانی‌شده

‫Google Pay API چندین ویژگی پشتیبانی‌شده دارد.

روش‌های پرداخت پشتیبانی‌شده

میانای برنامه‌سازی کاربردی Google Pay ممکن است کارت‌ها یا توکن‌های شبکه را برگرداند.

صورت‌حساب تکرارشونده و اشتراک‌ها

پشتیبانی از صورت‌حساب تکرارشونده به روش پرداخت برگردانده‌شده در پاسخ Google Pay API وابسته است. هم از کارت‌های نشان‌گذاری‌شده و هم از کارت‌های ثبت‌شده می‌توان برای صورت‌حساب تکرارشونده استفاده کرد. برای پردازش صورت‌حساب تکرارشونده، فروشنده لازم نیست میانای برنامه‌سازی کاربردی ما را با آهنگ فراخوانی کند. بلکه اطلاعات اعتباری پرداخت برای پرداخت‌های تکرارشونده در سمت فروشنده ذخیره می‌شود. فروشنده از میاناهای برنامه‌سازی کاربردی درگاه پرداخت خود برای مدیریت صورت‌حساب تکرارشونده استفاده می‌کند.

اگر بیانیه‌های زیر درست باشند، Google Pay از پرداخت‌های تکرارشونده پشتیبانی می‌کند:

  • فروشندگان از قوانین شبکه، مانند تراکنش‌های آغازشده توسط فروشنده، پیروی می‌کنند.
  • شرایط پرداخت در جریان خرید بازرگان برای کاربر آشکار می‌شود و کاربر آن را می‌پذیرد.

همچنین از صورت‌حساب تکرارشونده با مبالغ متغیر پشتیبانی می‌کنیم. برای مثال، صورت‌حساب‌های ماهانه تلفن برای شرکت‌های مخابراتی تلفن همراه پشتیبانی می‌شود. برای دریافت اطلاعات بیشتر، فروشندگان باید با نماینده درگاه پرداخت خود تماس بگیرند.

شارژ مجدد خودکار یا «افزودن موجودی»

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

استردادهای وجه

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

جمع‌آوری کمک مالی

سازمان‌های غیرانتفاعی (NPO) تأییدشده می‌توانند Google Pay API را برای جمع‌آوری کمک‌های مالی ادغام کنند، اگر، و فقط اگر، اسنادی برای اثبات، گواهی، و اعتبارسنجی وضعیت غیرانتفاعی خود ارائه دهند. برای مثال، سازمان‌های غیرانتفاعی ایالات متحده برای واجدشرایط شدن باید مدرک معتبر وضعیت 501(c)3 از IRS ارائه دهند.

شرایط و خط‌مشی‌ها

شرایط خدمات Google Pay

همه فروشندگان باید با «شرایط خدمات» Google Pay موافقت کنند و از آن پیروی کنند.

خط‌مشی استفاده مجاز از Google Pay API

همه فروشندگان باید با خط‌مشی استفاده قابل‌قبول Google Pay API موافقت کنند و از آن پیروی کنند.

خط‌مشی قمار

خط‌مشی ما درباره قمار در خط‌مشی استفاده مجاز «میانای برنامه‌سازی کاربردی Google Pay» تعریف شده است.

خط‌مشی ما درباره قمار ممکن است هرچندوقت یک‌بار تغییر کند. همه موارد ارسالی باید بازبینی و تأیید شوند.

ما ادغام‌های قمار را از شرکت‌های مستقر در کشورهای زیر می‌پذیریم:

  • استرالیا
  • اتریش
  • کانادا
  • جمهوری چک
  • فرانسه
  • گرجستان
  • آلمان
  • یونان
  • مجارستان
  • ایرلند
  • ایتالیا
  • ژاپن
  • هلند
  • لهستان
  • پرتغال
  • رومانی
  • اسپانیا
  • سوئد
  • بریتانیا

در مراحل بعدی، ممکن است تصمیم بگیریم پشتیبانی را فراتر از سطح فعلی گسترش دهیم.

برای دریافت دسترسی تولید به «میانای برنامه‌سازی کاربردی Google Pay» برای ادغام‌های قمار، باید مجموعه‌ای از پیش‌نیازها را تکمیل کنید:

  • اگر ادغام شرط‌بندی مختص Android دارید که در یکی از کشورهای ذکرشده در بالا مستقر است، باید خط‌مشی شرط‌بندی Google Play را رعایت کنید و ابتدا در فرایند بررسی Google Play ثبت‌نام کنید. سپس می‌توانیم یکپارچه‌سازی فقط Android شما را برای دسترسی به تولید «میانای برنامه‌سازی کاربردی Google Pay» ارزیابی کنیم.
  • اگر ادغام قمار فقط مبتنی بر وب در یکی از کشورهای ذکرشده در بالا دارید، باید پروانه مجاز ارسال کنید تا واجدشرایط بودن خود را برای ارائه خدمات قمار در کشور درطول فرایند آماده‌سازی با Google Pay API اثبات کنید. سپس می‌توانیم یکپارچه‌سازی فقط وب شما را برای دسترسی تولید به Google Pay API ارزیابی کنیم.
  • اگر در یکی از کشورهای ذکرشده در بالا، ادغام شرط‌بندی Android و وب دارید، باید خط‌مشی شرط‌بندی Google Play را رعایت کنید و ابتدا با فرایند بررسی Google Play آماده‌سازی شوید. سپس می‌توانیم یکپارچه‌سازی‌های Android و وب شما را برای دسترسی به تولید «میانای برنامه‌سازی کاربردی Google Pay» ارزیابی کنیم.

کشورهای دارای شرایط یا محدودیت‌های خاص

ادغام‌های قمار برای کشورهای فهرست‌شده مجاز است اگر معیارهای زیر را برآورده کنند:

کشور واجدشرایط بودن برای ادغام Android واجدشرایط بودن برای ادغام وب
بلغارستان بله، با محدودیت:
  • برنامه‌هایی که به وب‌سایت هدایت می‌کنند واجدشرایط هستند.
  • برنامه‌هایی که به وب‌سایت هدایت نمی‌کنند ممنوع هستند.
 بله
قبرس بله، با محدودیت:
  • قرعه‌کشی ایالتی واجدشرایط است.
  • ‫OPAP Cyprus Limited واجدشرایط است.
  • کازینوهای آنلاین ممنوع هستند.
  • دستگاه‌های بخت‌آزمایی ممنوع است.
  • شرط‌بندی روی مسابقات اسب‌دوانی ممنوع است.
  • شرط‌بندی روی مسابقات سگ‌دوانی ممنوع است.
  • شرط‌بندی گستره‌ای ممنوع است.
  • مبادله شرط‌بندی ممنوع است.
 بله، با محدودیت:
  • قرعه‌کشی ایالتی واجدشرایط است.
  • ‫OPAP Cyprus Limited واجدشرایط است.
  • کازینوهای آنلاین ممنوع هستند.
  • دستگاه‌های بخت‌آزمایی ممنوع است.
  • شرط‌بندی روی مسابقات اسب‌دوانی ممنوع است.
  • شرط‌بندی روی مسابقات سگ‌دوانی ممنوع است.
  • شرط‌بندی گستره‌ای ممنوع است.
  • مبادله شرط‌بندی ممنوع است.
فنلاند بله، با محدودیت:
  • Veikkaus Oy واجدشرایط است.
 بله، با محدودیت:
  • Veikkaus Oy واجدشرایط است.
قزاقستان بله، با محدودیت:
  • بخت‌آزمایی‌ها واجدشرایط هستند.
  • شرط‌بندی ورزشی واجدشرایط است.
  • توتالیزاتورها واجدشرایط هستند.
  • کازینوهای آنلاین ممنوع هستند.
  • کازینوهای الکترونیکی ممنوع است.
 بله، با محدودیت:
  • بخت‌آزمایی‌ها واجدشرایط هستند.
  • شرط‌بندی ورزشی واجدشرایط است.
  • توتالیزاتورها واجدشرایط هستند.
  • کازینوهای آنلاین ممنوع هستند.
  • کازینوهای الکترونیکی ممنوع است.
لهستان نه بله، با محدودیت:
  • ارائه‌دهندگان دارای پروانه قمار واجدشرایط هستند.
افریقای جنوبی بله، با محدودیت:
  • شرط‌بندی ورزشی آنلاین واجدشرایط است.
 بله، با محدودیت:
  • شرط‌بندی ورزشی آنلاین واجدشرایط است.

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

خط‌مشی بهداشت و درمان

خط‌مشی ما درباره «مراقبت‌های بهداشتی» در خط‌مشی استفاده قابل‌قبول Google Pay API تعریف شده است.

برای ارائه پروانه مربوطه درطول فرایند آماده‌سازی برای تأیید مورد استفاده «مراقبت‌های بهداشتی» خود آماده باشید. همه ارسال‌ها مشمول مرور و تأیید هستند.

خط‌مشی «خدمات مالی»

خط‌مشی ما درباره «خدمات مالی» در خط‌مشی استفاده پذیرفتنی Google Pay API تعریف شده است.

آماده باشید که هنگام آماده‌سازی، پروانه مربوطه را برای تأیید مورد استفاده «خدمات مالی» خود هم‌رسانی کنید. همه موارد ارسالی مشمول مرور و تأیید هستند.

پرسشگان عمومی

پرسشگان زیر برای فروشندگان اعمال می‌شود:

از یک PSP اصلی برای مدیریت همه ریسک‌ها و «اصالت‌سنجی قوی مشتری» استفاده می‌کنم. چه چیزهایی باید درباره GPay بدانم؟

«میانای برنامه‌سازی کاربردی Google Pay» روش‌های پرداخت را در یک بار اطلاعات امضاشده و رمزگذاری‌شده برمی‌گرداند. روش‌های پرداخت برگردانده‌شده شامل PAN یا کارت‌های نشان‌گذاری‌شده متشکل از PAN دستگاه (DPAN) و رمزنگاری‌ها است.

محموله‌های کارت کدگذاری‌شده بدون مرحله اضافی یا چالش پردازش می‌شوند.

باربرگ‌های کارت که از «شماره حساب اصلی» تشکیل شده‌اند، ازطریق راهکار داخلی یا ارائه‌شده توسط «ارائه‌دهنده خدمات پرداخت» به 3D Secure نیاز دارند.

اگر «ارائه‌دهنده خدمات پرداخت» شما همه منطق‌های خطر و «احراز هویت قوی مشتری» را مدیریت می‌کند، مطمئن شوید که ادغام Google Pay API شما شامل ویژگی‌های زیر باشد:

  • merchantInfo.merchantName (Android، وب): نام فروشنده در برگ پرداخت ارائه می‌شود.
  • transactionInfo.countryCode (Android، وب): این نشان می‌دهد که تراکنش کجا پردازش می‌شود. باید کشور بانک پذیرنده را مشخص کنید.
  • transactionInfo.totalPrice (Android، وب): ارزش پولی کل تراکنش با دقت اعشاری اختیاری دو رقم اعشار.
چگونه شناسه فروشنده Google دریافت کنم؟
پس‌از اینکه Google وب‌سایتتان را تأیید کرد می‌توانید شناسه فروشنده Google دریافت کنید. برای شروع این فرایند، به سیستم کنسول کیف پول و Google Pay وارد شوید و ادغام Google Pay API را ایجاد کنید. باید فهرستی از دامنه‌های کاملاً واجدشرایط را به‌همراه زیردامنه‌ها ارائه دهید تا به شما کمک کند Google Pay API را فراخوانی کنید.
آیا می‌توانیم از یک شناسه Merchant در چندین نمانام و کانال (وب/برنامه) استفاده کنیم؟
بله، استفاده از یک «شناسه فروشنده» در چندین نمانام و پلاتفرم (مانند وب و Android) پشتیبانی می‌شود و معمولاً برای ساده کردن تطبیق توصیه می‌شود.
فروشندگان چگونه می‌توانند پذیرش Google Pay را در برنامه‌ها و سایت‌های خود به کاربرانشان تبلیغ کنند؟
برای برجسته کردن پشتیبانی از Google Pay، حتماً از دارایی‌های موجود در دستورالعمل‌های نمانام Android و وب ما استفاده کنید.
اگر ادغام Android دارید، می‌توانید در شرح «فروشگاه Play» ذکر کنید که اکنون از Google Pay پشتیبانی می‌کنید. برای ادغام‌های وب، می‌توانید مستقیماً شرحی به وب‌سایت فروشنده اضافه کنید.
آیا پلاتفرم‌های تجارت الکترونیک می‌توانند از Google Pay پشتیبانی کنند؟
بله، «میانای برنامه‌سازی کاربردی Google Pay» از پلاتفرم‌های تجارت الکترونیک درحال آماده‌سازی پشتیبانی می‌کند. پردازشگر پرداخت، درگاه، یا شرکای پلاتفرم تجارت الکترونیک که صفحه تسویه‌حساب را ازطرف فروشندگانشان میزبانی می‌کنند می‌توانند از ویژگی تسویه‌حساب میزبانی‌شده Google Pay استفاده کنند.
کدام ارائه‌دهندگان پرداخت از Google Pay پشتیبانی می‌کنند؟
برای دیدن فهرست پردازنده‌هایی که از Google Pay پشتیبانی می‌کنند، به فهرست پردازنده‌های Google Pay مراجعه کنید.
کدام کشورها و مناطق برای Google Pay پشتیبانی می‌شوند؟
به فهرست کشورهای پشتیبانی‌شده که از Google Pay برای پرداخت آنلاین یا در برنامه‌ها استفاده می‌کنند نگاهی بیندازید.
کدام کشورها و مناطق از نشان‌های Google Pay (CRYPTOGRAM_3DS) پشتیبانی می‌کنند؟
برای مشاهده فهرست کشورها و بانک‌هایی که در هر کشور از توکن‌های Google Pay پشتیبانی می‌کنند، به صفحه پیدا کردن روش‌های پرداخت پشتیبانی‌شده برای خریدهای غیرلمسی و درون‌فروشگاهی ما مراجعه کنید (CRYPTOGRAM_3DS). کارت‌های پشتیبانی‌شده و پشتیبانی‌نشده فهرست شده‌اند.
تفاوت بین «صورت‌حساب درون‌برنامه‌ای Google Play» و Google Pay API چیست؟
توسعه‌دهندگان Google Play که کالاها و خدمات دیجیتال را در برنامه‌های Android می‌فروشند باید از «صورت‌حساب درون‌برنامه‌ای Google Play» استفاده کنند، همان‌طور که در مرکز خط‌مشی توسعه‌دهندگان Play مشخص شده است. نمونه‌های «خدمات صورت‌حساب درون‌برنامه» شامل محصولات بازی مجازی، ویژگی‌ها یا محتوای برنامه، و محصولات نرم‌افزاری ابری است. برای کسب اطلاعات بیشتر درباره «خدمات صورت‌حساب درون‌برنامه‌ای»، صفحه نمای کلی خدمات صورت‌حساب Google Play را ببینید.
وقتی از Google Pay API در برنامه‌ها استفاده می‌شود، این API فقط برای محصولات و خدمات فیزیکی دردسترس است.
آیا Google Pay کارمزدی دریافت می‌کند؟
Google Pay از کاربران، فروشندگان، و توسعه‌دهندگان کارمزد اضافی برای استفاده از Google Pay API برای پرداخت‌ها دریافت نمی‌کند. به‌ویژه فروشندگان همچنان کارمزد پردازش را به پردازشگر پرداخت خود پرداخت می‌کنند.
‫Google برای اعتبارسنجی اطلاعات اعتباری و جلوگیری از کلاهبرداری چه می‌کند؟
همه کارت‌های اضافه‌شده به Google برای اعتبارسنجی جزئیات کارت، ازجمله کد درستی‌سنجی کارت (CVC)، تحت مجوز درستی‌سنجی قرار می‌گیرند. Google همچنین موتور خطر اختصاصی خود را براساس داده‌های ابزار، نمایه‌های «حساب Google»، سابقه خرید، مکان‌ها، و اطلاعات دستگاه اجرا می‌کند. بااین‌حال، فروشندگان باید همچنان از ابزارهای ارزیابی مخاطره و کلاهبرداری فعلی خود برای تراکنش‌های Google Pay استفاده کنند.
آیا Google Pay در «وب‌نماهای» برنامه تلفن همراه پشتیبانی می‌شود؟
Android WebViews به‌طور کامل از Google Pay پشتیبانی می‌کند و تجربه وب تلفن همراه را تقلید می‌کند، به‌شرطی که وابستگی WebKit لازم را اضافه کنید. بااین‌حال، در iOS WebViews، به‌دلیل محدودیت‌های iOS در کوکی‌های طرف سوم، isReadyToPay API همیشه false را برمی‌گرداند. هم برنامه Android و هم دامنه وب‌سایت در «وب‌نما» باید برای دسترسی تولید تأیید شوند. برای جزئیات دقیق پیاده‌سازی، به اسناد استفاده از Android WebView یا استفاده از iOS WKWebview مراجعه کنید.
پردازنده من در فهرست نیست. آیا همچنان می‌توانم با Google Pay ادغام کنم؟
Google Pay به‌طور مداوم درحال ایجاد مشارکت با پلاتفرم‌های تجارت الکترونیک و پردازشگرهای پرداخت است. اگر نمی‌توانید پردازشگرتان را در g.co/pay/processors پیدا کنید، می‌توانید درخواست ارسال کنید. وقتی پردازشگرتان دردسترس قرار گرفت، به شما اطلاع داده می‌شود.
اگر ازقبل پردازشگر پرداخت یا ارائه‌دهنده پلاتفرم پرداخت داشته باشم، چگونه Google Pay را فعال کنم؟
‫Google Pay با انواع ارائه‌دهندگان خدمات پرداخت و ارائه‌دهندگان پلاتفرم تجارت الکترونیک کار می‌کند. هرکدام اسناد خاص و سفارشی‌شده‌ای را برای کمک به شروع کار شما ارائه می‌دهند، به‌همراه آموزش گام‌به‌گام اصلی ما برای آشناسازی آسان.
اگر پردازشگر پرداخت پشتیبانی‌شده هستم، چگونه می‌توانم Google Pay را در مقیاس بزرگ به فروشندگانم ارائه دهم؟
پردازشگرهای پرداخت پشتیبانی‌شده می‌توانند راهکار تسویه‌حساب میزبانی‌شده ما را برای ادغام‌های وب پیاده‌سازی کنند. تسویه‌حساب میزبانی‌شده به مشتریان شما امکان می‌دهد Google Pay را به مشتریانشان ارائه دهند و از آماده‌سازی فردی با Google Pay صرف‌نظر کنند.

برای شروع، ابتدا باید به‌عنوان پردازشگر پرداخت پشتیبانی‌شده آماده‌سازی شوید. برای ادغام کردن راهکار تسویه‌حساب میزبانی‌شده، با مسئول فنی Google که در آماده‌سازی شما کمک کرده است تماس بگیرید.

اگر در روند تسویه‌حسابم ارسال کالا ارائه دهم، Google Pay چگونه می‌تواند گزینه‌های ارسال مختلف و قیمت‌های متفاوت را برای کاربرانم فراهم کند؟
برای یکپارچه‌سازی‌های وب، به نشانی ارسال کالا نیاز دارید و گزینه‌های ارسال کالا و قیمت‌گذاری متفاوتی را در شیء PaymentDataRequest، شیء PaymentOptions، و شیء PaymentDataCallbacks نمایش دهید. برای نمونه‌ای از این وضعیت، به نسخه نمایشی به‌روزرسانی قیمت پویا مراجعه کنید.

برای ادغام‌های Android، به نشانی ارسال کالا در شیء PaymentDataRequest نیاز دارید.

چگونه پول خریدهای انجام‌شده با Google Pay را دریافت کنم؟
«میانای برنامه‌سازی کاربردی Google Pay» با انتقال اطلاعات پرداخت از کاربران به ارائه‌دهنده خدمات پرداخت شما، تراکنش‌ها را تسهیل می‌کند. این سرویس در جریان پول نیست و به‌گونه‌ای طراحی شده است که روی زیرساخت پرداخت موجود شما قرار بگیرد.
شرایط لازم برای دسترسی به «تولید» چیست؟
فروشندگان باید در «کنسول کیف پول و Google Pay» یک «نمایه کسب‌وکار» ایجاد کنند و نماگرفت‌هایی از جریان خرید خود را برای بازبینی بارگذاری کنند. هر دامنه‌ای که میزبان Google Pay API است باید به‌طور جداگانه برای تأیید ارسال شود، زیرا دامنه‌های عام (مانند ‎*.merchant.com) پذیرفته نمی‌شوند. برای اطلاعات بیشتر، به صفحه «انتشار ادغام» برای Android و/یا وب مراجعه کنید.
چگونه می‌توانم از وضعیت ارسال ادغامم مطلع شوم و بدانم که آیا باید پس‌از فرایند بازبینی شما تغییری ایجاد کنم؟
پس‌از ارسال یکپارچه‌سازی Google Pay API برای بازبینی، ایمیلی حاوی نتایج دریافت می‌کنید. اگر ادغام شما از «خط‌مشی استفاده قابل‌قبول» و رهنمودهای نمانام ما پیروی کند، تأیید می‌شود و وضعیت آن در «کنسول کیف پول و Google Pay» به‌صورت فعال نشان داده می‌شود. اگر نیاز به تغییر داشته باشد، وضعیت نیاز به اطلاعات بیشتر را نشان می‌دهد و ایمیل جزئیات مواردی را که باید قبل‌از ارسال مجدد اصلاح شود ارائه می‌دهد. برای هرگونه پرسش درباره ارسال، می‌توانید مستقیماً از «کنسول Pay و کیف پول Google» با پشتیبانی تماس بگیرید.
اگر پیام خطا دیدم، چگونه می‌توانم یکپارچه‌سازی میانای برنامه‌سازی کاربردی Google Pay خود را عیب‌یابی کنم؟
برای کدهای خطای رایج و راه‌حل‌ها، راهنماهای عیب‌یابی ما را برای Android و وب بررسی کنید. اگر سؤالات بیشتری دارید، ازطریق «کنسول کیف پول و Google Pay» با پشتیبانی تماس بگیرید.
چگونه می‌توانم یکپارچه‌سازی Google Pay API را سفارشی‌سازی کنم تا کارت‌ها را محدود کنم؟
همه سفارشی‌سازی‌های کارت‌ها در شیء CardParameters برای هر دو Android و وب دردسترس است. برای مثال، می‌توانید انتخاب کنید کدام شبکه‌های کارت و کدام کشورهای صادرکننده کارت مجاز باشند.
میانای برنامه‌سازی کاربردی Google Pay چیست؟
Google Pay API به مشتریانتان اجازه می‌دهد با فشار دادن یک دکمه و بااستفاده از روش‌های پرداخت ذخیره‌شده در «حساب Google» خودشان پرداخت کنند. این میانای برنامه‌سازی کاربردی امکان تسویه‌حساب ساده را برای میلیون‌ها کاربر با صدها میلیون کارت ذخیره‌شده فراهم می‌کند. این روش امنیت بیشتری ارائه می‌دهد، زیرا داده‌های پرداخت مشتری از سرورهای Google تا پردازشگر پرداخت شما به‌صورت سرتاسر رمزگذاری می‌شود. این فرایند ادغام آسان با پشته پردازش پرداخت‌های فعلی شما کار می‌کند و با چند خط کد قابل پیاده‌سازی است.
Google Pay API و Google Wallet API چه ارتباطی باهم دارند؟
‫Google Pay API و Google Wallet API دو میانای برنامه‌سازی کاربردی جداگانه هستند. ‫Google Pay API به مشتریان شما امکان می‌دهد از Google Pay به‌عنوان روش پرداخت در وب‌سایت یا برنامه Android شما استفاده کنند. ‫Google Wallet API به توسعه‌دهندگان امکان می‌دهد مجوزهای دیجیتال را برای موارد استفاده مختلف ایجاد و مدیریت کنند. برای مثال، کارت‌های وفاداری، بلیت‌ها، کارت‌های دسترسی، سوابق بهداشتی، و موارد قابل‌سفارشی‌سازی دیگر. برای کسب اطلاعات بیشتر درباره «میانای برنامه‌سازی کاربردی کیف پول Google»، لطفاً به سند توسعه‌دهنده میانای برنامه‌سازی کاربردی کیف پول Google مراجعه کنید.

نسخه فعلی Google Pay API چیست و به‌روزرسانی‌ها چگونه انجام می‌شود؟
نسخه فعلی در اسناد Android و وب فهرست شده است. Google این نسخه را برای چندین سال حفظ کرده است و فقط ویژگی‌های جدید و فیلدهای اختیاری را اضافه کرده است. هرگونه به‌روزرسانی در «میانای برنامه‌سازی کاربردی» با نسخه‌های قبلی سازگار است تا یکپارچه‌سازی‌های فعلی مختل نشوند.
کدام پلاتفرم‌ها از DPAN (CRYPTOGRAM_3DS) درمقابل FPAN (PAN_ONLY) پشتیبانی می‌کنند؟
DPAN مختص Android است و فقط هنگام تسویه‌حساب در دستگاه‌های Android یا وب تلفن همراه/WebView Android دردسترس است. وب رایانه و دستگاه‌های iOS از DPAN پشتیبانی نمی‌کنند و به‌طور پیش‌فرض به PAN_ONLY برمی‌گردند.
چگونه بین DPAN و FPAN تمایز قائل شویم و چگونه باید آن‌ها را مدیریت کرد؟
به‌جای شناسایی دقیق DPAN درمقابل FPAN، شیء assuranceDetails به‌گونه‌ای طراحی شده است که به فروشندگان کمک کند تا تعیین کنند آیا تراکنش باید ازطریق 3D Secure ارتقا یابد تا الزامات «اصالت‌سنجی قوی مشتری» (SCA) را برآورده کند یا نه. برای دریافت این جزئیات، فروشندگان باید assuranceDetailsRequired: true را به «پارامتر کارت» در درخواست «میانای برنامه‌سازی کاربردی Google Pay» خود اضافه کنند.
تفاوت بین cardHolderAuthenticated و accountVerified چیست؟
وقتی assuranceDetailsRequired در درخواست روی true تنظیم شده باشد، پاسخ شامل دو ویژگی خواهد بود:
  • accountVerified: نشان می‌دهد که کارت استفاده‌شده برای پرداخت معتبر است و حساب خوش‌حساب است. اما این درستی‌سنجی به‌تنهایی محافظت از مجوز را ارائه نمی‌دهد.
  • cardHolderAuthenticated: نشان می‌دهد که کاربر تراکنش را با دستگاه مجهز به Android خود شروع کرده است و از یک توکن شبکه مبتنی بر دستگاه آماده‌شده استفاده کرده است.
چگونه از این پرچم‌ها برای راه‌اندازی 3D Secure استفاده می‌کنیم؟
فروشندگان باید از این پرچم‌ها برای ساختن منطق راه‌اندازی 3D Secure استفاده کنند. اگر هر دو cardHolderAuthenticated و accountVerified به‌عنوان true برگردانده شوند، اعتبارنامه‌ها بسیار ایمن و مطابق با SCA درنظر گرفته می‌شوند و نیازی نیست تراکنش را برای اصالت‌سنجی بیشتر 3DS ارتقا دهید.
آیا فروشندگان درصورت تنظیم assuranceDetailsRequired: true، رمزهای تجارت الکترونیک دریافت خواهند کرد؟
نه، نشان‌های تجارت الکترونیک در سطح PSP کنترل می‌شوند.
آیا تراکنش‌های Google Pay واجدشرایط انتقال مسئولیت هستند؟
دردسترس بودن انتقال مسئولیت به شبکه کارت بستگی دارد. برای جزئیات بیشتر، فعال کردن «انتقال مسئولیت ویزا» را ببینید.
چگونه می‌توانیم تراکنش‌های «الآن خرید کنید، بعداً بپردازید» (BNPL) را شناسایی کنیم؟
درحال‌حاضر، شناسه خاصی برای تراکنش‌های «خرید اقساطی» وجود ندارد. این اطلاعات در سیستم شما به‌عنوان اطلاعات اعتباری FPAN معمولی نشان داده خواهد شد.
آیا Google می‌تواند کارت‌های آزمایشی برای آزمایش سناریوهای «احراز هویت مشتری قوی» ارائه دهد؟
«میانای برنامه‌سازی کاربردی Google Pay» نمی‌تواند کارت‌های آزمایشی «احراز هویت مشتری قوی» را مستقیماً ارائه دهد. «ارائه‌دهنده خدمات پرداخت» شما باید بتواند از مجموعه کارت‌های «آزمایشی» خود در محیط جعبه شنی برای نیازهای آزمایشی شما استفاده کند.
تاریخ انقضا یا «زمان زنده بودن» (TTL) برای اطلاعات اعتباری پرداخت رمزگذاری‌شده چیست؟
بارداده رمزگذاری‌شده Google Pay دقیقاً پس‌از یک هفته منقضی می‌شود. فروشندگانی که با تأییدیه‌های تأخیریافته یا پردازش ناهمزمان سروکار دارند باید مطمئن شوند که پرداخت در این بازه زمانی قبل‌از منقضی شدن داده‌بار با «ارائه‌دهنده خدمات پرداخت» (PSP) آن‌ها تأیید شده است.
عملیات پس‌از خرید، مانند استرداد وجه و صدور مجدد مجوز، چگونه انجام می‌شود؟
‫Google Pay در جریان پول دخالتی ندارد و صرفاً به‌عنوان گذرگاهی برای اعتبارنامه نشان‌گذاری‌شده عمل می‌کند. پس‌از انجام تراکنش اولیه، «ارائه‌دهنده خدمات پرداخت» (PSP) شما اطلاعات پرداخت را در بارداده رمزگذاری‌شده به کد اختصاصی خود (مانند «کد فروشنده» یا «شناسه نمایه مشتری») نگاشت می‌کند. همه تعاملات پس‌از خرید و نقل‌وانتقال پول کاملاً بین شما و «ارائه‌دهنده خدمات پرداخت» شما مدیریت می‌شود.
«قیمت‌گذاری پویا» چگونه با «تراکنش‌های آغازشده توسط فروشنده» کار می‌کند؟
درحال‌حاضر، «تراکنش‌های آغازشده توسط فروشنده» (MIT) از قیمت‌گذاری پویا پشتیبانی نمی‌کنند. این یک محدودیت شناخته‌شده است.
برای Google Pay در «وب‌نما» چه پیکربندی «خط‌مشی امنیتی محتوا» (CSP) لازم است؟

اگر از «خط‌مشی امنیتی محتوا» (CSP) استفاده می‌کنید، حتماً مقادیر صحیح را برای دستورالعمل connect-src تنظیم کنید تا Google Pay بتواند در WebView شما استفاده شود. برای مثال:

Content-Security-Policy: connect-src pay.google.com google.com account.google.com www.google.com
چگونه می‌توانم از یک عدد یک‌بارمصرف «خط‌مشی امنیتی محتوا» (CSP) با میانای برنامه‌سازی کاربردی وب Google Pay استفاده کنم؟

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

  1. مشخصه CSP nonce خود را در برچسب <script> که pay.js را بار می‌کند اضافه کنید:

    <script
  async
  src="https://pay.google.com/gp/p/js/pay.js"
  nonce="your-nonce-value"
  onload="onGooglePayLoaded()">
</script>

  2. هنگام نمونه‌سازی PaymentsClient، خصوصیت nonce را در PaymentOptions ارسال کنید:

    const paymentsClient = new google.payments.api.PaymentsClient({
  environment: 'TEST',
  nonce: 'your-nonce-value'
});

Google Pay این مشخصه nonce را برای همه عناصر <style> و <script> تزریق‌شده به‌صورت پویا، ازجمله سبک‌های دکمه ایجادشده توسط createButton()، اعمال می‌کند.

آیا Google Pay API درطول تسویه‌حساب از کوکی NID استفاده می‌کند یا به آن نیاز دارد؟

نه. کوکی NID برای جریان تسویه‌حساب «میانای برنامه‌سازی کاربردی Google Pay» استفاده نمی‌شود و از آن پشتیبانی نمی‌کند.

کوکی NID با سرویس سمت سرور Google مرتبط است که برای ذخیره داده‌های شخصی‌سازی‌شده برای کاربرانی که به سیستم حساب Google وارد نشده‌اند طراحی شده است.

عملکردهای ضروری سرویس (ازجمله امنیت، جلوگیری از کلاهبرداری، و قابلیت اطمینان سرویس) مستقل از کوکی NID عمل می‌کنند. «میانای برنامه‌سازی کاربردی Google Pay» طراحی شده است تا صرف‌نظر از وجود این کوکی، تجربه‌ای امن و قابل‌اعتماد برای فروشندگان و کاربران حفظ کند.

Google به حریم خصوصی متعهد است و اطمینان می‌دهد که این کوکی‌ها مطابق با خط‌مشی رازداری Google و خط‌مشی فناوری‌ها و کوکی‌ها مدیریت می‌شوند. ممکن است این منابع برای اسناد رعایت مقررات شما و ارائه شفافیت بیشتر به کاربرانتان مفید باشد.