توسعهدهندگان واجد شرایط میتوانند به کاربران در کشورهای خاص، یک سیستم صورتحساب جایگزین در برنامه خود ارائه دهند و تراکنشهای حاصل را به گوگل گزارش دهند. بسته به محل توزیع برنامه و واجد شرایط بودن، دو نسخه از صورتحساب جایگزین وجود دارد که یک برنامه میتواند ایجاد کند:
- پرداخت جایگزین با انتخاب کاربر : برنامه شما در کنار سیستم پرداخت گوگل پلی، پرداخت جایگزین ارائه میدهد.
- فقط پرداخت جایگزین (بدون انتخاب کاربر) : برنامه شما یک سیستم پرداخت جایگزین ارائه میدهد که گزینه پرداخت گوگل پلی را ندارد.
این راهنما به APIهایی میپردازد که باید برای هر یک از این پیشنهادها استفاده شوند. شما باید صفحات برنامه را بررسی کرده و قبل از استفاده از این APIها در برنامههای مربوطه ثبتنام کنید.
واژهنامه اصطلاحات
قراردادهای اصطلاحاتی که در این راهنما دنبال میشوند:
- APIهای صورتحساب جایگزین : APIهایی که برای نمایش هرگونه صفحه نمایش قابل اجرا به کاربران استفاده میشوند و به توسعهدهندگان امکان میدهند تراکنشهای انجامشده را در سیستم صورتحساب جایگزین توسعهدهنده گزارش دهند.
- سیستم پرداخت جایگزین : سیستم پرداخت جایگزین توسعهدهنده که ممکن است در کنار سیستم پرداخت گوگل پلی یا به تنهایی (با توجه به شرایط لازم) ارائه شود.
- تراکنش خارجی : تراکنشی که خارج از سیستم پرداخت گوگل پلی انجام میشود.
- توکن تراکنش خارجی : توکنی که از طریق کتابخانه پرداخت پلی در اختیار توسعهدهنده قرار میگیرد تا در صورت تکمیل سیستم پرداخت جایگزین توسط کاربر، از آن استفاده کند. این توکن برای اطلاعرسانی به گوگل پلی در مورد خرید موفق استفاده میشود.
- شناسه تراکنش خارجی : شناسهای منحصر به فرد که توسط توسعهدهنده برای شناسایی یک تراکنش ایجاد میشود.
ارائه صورتحساب جایگزین با انتخاب کاربر
این بخش نحوه ارائه صورتحساب جایگزین به کاربران شما با انتخاب استفاده از سیستم صورتحساب Google Play را شرح میدهد. قبل از استفاده از این APIها، موارد زیر را بررسی کنید:
- شرایط لازم برای برنامه(های) مربوطه را بررسی کنید و مراحل آشنایی که در بخش «آشنایی با پرداخت به انتخاب کاربر در گوگل پلی» ذکر شده است را تکمیل کنید.
- ادغام کتابخانه پرداخت Play نسخه ۵.۲ یا بالاتر.
بقیه ماژولهای پیشنهادی برای یکپارچهسازی با Google Play Billing همانهایی هستند که توسعهدهندگان برای یکپارچهسازی فعلی خود در نظر میگیرند.
علاوه بر این، توصیه میکنیم تنظیمات ادغام API توسعهدهندگان گوگل پلی را آماده داشته باشید زیرا ادغام در بکاند از آن بهره خواهد برد.
پیکربندی در کنسول Play
توسعهدهندگانی که ثبتنام برای برنامهی صورتحساب جایگزین مربوطه با انتخاب کاربر را تکمیل کردهاند و با APIهای صورتحساب جایگزین ادغام شدهاند، میتوانند تنظیمات صورتحساب جایگزین خود را از طریق Play Console مدیریت کنند:
- برای هر یک از برنامههای واجد شرایط خود، میتوانید انتخاب کنید که آیا سیستم پرداخت جایگزین ارائه دهید یا خیر.
- لوگوهای روشهای پرداخت را مطابق با دستورالعملها و با رعایت تمام مشخصات قالب، آپلود کنید. تصاویری که با این دستورالعملها مطابقت نداشته باشند، برای سیستم پرداخت جایگزین شما در صفحه انتخاب کاربر نمایش داده نخواهند شد. (توجه: درج لوگوهای روشهای پرداخت اختیاری است، هرچند اکیداً توصیه میشود.)
- اگر اشتراک ارائه میدهید، لینک مدیریت اشتراک مورد نیاز را ارائه دهید.
تجربه کاربری
APIهای سمت کلاینت، قابلیتهای زیر را فعال میکنند:
- گوگل پلی اطلاعات مربوطه و صفحات انتخاب کاربر را رندر و مدیریت میکند.
- اگر کاربر تصمیم به استفاده از سیستم پرداخت گوگل پلی بگیرد، جریان پرداخت با استفاده از رابط استاندارد پرداخت گوگل پلی ادامه مییابد.
 برنامه توسعهدهنده. |  صفحه انتخاب صورتحساب. |
مثال فقط برای اهداف توضیحی.
صفحه انتخاب کاربر
صفحه انتخاب کاربر، به کاربران این امکان را میدهد که از سیستم پرداخت جایگزین توسعهدهنده یا سیستم پرداخت گوگل پلی استفاده کنند.
آناتومی یک گزینه صورتحساب جایگزین
گزینه پرداخت جایگزین در صفحه انتخاب کاربر شامل عناصر رابط کاربری زیر است:
- آیکون برنامه.
- نام برنامه.
- دارایی تصویری که شامل روشهای پرداخت ارائه شده توسط توسعهدهنده است.
- نشانگر اضافی ( و عنصر رابط کاربری بیشتر بخشی از تصویر نیست).
تصویر برای روشهای پرداخت
دارایی تصویر واحد از کارتهای با روشهای پرداخت چندگانه تشکیل شده است و باید از مشخصات تعریفشده در این دستورالعملها پیروی کند.
ابعاد | ۱۹۲dp × ۲۰dp |
فاصله کارت | 8dp |
فرمت فایل | PNG، پس زمینه شفاف |
تغییرات روش پرداخت
توسعهدهندگان میتوانند تعداد آیکونهای روش پرداخت موجود را که مایل به گنجاندن آنها در تصویر هستند، حداکثر تا ۵ عدد، انتخاب کنند.
هیچ تصویر یا متن دیگری نباید در تصویر وجود داشته باشد.
مشخصات کارت
کارتهای روش پرداخت موجود در تصویر باید از دستورالعملهای زیر برای اندازه، فاصلهگذاری و سبک پیروی کنند.
| ابعاد کارت | ۳۲dp در ۲۰dp |
| بالشتک داخلی | سه بعدی |
| طرح کلی | ۱dp (استروک داخلی در ابعاد لحاظ شده است)، شعاع ۲dp، #E0E0E0 |
| پس زمینه کارت | رنگ ثابت (ترجیحاً سفید) |
مراحل بعدی
برای شروع ادغام APIهای صورتحساب جایگزین با انتخاب کاربر، راهنماهای جامع مربوط به ادغام درون برنامهای و ادغام بکاند را دنبال کنید.
فقط ارائه صورتحساب جایگزین
این بخش نحوه ارائه صورتحساب جایگزین به کاربران شما بدون انتخاب استفاده از سیستم صورتحساب Google Play را شرح میدهد. قبل از استفاده از این APIها، موارد زیر را بررسی کنید:
- الزامات را بررسی کنید و با دنبال کردن دستورالعملهای موجود در بخش «ارائه سیستم صورتحساب جایگزین برای کاربران منطقه اقتصادی اروپا (EEA) برای صورتحساب جایگزین»، در برنامه «فقط صورتحساب جایگزین» ثبتنام کنید.
- ادغام کتابخانه پرداخت Play نسخه ۶.۲.۱ یا بالاتر.
توصیه میکنیم تنظیمات ادغام API توسعهدهندگان گوگل پلی را آماده داشته باشید، زیرا ادغام در بکاند از آن بهره خواهد برد.
پیکربندی در کنسول Play
توسعهدهندگانی که ثبتنام را تکمیل کردهاند و با APIهای صورتحساب جایگزین ادغام شدهاند، میتوانند تنظیمات صورتحساب جایگزین خود را از طریق Play Console مدیریت کنند:
- برای هر یک از برنامههای واجد شرایط خود، در هر کشور موجود، از ارائه فقط صورتحساب جایگزین (بدون انتخاب کاربر) خودداری کنید یا آن را لغو کنید.
صفحه نمایش اطلاعات برای کاربران
صفحه اطلاعات به کاربران کمک میکند تا متوجه شوند که فقط یک سیستم پرداخت جایگزین در برنامه واجد شرایط ارائه میشود. صفحه اطلاعات در ابتدای اولین خرید کاربران در برنامه شما پس از فعال شدن پرداخت جایگزین به آنها نشان داده میشود. این پیام در خریدهای بعدی که توسط همان کاربر در برنامه شما و در همان دستگاه انجام میشود، نمایش داده نخواهد شد. توجه داشته باشید که ممکن است مواقعی وجود داشته باشد که این پنجره در موقعیتهایی مانند پاک کردن حافظه پنهان دستگاه کاربر، دوباره به کاربر نشان داده شود.
مراحل بعدی
برای شروع ادغام APIهای صورتحساب جایگزین، راهنماهای جامع مربوط به ادغام درون برنامهای و ادغام در بکاند را دنبال کنید.