راهنمای کاربر

مجموعه های خود را بهینه کنید محتوا را بر اساس ترجیحات خود ذخیره و دسته بندی کنید.

اگر برنامه اندروید شما از طریق Google Play توزیع شده است، می توانید آن را با Google Pay API ادغام کرده و آن را برای پشتیبانی از کارت های پرداخت تنظیم کنید. نحوه انجام این کار در زیر توضیح داده شده است.

مرحله 1: نسخه Google Pay API را مشخص کنید

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

یک شی درخواست پایه با ویژگی های موجود در تمام اشیاء درخواستی دیگر ایجاد کنید.

کاتلین

مرحله 2: درخواست یک رمز برای ارائه دهنده خدمات پرداخت

Google اطلاعات مربوط به کارت خریدار انتخابی را رمزگذاری می کند تا اطمینان حاصل کند که داده ها به طور ایمن توسط ارائه دهنده خدمات پرداخت پردازش می شوند.

کاتلین

مقادیر نمونه و نمونه GatewayMerchantId را با مقادیر مناسب برای ارائه دهنده خدمات پرداخت خود جایگزین کنید. جدول زیر مقادیر gateway و gatewayMerchantId را برای فروشندگان خاص نشان می دهد.

بدون مستندات توسعه دهنده

بدون سند برای توسعه دهندگان

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

بدون مستندات توسعه دهنده

نوع توکن سازی PAYMENT_GATEWAY رایج ترین روش برای پیاده سازی Google Pay API برای پرداخت های کارتی است. اگر ارائه دهنده پرداخت شما پشتیبانی نمی شود، ادغام DIRECT را امتحان کنید. اطلاعات بیشتر را می توان در مستندات یافت.

مرحله 3. سیستم های پرداخت پشتیبانی شده را تنظیم کنید

سیستم های پرداختی را انتخاب کنید که کارت آنها در درخواست شما پذیرفته شده است.

کاتلین

Google Pay API می تواند نتایج جستجوی کارت را در بایگانی های Google.com (PAN_ONLY) یا یک نشانه دستگاه در دستگاه Android تأیید شده با رمزنگاری امن سه بعدی (CRYPTOGRAM_3DS) نشان دهد.

کاتلین

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

• کلیه معاملات پرداخت Google باید همان رویه ها را برای بررسی و ارزیابی خطرات به عنوان سایر معاملات پرداخت شما انجام دهد. چک های انجام شده در Google Pay جایگزین روشهای مدیریت ریسک شما نمی شوند.
• اگر از PAN_ONLY استفاده می کنید ، هنگام انجام معاملات Google Pay PAN_ONLY به همان روشی که برای معاملات معمولی نقشه انجام می شود ، از طریق 3-D Secure به تأیید اعتبار نیاز دارید.

مرحله 4. روشهای پرداخت پشتیبانی شده را نشان دهید

می توانید نشان دهید که برنامه شما از طریق ترکیبی از روش های تأیید اعتبار و سیستم های پرداخت از روش پرداخت کارت پشتیبانی می کند.

کاتلین

موضوع روش پرداخت اساسی را با یک کارت گسترش دهید تا نشان دهد کدام اطلاعات (از جمله داده های پرداخت توکن) باید به برنامه برگردد.

کاتلین

اطلاعات تکمیلی در مورد پارامترهای پشتیبانی شده پارامترها را می توان در بخش کارت پارامترها در اطلاعات مربوط به امکانات JSON یافت.

علاوه بر کارت (کارت) ، Google Pay از روش پرداخت پی پال پشتیبانی می کند. اطلاعات بیشتر در مورد نحوه اضافه کردن حساب PayPal به Google Pay را بخوانید ، در اینجا نوشته شده است.

مرحله 5. یک نسخه از شیء Client PaymentsClient ایجاد کنید

در فعالیت روش OnCreate یک کپی پرداخت Client ایجاد کنید. کپی پرداخت Client برای تعامل با Google Pay API استفاده می شود.

کاتلین

مرحله 6. آمادگی پرداخت را با استفاده از Google Pay API تعیین کنید

روشهای پرداخت مجاز را به موضوع پایه درخواست با استفاده از قطعه بعدی کد اضافه کنید:

کاتلین

قبل از نمایش دکمه Google Pay ، برای تعیین اینکه آیا کاربر می تواند از طریق Google Pay API بپردازد ، با API isReadyTopay تماس بگیرید. لیست کاملی از خصوصیات پیکربندی را می توان در مستندات JSON با توجه به شیء ISRDRIDYYTOPAYREQUEST یافت.

کاتلین

همانطور که نمونه ای نشان داده شده است ، بهتر است فقط پس از بدست آوردن نتیجه مثبت از عملکرد ISReadTopay ، Google Pay را به عنوان یک روش پرداخت معرفی کنید. به عنوان یک قاعده ، هنگام استفاده از روش پرداخت ، دکمه Google Pay در طرح شامل نمایش داده می شود. اطلاعات بیشتر در مورد دکمه های پرداخت موجود ، آرم ها و علائم Google Pay را می توان در قوانین طراحی شرکت Google یافت.

مرحله 7. ایجاد یک شی پرداخت DaydatareQuest

شی JSON PaymentDatareQuest اطلاعاتی را که برای درخواست از خریدار در صفحه پرداخت Google Pay درخواست می کنید ، توصیف می کند.

داده های مربوط به قیمت معامله و وضعیت آن را نشان دهید. اطلاعات بیشتر در مستندات JSON برای هدف TransactionInfo ارائه شده است.

مثال زیر نحوه درخواست قیمت ، وضعیت و اطلاعات آن در مورد ارز معامله را نشان می دهد.

کاتلین

نام فروشنده را برای کاربران مشخص کنید. اطلاعات بیشتر در مستندات JSON برای شیء Merchantinfo ارائه شده است.

مثال زیر نحوه دریافت نام فروشنده را نشان می دهد.

کاتلین

هدف اصلی درخواست را به عنوان شیء جدید JSON PaymentDatareQuest انتخاب کنید. روشهای پرداختی را که توسط برنامه شما پشتیبانی می شود اضافه کنید که نشانگر تنظیمات داده های اضافی مورد انتظار در پاسخ است. داده های معامله و فروشنده ای را که درخواست ارسال کرده اند را مشخص کنید.

مثال زیر نحوه درخواست داده های پرداخت را نشان می دهد:

کاتلین

مرحله 8. پردازنده ژست کاربر را تنظیم کنید

برای درخواست برداشت صفحه پرداخت Google Pay هنگام فشار دادن دکمه پرداخت Google Pay ، پارامتر OnClickListener را تنظیم کنید.

کاتلین

شی پرداخت DaydatareQuest قابل استفاده است که درخواست داده های پرداخت است. اطلاعات مربوط به شی پرداخت DaydatareQuest برای پرداخت ضروری است. از کلاس AutorEsolveHelper برای انجام خودکار وظیفه تعیین شده استفاده کنید. سپس نتیجه را با استفاده از فعالیت کلاس OnactivityResult پردازش کنید.

مرحله 9. یک شیء پاسخ را پردازش کنید

بعد از اینکه خریدار تمام اطلاعات درخواست شده در صفحه پرداخت Google Pay را نشان می دهد ، شی پرداخت Daydata به OnactivityResult باز می گردد.

برای انتقال داده های پرداخت به پردازنده و تأیید تأیید خرید به کاربر ، پاسخ را به JSON تبدیل کنید. اگر پارامتر TransactionInfo. TotalPriceStatus ، منتقل شده به PaymentDatareQuest ، وضعیت تخمین را دارد ، لازم است قبل از نوشتن وجوه به عنوان بخشی از روش پرداخت برگشتی ، قیمت نهایی را نشان دهید.

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

کاتلین

اطلاعات اضافی در مورد محتوا و ساختار پاسخ را می توان در مستندات JSON برای شی پرداخت Daydata یافت.

نتیجه گیری

در زیر یک نمونه کامل از یک پروژه به درستی پیکربندی شده است. برای راهنمایی ، به بخش پیکربندی پروژه خود مراجعه کنید.

checkoutactivity. kt (کوتلین)

به عنوان بخشی از این مثال ، فعالیت فرض می شود که دکمه پرداخت Google Pay با ویژگی شناسه در GooglePay_Button در طرح است.

PaymentSutil. Kt (کوتلین)

در زیر نمونه ای از پرونده ای برای ایجاد تسهیلات JSON برای ساخت isredytopayrequest یا پرس و جوهای پرداخت شده است.

checkoutactivity. java (جاوا)

به عنوان بخشی از این مثال ، فعالیت فرض می شود که دکمه پرداخت Google Pay با ویژگی شناسه در GooglePay_Button در طرح است.

PaymentSutil. java (جاوا)

در زیر نمونه ای از پرونده ای برای ایجاد تسهیلات JSON برای ساخت isredytopayrequest یا پرس و جوهای پرداخت شده است.

به استثنای آنچه در غیر این صورت ذکر نشده است ، محتوای این صفحه تحت مجوز Creative Commons Attribution 4. 0 مجوز دارد و نمونه های کد مجوز انتشار Apache 2. 0 را دارند. برای جزئیات بیشتر ، به سیاست های سایت Google Developers مراجعه کنید. جاوا یک علامت تجاری ثبت شده اوراکل و/یا شرکت های وابسته به آن است.