برنامه انتخاب صورتحساب به شما امکان میدهد سیستم صورتحساب خود را ادغام کنید یا کاربران را برای خرید با استفاده از لینکهای وب خارجی به وبسایت خود هدایت کنید. صرف نظر از اینکه کدام گزینه را پیادهسازی میکنید، کاربران باید بین صورتحساب Google Play و صورتحساب جایگزین درون برنامه یا لینکهای وب خارجی یکی را انتخاب کنند. قبل از استفاده از این APIها، باید الزامات برنامه را بررسی کرده و در برنامه پیشنهادات خارجی ثبتنام کنید.
تجربه کاربری
وقتی کاربری خریدی را آغاز میکند، صفحهای برای انتخاب به او نمایش داده میشود که هم سیستم پرداخت جایگزین شما (در برنامه یا لینکهای وب خارجی) و هم پرداخت گوگل پلی را نشان میدهد. شما میتوانید این جریان را بسته به اینکه چه کسی صفحه انتخاب را نمایش میدهد و پرداخت در کجا انجام میشود، سفارشی کنید. قبل از پیادهسازی API در برنامهتان، لازم است تنظیمات صفحه انتخاب و تنظیمات لینکهای وب خارجی خود را در کنسول پلی بهروزرسانی کنید.


۱. چه کسی صفحه انتخاب را رندر میکند؟
- رندر شده توسط گوگل : گوگل پلی رابط کاربری صفحه انتخاب را به طور خودکار و به عنوان بخشی از جریان پرداخت برای شما مدیریت میکند.
- خودتان : شما یک صفحه انتخاب سفارشی را در برنامه خود طراحی و رندر میکنید. اگر این مسیر را انتخاب کنید، ملزم به رعایت دستورالعملهای UX هستید.
۲. محل انجام پرداخت
- درون برنامهای : کاربر تراکنش را درون رابط برنامه شما انجام میدهد.
- لینک وب خارجی : کاربر برای تکمیل تراکنش به وبسایت شما هدایت میشود.
کنترلهای والدین
کاربران تحت نظارت مجاز به انتخاب صورتحساب هستند، اما کنترلهای اجباری والدین و صفحات اطلاعات یکبار مصرف باید نمایش داده شوند.
- برای صفحات انتخاب رندر شده توسط گوگل : گوگل قبل از نمایش صفحه انتخاب، به طور خودکار صفحه کنترل والدین را مدیریت میکند.
- برای صفحات انتخاب ارائه شده توسط توسعهدهنده : شما مسئول فراخوانی APIهای خاص کتابخانه پرداخت Play برای فعال کردن کنترلهای والدین هستید. برای خریدهای درونبرنامهای، این کار از طریق یک پنجره اطلاعات اجباری قبل از نمایش صفحه انتخاب سفارشی شما انجام میشود. برای لینکهای خارجی، کنترلهای والدین درست قبل از اینکه کاربر از برنامه خارج شود، مدیریت میشوند.
دستورالعملهای دارایی تصویر روش پرداخت
میتوانید تصاویر مربوط به روشهای پرداخت پشتیبانیشدهتان را در کنسول Play آپلود کنید تا در صفحه انتخاب صورتحساب نمایش داده شوند.
تصویر برای روشهای پرداخت
دارایی تصویر واحد از کارتهای با روشهای پرداخت چندگانه تشکیل شده است و باید از مشخصات تعریفشده در این دستورالعملها پیروی کند.

ابعاد | ۱۹۲dp × ۲۰dp |
فاصله کارت | 8dp |
فرمت فایل | PNG، پس زمینه شفاف |
تغییرات روش پرداخت
توسعهدهندگان میتوانند تعداد آیکونهای روش پرداخت موجود را که میخواهند در تصویر بگنجانند، حداکثر تا ۵، انتخاب کنند.
هیچ تصویر یا متن دیگری نباید در تصویر وجود داشته باشد.


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

| ابعاد کارت | ۳۲dp در ۲۰dp |
| بالشتک داخلی | سه بعدی |
| طرح کلی | ۱dp (استروک داخلی در ابعاد لحاظ شده است)، شعاع ۲dp، #E0E0E0 |
| پس زمینه کارت | رنگ ثابت (ترجیحاً سفید) |
پیشنیازها
برای استفاده از برنامه انتخاب صورتحساب، باید شرایط زیر را داشته باشید:
- ثبتنام - شما باید در برنامهی انتخاب صورتحساب ثبتنام کنید. اگر تصمیم به ارائه لینکهای وب خارجی دارید، باید قبل از پیادهسازی آن در برنامهتان، تنظیمات برگزیده خود را در Play Console بهروزرسانی کنید.
- نسخه PBL - شما باید از کتابخانه پرداخت Play نسخه ۹.۱ یا بالاتر استفاده کنید.
گزارشدهی
تمام تراکنشهای صورتحساب جایگزین (از جمله تراکنشهای لینکهای خارجی) باید به صورت ایمن به گوگل پلی گزارش شوند. برای دستیابی به این هدف، یک توکن تراکنش خارجی مورد نیاز است. بسته به سناریوی انتخاب صورتحساب ، این توکن از طریق APIهای مختلف تولید میشود. این توکن تراکنش نشان میدهد که آیا DeveloperBillingType به عنوان یک لینک خارجی یا درون برنامهای طبقهبندی میشود. این توکن برای اعتبارسنجی تراکنشها و مرتبط کردن آنها با هزینه خدمات مناسب ضروری است.