توسعه دهندگان واجد شرایط می توانند به کاربران در برخی کشورها یک سیستم صورتحساب جایگزین در برنامه خود ارائه دهند و تراکنش های حاصل را به Google گزارش دهند. بسته به جایی که برنامه خود را توزیع می کنید و واجد شرایط بودن، دو نسخه از صورتحساب جایگزین وجود دارد که یک برنامه می تواند بسازد:
- صورتحساب جایگزین با انتخاب کاربر : برنامه شما یک صورتحساب جایگزین را در کنار سیستم صورتحساب Google Play ارائه می‌کند.
- فقط صورتحساب جایگزین (بدون انتخاب کاربر) : برنامه شما یک سیستم صورتحساب جایگزین را بدون حضور Google Play Billing به عنوان یک گزینه ارائه می‌کند.
این راهنما به APIهایی می‌پردازد که باید برای هر یک از این پیشنهادات استفاده شوند. قبل از استفاده از این APIها باید صفحات برنامه را بررسی کرده و در برنامه های مربوطه ثبت نام کنید.
واژه نامه اصطلاحات
قراردادهای اصطلاحی که توسط این راهنما دنبال می شوند:
- APIهای صورتحساب جایگزین : APIهایی که برای نمایش هر صفحه‌ای قابل اجرا به کاربران استفاده می‌شوند و توسعه‌دهندگان را قادر می‌سازند تا تراکنش‌های انجام‌شده در سیستم صورتحساب جایگزین توسعه‌دهنده را گزارش کنند.
- سیستم صورتحساب جایگزین : سیستم صورتحساب جایگزین توسعه‌دهنده که ممکن است در کنار سیستم صورتحساب Google Play یا به تنهایی (با توجه به شرایط واجد شرایط بودن) ارائه شود.
- تراکنش خارجی : تراکنشی که خارج از سیستم صورتحساب Google Play انجام می‌شود.
- نشانه تراکنش خارجی : رمزی که از طریق کتابخانه صورتحساب Play در اختیار برنامه‌نویس قرار می‌گیرد تا زمانی که کاربر یک سیستم صورتحساب جایگزین را تکمیل می‌کند، برنامه‌نویس از آن استفاده کند. این نشانه برای اطلاع رسانی به Google Play از خرید موفق استفاده می شود.
- شناسه تراکنش خارجی : یک شناسه منحصر به فرد که توسط توسعه دهنده برای شناسایی تراکنش ایجاد می شود.
ارائه صورتحساب جایگزین با انتخاب کاربر
این بخش نحوه ارائه صورتحساب جایگزین به کاربران خود را با انتخاب استفاده از سیستم صورتحساب Google Play شرح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- شرایط واجد شرایط بودن برنامه(های) مربوطه را مرور کنید و مراحل ورود به سیستم را که در درک صورتحساب انتخاب کاربر در Google Play بیان شده است، تکمیل کنید.
- Play Billing Library نسخه 5.2 یا بالاتر را ادغام کنید.
بقیه ماژول‌های پیشنهادی یکپارچه‌سازی صورتحساب Google Play همان چیزی است که توسعه‌دهندگان قبلاً برای یکپارچه‌سازی فعلی خود دارند.
علاوه بر این، توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن آن را تقویت می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام برای صورتحساب جایگزین مربوطه با برنامه انتخابی کاربر را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین ادغام شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق Play Console مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، می‌توانید انتخاب کنید که آیا یک سیستم صورتحساب جایگزین ارائه دهید یا خیر.
- آرم های روش پرداخت را مطابق با دستورالعمل ها ، با رعایت تمام مشخصات قالب بارگذاری کنید. تصاویری که با این دستورالعمل ها مطابقت ندارند برای سیستم صورتحساب جایگزین شما در صفحه انتخاب کاربر نمایش داده نمی شوند. (توجه: گنجاندن آرم های روش پرداخت اختیاری است، اگرچه به شدت توصیه می شود.)
- اگر اشتراک ارائه می دهید، پیوند مدیریت اشتراک مورد نیاز را ارائه دهید.
تجربه کاربری
API های سمت سرویس گیرنده عملکرد زیر را فعال می کنند:
- Google Play اطلاعات مربوطه و صفحه‌های انتخاب کاربر را ارائه و مدیریت می‌کند
- اگر کاربر استفاده از سیستم صورتحساب Google Play را انتخاب کند، جریان صورتحساب با استفاده از رابط استاندارد صورتحساب Google Play ادامه می‌یابد.
 برنامه توسعه دهنده |  صفحه انتخاب صورتحساب |
مثال فقط برای اهداف توضیحی.
صفحه نمایش انتخاب کاربر
صفحه انتخاب کاربر به کاربران این امکان را می دهد که از سیستم صورتحساب جایگزین توسعه دهنده یا سیستم صورتحساب Google Play استفاده کنند.
آناتومی یک گزینه صورتحساب جایگزین
گزینه صورتحساب جایگزین در صفحه انتخاب کاربر شامل عناصر UI زیر است:
- نماد برنامه
- نام برنامه
- دارایی تصویر که شامل روش‌های پرداخت ارائه‌شده توسط توسعه‌دهنده است.
- نشانگر اضافی ( و عنصر UI بیشتر بخشی از دارایی تصویر نیست).
دارایی تصویر برای روش های پرداخت
دارایی تصویر واحد از چندین کارت روش پرداخت تشکیل شده است و باید از مشخصات تعریف شده در این دستورالعمل ها پیروی کند.
ابعاد | 192dp X 20dp |
فاصله کارت | 8dp |
فرمت فایل | PNG، پس زمینه شفاف |
تغییرات روش پرداخت
برنامه‌نویسان می‌توانند تعداد نمادهای روش پرداخت موجود را که می‌خواهند در دارایی تصویر قرار دهند، حداکثر تا 5 انتخاب کنند.
هیچ تصویر یا متن دیگری نباید در تصویر گنجانده شود.
مشخصات کارت
کارت‌های روش پرداخت موجود در دارایی تصویر باید از دستورالعمل‌های زیر برای اندازه، فاصله و سبک پیروی کنند.
| ابعاد کارت | 32dp X 20dp |
| بالشتک داخلی | 3dp |
| طرح کلی | 1dp (کورس داخلی در ابعاد گنجانده شده است)، شعاع 2dp، #E0E0E0 |
| پس زمینه کارت | رنگ ثابت (ترجیحا سفید) |
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین با انتخاب کاربر، راهنماهای عمیق را برای ادغام درون برنامه و ادغام باطن دنبال کنید.
ارائه فقط صورتحساب جایگزین
این بخش نحوه ارائه صورتحساب جایگزین را به کاربران خود بدون استفاده از سیستم صورتحساب Google Play توضیح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- با دنبال کردن دستورالعمل‌های ارائه یک سیستم صورتحساب جایگزین برای کاربران در منطقه اقتصادی اروپا (EEA) برای صورتحساب جایگزین، شرایط را مرور کنید و در برنامه فقط صورتحساب جایگزین ثبت‌نام کنید.
- Play Billing Library نسخه 6.2.1 یا بالاتر را ادغام کنید.
توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن از آن استفاده می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام خود را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین یکپارچه شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق کنسول Play مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، در هر کشور موجود، فقط یک صورتحساب جایگزین (بدون انتخاب کاربر) ارائه دهید.
صفحه نمایش اطلاعات برای کاربران
صفحه اطلاعات به کاربران کمک می کند بفهمند که فقط یک سیستم صورتحساب جایگزین در برنامه واجد شرایط ارائه می شود. پس از فعال شدن صورتحساب جایگزین، صفحه اطلاعات در شروع اولین خرید در برنامه شما به کاربران نشان داده می شود. این پیام در خریدهای بعدی که توسط همان کاربر در برنامه شما در همان دستگاه انجام می شود، نمایش داده نمی شود. توجه داشته باشید که ممکن است در مواقعی مانند زمانی که کاربر حافظه پنهان دستگاه خود را پاک می کند، دیالوگ دوباره به کاربر نشان داده شود.
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین، از راهنماهای عمیق برای ادغام درون برنامه و ادغام باطن پیروی کنید.
،توسعه دهندگان واجد شرایط می توانند به کاربران در برخی کشورها یک سیستم صورتحساب جایگزین در برنامه خود ارائه دهند و تراکنش های حاصل را به Google گزارش دهند. بسته به جایی که برنامه خود را توزیع می کنید و واجد شرایط بودن، دو نسخه از صورتحساب جایگزین وجود دارد که یک برنامه می تواند بسازد:
- صورتحساب جایگزین با انتخاب کاربر : برنامه شما یک صورتحساب جایگزین را در کنار سیستم صورتحساب Google Play ارائه می‌کند.
- فقط صورتحساب جایگزین (بدون انتخاب کاربر) : برنامه شما یک سیستم صورتحساب جایگزین را بدون حضور Google Play Billing به عنوان یک گزینه ارائه می‌کند.
این راهنما به APIهایی می‌پردازد که باید برای هر یک از این پیشنهادات استفاده شوند. قبل از استفاده از این APIها باید صفحات برنامه را بررسی کرده و در برنامه های مربوطه ثبت نام کنید.
واژه نامه اصطلاحات
قراردادهای اصطلاحی که این راهنما دنبال می شود:
- APIهای صورتحساب جایگزین : APIهایی که برای نمایش هر صفحه‌ای قابل اجرا به کاربران استفاده می‌شوند و توسعه‌دهندگان را قادر می‌سازند تا تراکنش‌های انجام‌شده در سیستم صورتحساب جایگزین توسعه‌دهنده را گزارش کنند.
- سیستم صورتحساب جایگزین : سیستم صورتحساب جایگزین توسعه‌دهنده که ممکن است در کنار سیستم صورتحساب Google Play یا به تنهایی (با توجه به شرایط واجد شرایط بودن) ارائه شود.
- تراکنش خارجی : تراکنشی که خارج از سیستم صورتحساب Google Play انجام می‌شود.
- نشانه تراکنش خارجی : رمزی که از طریق کتابخانه صورتحساب Play در اختیار برنامه‌نویس قرار می‌گیرد تا زمانی که کاربر یک سیستم صورتحساب جایگزین را تکمیل می‌کند، برنامه‌نویس از آن استفاده کند. این نشانه برای اطلاع رسانی به Google Play از خرید موفق استفاده می شود.
- شناسه تراکنش خارجی : یک شناسه منحصر به فرد که توسط توسعه دهنده برای شناسایی تراکنش ایجاد می شود.
ارائه صورتحساب جایگزین با انتخاب کاربر
این بخش نحوه ارائه صورتحساب جایگزین به کاربران خود را با انتخاب استفاده از سیستم صورتحساب Google Play شرح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- شرایط واجد شرایط بودن برنامه(های) مربوطه را مرور کنید و مراحل ورود به سیستم را که در درک صورتحساب انتخاب کاربر در Google Play بیان شده است، تکمیل کنید.
- Play Billing Library نسخه 5.2 یا بالاتر را ادغام کنید.
بقیه ماژول‌های پیشنهادی یکپارچه‌سازی صورتحساب Google Play همان چیزی است که توسعه‌دهندگان قبلاً برای یکپارچه‌سازی فعلی خود دارند.
علاوه بر این، توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن آن را تقویت می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام برای صورتحساب جایگزین مربوطه با برنامه انتخابی کاربر را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین ادغام شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق Play Console مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، می‌توانید انتخاب کنید که آیا یک سیستم صورتحساب جایگزین ارائه دهید یا خیر.
- آرم های روش پرداخت را مطابق با دستورالعمل ها ، با رعایت تمام مشخصات قالب بارگذاری کنید. تصاویری که با این دستورالعمل ها مطابقت ندارند برای سیستم صورتحساب جایگزین شما در صفحه انتخاب کاربر نمایش داده نمی شوند. (توجه: گنجاندن آرم های روش پرداخت اختیاری است، اگرچه به شدت توصیه می شود.)
- اگر اشتراک ارائه می دهید، پیوند مدیریت اشتراک مورد نیاز را ارائه دهید.
تجربه کاربری
API های سمت سرویس گیرنده عملکرد زیر را فعال می کنند:
- Google Play اطلاعات مربوطه و صفحه‌های انتخاب کاربر را ارائه و مدیریت می‌کند
- اگر کاربر استفاده از سیستم صورتحساب Google Play را انتخاب کند، جریان صورتحساب با استفاده از رابط استاندارد صورتحساب Google Play ادامه می‌یابد.
برنامه توسعه دهنده | صفحه انتخاب صورتحساب |
مثال فقط برای اهداف توضیحی.
صفحه نمایش انتخاب کاربر
صفحه انتخاب کاربر به کاربران این امکان را می دهد که از سیستم صورتحساب جایگزین توسعه دهنده یا سیستم صورتحساب Google Play استفاده کنند.
آناتومی یک گزینه صورتحساب جایگزین
گزینه صورتحساب جایگزین در صفحه انتخاب کاربر شامل عناصر UI زیر است:
- نماد برنامه
- نام برنامه
- دارایی تصویر که شامل روش‌های پرداخت ارائه‌شده توسط توسعه‌دهنده است.
- نشانگر اضافی ( و عنصر UI بیشتر بخشی از دارایی تصویر نیست).
دارایی تصویر برای روش‌های پرداخت
دارایی تصویر واحد از چندین کارت روش پرداخت تشکیل شده است و باید از مشخصات تعریف شده در این دستورالعمل ها پیروی کند.
ابعاد | 192dp X 20dp |
فاصله کارت | 8dp |
فرمت فایل | PNG، پس زمینه شفاف |
تغییرات روش پرداخت
برنامه‌نویسان می‌توانند تعداد نمادهای روش پرداخت موجود را که می‌خواهند در دارایی تصویر قرار دهند، حداکثر تا 5 انتخاب کنند.
هیچ تصویر یا متن دیگری نباید در تصویر گنجانده شود.
مشخصات کارت
کارت‌های روش پرداخت موجود در دارایی تصویر باید از دستورالعمل‌های زیر برای اندازه، فاصله و سبک پیروی کنند.
| ابعاد کارت | 32dp X 20dp |
| بالشتک داخلی | 3dp |
| طرح کلی | 1dp (کورس داخلی در ابعاد گنجانده شده است)، شعاع 2dp، #E0E0E0 |
| پس زمینه کارت | رنگ ثابت (ترجیحا سفید) |
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین با انتخاب کاربر، راهنماهای عمیق را برای ادغام درون برنامه و ادغام باطن دنبال کنید.
ارائه فقط صورتحساب جایگزین
این بخش نحوه ارائه صورتحساب جایگزین را به کاربران خود بدون استفاده از سیستم صورتحساب Google Play توضیح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- با دنبال کردن دستورالعمل‌های ارائه یک سیستم صورتحساب جایگزین برای کاربران در منطقه اقتصادی اروپا (EEA) برای صورتحساب جایگزین، شرایط را مرور کنید و در برنامه فقط صورتحساب جایگزین ثبت‌نام کنید.
- Play Billing Library نسخه 6.2.1 یا بالاتر را ادغام کنید.
توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن از آن استفاده می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام خود را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین یکپارچه شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق کنسول Play مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، در هر کشور موجود، فقط یک صورتحساب جایگزین (بدون انتخاب کاربر) ارائه دهید.
صفحه نمایش اطلاعات برای کاربران
صفحه اطلاعات به کاربران کمک می کند بفهمند که فقط یک سیستم صورتحساب جایگزین در برنامه واجد شرایط ارائه می شود. پس از فعال شدن صورتحساب جایگزین، صفحه اطلاعات در شروع اولین خرید در برنامه شما به کاربران نشان داده می شود. این پیام در خریدهای بعدی که توسط همان کاربر در برنامه شما در همان دستگاه انجام می شود، نمایش داده نمی شود. توجه داشته باشید که ممکن است در مواقعی مانند زمانی که کاربر حافظه پنهان دستگاه خود را پاک می کند، دیالوگ دوباره به کاربر نشان داده شود.
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین، از راهنماهای عمیق برای ادغام درون برنامه و ادغام باطن پیروی کنید.
،توسعه دهندگان واجد شرایط می توانند به کاربران در برخی کشورها یک سیستم صورتحساب جایگزین در برنامه خود ارائه دهند و تراکنش های حاصل را به Google گزارش دهند. بسته به جایی که برنامه خود را توزیع می کنید و واجد شرایط بودن، دو نسخه از صورتحساب جایگزین وجود دارد که یک برنامه می تواند بسازد:
- صورتحساب جایگزین با انتخاب کاربر : برنامه شما یک صورتحساب جایگزین را در کنار سیستم صورتحساب Google Play ارائه می‌کند.
- فقط صورتحساب جایگزین (بدون انتخاب کاربر) : برنامه شما یک سیستم صورتحساب جایگزین را بدون حضور Google Play Billing به عنوان یک گزینه ارائه می‌کند.
این راهنما به APIهایی می‌پردازد که باید برای هر یک از این پیشنهادات استفاده شوند. قبل از استفاده از این APIها باید صفحات برنامه را بررسی کرده و در برنامه های مربوطه ثبت نام کنید.
واژه نامه اصطلاحات
قراردادهای اصطلاحی که این راهنما دنبال می شود:
- APIهای صورتحساب جایگزین : APIهایی که برای نمایش هر صفحه‌ای قابل اجرا به کاربران استفاده می‌شوند و توسعه‌دهندگان را قادر می‌سازند تا تراکنش‌های انجام‌شده در سیستم صورتحساب جایگزین توسعه‌دهنده را گزارش کنند.
- سیستم صورتحساب جایگزین : سیستم صورتحساب جایگزین توسعه‌دهنده که ممکن است در کنار سیستم صورتحساب Google Play یا به تنهایی (با توجه به شرایط واجد شرایط بودن) ارائه شود.
- تراکنش خارجی : تراکنشی که خارج از سیستم صورتحساب Google Play انجام می‌شود.
- نشانه تراکنش خارجی : رمزی که از طریق کتابخانه صورتحساب Play در اختیار برنامه‌نویس قرار می‌گیرد تا زمانی که کاربر یک سیستم صورتحساب جایگزین را تکمیل می‌کند، برنامه‌نویس از آن استفاده کند. این نشانه برای اطلاع رسانی به Google Play از خرید موفق استفاده می شود.
- شناسه تراکنش خارجی : یک شناسه منحصر به فرد که توسط توسعه دهنده برای شناسایی تراکنش ایجاد می شود.
ارائه صورتحساب جایگزین با انتخاب کاربر
این بخش نحوه ارائه صورتحساب جایگزین به کاربران خود را با انتخاب استفاده از سیستم صورتحساب Google Play شرح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- شرایط واجد شرایط بودن برنامه(های) مربوطه را مرور کنید و مراحل ورود به سیستم را که در درک صورتحساب انتخاب کاربر در Google Play بیان شده است، تکمیل کنید.
- Play Billing Library نسخه 5.2 یا بالاتر را ادغام کنید.
بقیه ماژول‌های پیشنهادی یکپارچه‌سازی صورتحساب Google Play همان چیزی است که توسعه‌دهندگان قبلاً برای یکپارچه‌سازی فعلی خود دارند.
علاوه بر این، توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن آن را تقویت می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام برای صورتحساب جایگزین مربوطه با برنامه انتخابی کاربر را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین ادغام شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق Play Console مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، می‌توانید انتخاب کنید که آیا یک سیستم صورتحساب جایگزین ارائه دهید یا خیر.
- آرم های روش پرداخت را مطابق با دستورالعمل ها ، با رعایت تمام مشخصات قالب بارگذاری کنید. تصاویری که با این دستورالعمل ها مطابقت ندارند برای سیستم صورتحساب جایگزین شما در صفحه انتخاب کاربر نمایش داده نمی شوند. (توجه: گنجاندن آرم های روش پرداخت اختیاری است، اگرچه به شدت توصیه می شود.)
- اگر اشتراک ارائه می دهید، پیوند مدیریت اشتراک مورد نیاز را ارائه دهید.
تجربه کاربری
API های سمت سرویس گیرنده عملکرد زیر را فعال می کنند:
- Google Play اطلاعات مربوطه و صفحه‌های انتخاب کاربر را ارائه و مدیریت می‌کند
- اگر کاربر استفاده از سیستم صورتحساب Google Play را انتخاب کند، جریان صورتحساب با استفاده از رابط استاندارد صورتحساب Google Play ادامه می‌یابد.
برنامه توسعه دهنده | صفحه انتخاب صورتحساب |
مثال فقط برای اهداف توضیحی.
صفحه نمایش انتخاب کاربر
صفحه انتخاب کاربر به کاربران این امکان را می دهد که از سیستم صورتحساب جایگزین توسعه دهنده یا سیستم صورتحساب Google Play استفاده کنند.
آناتومی یک گزینه صورتحساب جایگزین
گزینه صورتحساب جایگزین در صفحه انتخاب کاربر شامل عناصر UI زیر است:
- نماد برنامه
- نام برنامه
- دارایی تصویر که شامل روش‌های پرداخت ارائه‌شده توسط توسعه‌دهنده است.
- نشانگر اضافی ( و عنصر UI بیشتر بخشی از دارایی تصویر نیست).
دارایی تصویر برای روش‌های پرداخت
دارایی تصویر واحد از چندین کارت روش پرداخت تشکیل شده است و باید از مشخصات تعریف شده در این دستورالعمل ها پیروی کند.
ابعاد | 192dp X 20dp |
فاصله کارت | 8dp |
فرمت فایل | PNG، پس زمینه شفاف |
تغییرات روش پرداخت
برنامه‌نویسان می‌توانند تعداد نمادهای روش پرداخت موجود را که می‌خواهند در دارایی تصویر قرار دهند، حداکثر تا 5 انتخاب کنند.
هیچ تصویر یا متن دیگری نباید در تصویر گنجانده شود.
مشخصات کارت
کارت‌های روش پرداخت موجود در دارایی تصویر باید از دستورالعمل‌های زیر برای اندازه، فاصله و سبک پیروی کنند.
| ابعاد کارت | 32dp X 20dp |
| بالشتک داخلی | 3dp |
| طرح کلی | 1dp (کورس داخلی در ابعاد گنجانده شده است)، شعاع 2dp، #E0E0E0 |
| پس زمینه کارت | رنگ ثابت (ترجیحا سفید) |
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین با انتخاب کاربر، راهنماهای عمیق را برای ادغام درون برنامه و ادغام باطن دنبال کنید.
ارائه فقط صورتحساب جایگزین
این بخش نحوه ارائه صورتحساب جایگزین را به کاربران خود بدون استفاده از سیستم صورتحساب Google Play توضیح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- با دنبال کردن دستورالعمل‌های ارائه یک سیستم صورتحساب جایگزین برای کاربران در منطقه اقتصادی اروپا (EEA) برای صورتحساب جایگزین، شرایط را مرور کنید و در برنامه فقط صورتحساب جایگزین ثبت‌نام کنید.
- Play Billing Library نسخه 6.2.1 یا بالاتر را ادغام کنید.
توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن از آن استفاده می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام خود را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین یکپارچه شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق کنسول Play مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، در هر کشور موجود، فقط یک صورتحساب جایگزین (بدون انتخاب کاربر) ارائه دهید.
صفحه نمایش اطلاعات برای کاربران
صفحه اطلاعات به کاربران کمک می کند بفهمند که فقط یک سیستم صورتحساب جایگزین در برنامه واجد شرایط ارائه می شود. پس از فعال شدن صورتحساب جایگزین، صفحه اطلاعات در شروع اولین خرید در برنامه شما به کاربران نشان داده می شود. این پیام در خریدهای بعدی که توسط همان کاربر در برنامه شما در همان دستگاه انجام می شود، نمایش داده نمی شود. توجه داشته باشید که ممکن است در مواقعی مانند زمانی که کاربر حافظه پنهان دستگاه خود را پاک می کند، دیالوگ دوباره به کاربر نشان داده شود.
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین، از راهنماهای عمیق برای ادغام درون برنامه و ادغام باطن پیروی کنید.
،توسعه دهندگان واجد شرایط می توانند به کاربران در برخی کشورها یک سیستم صورتحساب جایگزین در برنامه خود ارائه دهند و تراکنش های حاصل را به Google گزارش دهند. بسته به جایی که برنامه خود را توزیع می کنید و واجد شرایط بودن، دو نسخه از صورتحساب جایگزین وجود دارد که یک برنامه می تواند بسازد:
- صورتحساب جایگزین با انتخاب کاربر : برنامه شما یک صورتحساب جایگزین را در کنار سیستم صورتحساب Google Play ارائه می‌کند.
- فقط صورتحساب جایگزین (بدون انتخاب کاربر) : برنامه شما یک سیستم صورتحساب جایگزین را بدون حضور Google Play Billing به عنوان یک گزینه ارائه می‌کند.
این راهنما به APIهایی می‌پردازد که باید برای هر یک از این پیشنهادات استفاده شوند. قبل از استفاده از این APIها باید صفحات برنامه را بررسی کرده و در برنامه های مربوطه ثبت نام کنید.
واژه نامه اصطلاحات
قراردادهای اصطلاحی که این راهنما دنبال می شود:
- APIهای صورتحساب جایگزین : APIهایی که برای نمایش هر صفحه‌ای قابل اجرا به کاربران استفاده می‌شوند و توسعه‌دهندگان را قادر می‌سازند تا تراکنش‌های انجام‌شده در سیستم صورتحساب جایگزین توسعه‌دهنده را گزارش کنند.
- سیستم صورتحساب جایگزین : سیستم صورتحساب جایگزین توسعه‌دهنده که ممکن است در کنار سیستم صورتحساب Google Play یا به تنهایی (با توجه به شرایط واجد شرایط بودن) ارائه شود.
- تراکنش خارجی : تراکنشی که خارج از سیستم صورتحساب Google Play انجام می‌شود.
- نشانه تراکنش خارجی : رمزی که از طریق کتابخانه صورتحساب Play در اختیار برنامه‌نویس قرار می‌گیرد تا زمانی که کاربر یک سیستم صورتحساب جایگزین را تکمیل می‌کند، برنامه‌نویس از آن استفاده کند. این نشانه برای اطلاع رسانی به Google Play از خرید موفق استفاده می شود.
- شناسه تراکنش خارجی : یک شناسه منحصر به فرد که توسط توسعه دهنده برای شناسایی تراکنش ایجاد می شود.
ارائه صورتحساب جایگزین با انتخاب کاربر
این بخش نحوه ارائه صورتحساب جایگزین به کاربران خود را با انتخاب استفاده از سیستم صورتحساب Google Play شرح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- شرایط واجد شرایط بودن برنامه(های) مربوطه را مرور کنید و مراحل ورود به سیستم را که در درک صورتحساب انتخاب کاربر در Google Play بیان شده است، تکمیل کنید.
- Play Billing Library نسخه 5.2 یا بالاتر را ادغام کنید.
بقیه ماژول‌های پیشنهادی یکپارچه‌سازی صورتحساب Google Play همان چیزی است که توسعه‌دهندگان قبلاً برای یکپارچه‌سازی فعلی خود دارند.
علاوه بر این، توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن آن را تقویت می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام برای صورتحساب جایگزین مربوطه با برنامه انتخابی کاربر را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین ادغام شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق Play Console مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، می‌توانید انتخاب کنید که آیا یک سیستم صورتحساب جایگزین ارائه دهید یا خیر.
- آرم های روش پرداخت را مطابق با دستورالعمل ها ، با رعایت تمام مشخصات قالب بارگذاری کنید. تصاویری که با این دستورالعمل ها مطابقت ندارند برای سیستم صورتحساب جایگزین شما در صفحه انتخاب کاربر نمایش داده نمی شوند. (توجه: گنجاندن آرم های روش پرداخت اختیاری است، اگرچه به شدت توصیه می شود.)
- اگر اشتراک ارائه می دهید، پیوند مدیریت اشتراک مورد نیاز را ارائه دهید.
تجربه کاربری
API های سمت سرویس گیرنده عملکرد زیر را فعال می کنند:
- Google Play اطلاعات مربوطه و صفحه‌های انتخاب کاربر را ارائه و مدیریت می‌کند
- اگر کاربر استفاده از سیستم صورتحساب Google Play را انتخاب کند، جریان صورتحساب با استفاده از رابط استاندارد صورتحساب Google Play ادامه می‌یابد.
برنامه توسعه دهنده | صفحه انتخاب صورتحساب |
مثال فقط برای اهداف توضیحی.
صفحه نمایش انتخاب کاربر
صفحه انتخاب کاربر به کاربران این امکان را می دهد که از سیستم صورتحساب جایگزین توسعه دهنده یا سیستم صورتحساب Google Play استفاده کنند.
آناتومی یک گزینه صورتحساب جایگزین
گزینه صورتحساب جایگزین در صفحه انتخاب کاربر شامل عناصر UI زیر است:
- نماد برنامه
- نام برنامه
- دارایی تصویر که شامل روش‌های پرداخت ارائه‌شده توسط توسعه‌دهنده است.
- نشانگر اضافی ( و عنصر UI بیشتر بخشی از دارایی تصویر نیست).
دارایی تصویر برای روش های پرداخت
دارایی تصویر واحد از چندین کارت روش پرداخت تشکیل شده است و باید از مشخصات تعریف شده در این دستورالعمل ها پیروی کند.
ابعاد | 192dp X 20dp |
فاصله کارت | 8dp |
فرمت فایل | PNG، پس زمینه شفاف |
تغییرات روش پرداخت
برنامه‌نویسان می‌توانند تعداد نمادهای روش پرداخت موجود را که می‌خواهند در دارایی تصویر قرار دهند، حداکثر تا 5 انتخاب کنند.
هیچ تصویر یا متن دیگری نباید در تصویر گنجانده شود.
مشخصات کارت
کارت‌های روش پرداخت موجود در دارایی تصویر باید از دستورالعمل‌های زیر برای اندازه، فاصله و سبک پیروی کنند.
| ابعاد کارت | 32dp X 20dp |
| بالشتک داخلی | 3dp |
| طرح کلی | 1dp (کورس داخلی در ابعاد گنجانده شده است)، شعاع 2dp، #E0E0E0 |
| پس زمینه کارت | رنگ ثابت (ترجیحا سفید) |
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین با انتخاب کاربر، راهنماهای عمیق را برای ادغام درون برنامه و ادغام باطن دنبال کنید.
ارائه فقط صورتحساب جایگزین
این بخش نحوه ارائه صورتحساب جایگزین را به کاربران خود بدون استفاده از سیستم صورتحساب Google Play توضیح می‌دهد. قبل از استفاده از این API ها، از موارد زیر اطمینان حاصل کنید:
- با دنبال کردن دستورالعمل‌های ارائه یک سیستم صورتحساب جایگزین برای کاربران در منطقه اقتصادی اروپا (EEA) برای صورتحساب جایگزین، شرایط را مرور کنید و در برنامه فقط صورتحساب جایگزین ثبت‌نام کنید.
- Play Billing Library نسخه 6.2.1 یا بالاتر را ادغام کنید.
توصیه می‌کنیم یک راه‌اندازی یکپارچه‌سازی API برنامه‌نویس Google Play را آماده کنید، زیرا ادغام باطن از آن استفاده می‌کند.
پیکربندی در Play Console
برنامه‌نویسانی که ثبت‌نام خود را تکمیل کرده‌اند و با APIهای صورتحساب جایگزین یکپارچه شده‌اند، می‌توانند تنظیمات صورتحساب جایگزین خود را از طریق کنسول Play مدیریت کنند:
- برای هر یک از برنامه‌های واجد شرایط خود، در هر کشور موجود، فقط یک صورتحساب جایگزین (بدون انتخاب کاربر) ارائه دهید.
صفحه نمایش اطلاعات برای کاربران
صفحه اطلاعات به کاربران کمک می کند بفهمند که فقط یک سیستم صورتحساب جایگزین در برنامه واجد شرایط ارائه می شود. پس از فعال شدن صورتحساب جایگزین، صفحه اطلاعات در شروع اولین خرید در برنامه شما به کاربران نشان داده می شود. این پیام در خریدهای بعدی که توسط همان کاربر در برنامه شما در همان دستگاه انجام می شود، نمایش داده نمی شود. توجه داشته باشید که ممکن است در مواقعی مانند زمانی که کاربر حافظه پنهان دستگاه خود را پاک می کند، دیالوگ دوباره به کاربر نشان داده شود.
مراحل بعدی
برای شروع یکپارچه‌سازی APIهای صدور صورتحساب جایگزین، از راهنماهای عمیق برای ادغام درون برنامه و ادغام باطن پیروی کنید.