ממשקי API של מערכת חיוב חלופית

מפתחים שעומדים בדרישות יכולים להציע למשתמשים במדינות מסוימות מערכת חיוב חלופית באפליקציה שלהם ולדווח ל-Google על העסקאות שמתבצעות דרכה. בהתאם למקום שבו אתם מפיצים את האפליקציה ולעמידה בדרישות, יש שני סוגים של חיוב חלופי שאפשר להטמיע באפליקציה:

במדריך הזה מוסבר על ממשקי ה-API שצריך להשתמש בהם כדי להציע את אחת מהאפשרויות. לפני שמשתמשים בממשקי ה-API האלה, חשוב לעיין בדפי התוכנית ולהירשם לתוכניות הרלוונטיות.

מילון מונחים

מוסכמות המונחים שבהן נעשה שימוש במדריך הזה:

  • ממשקי API של מערכת חיוב חלופית: ממשקי API שמשמשים להצגת מסכים רלוונטיים למשתמשים ומאפשרים למפתחים לדווח על עסקאות שהושלמו במערכת החיוב החלופית של המפתח.
  • מערכת חיוב חלופית: מערכת חיוב חלופית של מפתח שאפשר להציע לצד מערכת החיוב של Google Play או בנפרד (בכפוף לדרישות הסף).
  • עסקה חיצונית: עסקה שמתבצעת מחוץ למערכת החיוב של Google Play.
  • אסימון של עסקה חיצונית: אסימון שמועבר למפתח דרך ספריית החיוב של Play, והמפתח יכול להשתמש בו כשהמשתמש משלים עסקה במערכת חיוב חלופית. הטוקן הזה משמש כדי להודיע ל-Google Play על רכישה מוצלחת.
  • מזהה עסקה חיצוני: מזהה ייחודי שנוצר על ידי המפתח כדי לזהות עסקה.

הצעה של חיוב חלופי עם בחירת משתמש

בקטע הזה מתואר איך להציע למשתמשים מערכת חיוב חלופית עם אפשרות לבחור להשתמש במערכת החיוב של Google Play. לפני שמשתמשים בממשקי ה-API האלה, חשוב לוודא את הדברים הבאים:

שאר המודולים המומלצים לשילוב החיוב ב-Google Play זהים לאלה שכבר קיימים אצל מפתחים בשילוב הנוכחי שלהם.

בנוסף, מומלץ להכין שילוב של Google Play Developer API כי השילוב בקצה העורפי יתבסס עליו.

הגדרה ב-Play Console

מפתחים שהשלימו את ההרשמה לתוכנית המתאימה של מערכת חיוב חלופית עם בחירה של המשתמש ושילבו ממשקי API של מערכת חיוב חלופית יכולים לנהל את ההגדרות של מערכת החיוב החלופית דרך Play Console:

  • אתם יכולים לבחור אם להציע מערכת חיוב חלופית בכל אחת מהאפליקציות שעומדות בדרישות.
  • מעלים את הלוגו של אמצעי התשלום בהתאם להנחיות ולכל מפרטי הפורמט. תמונות שלא עומדות בהנחיות האלה לא יוצגו במערכת החיוב החלופית במסך הבחירה של המשתמש. (הערה: אפשר לכלול לוגו של אמצעי התשלום, אבל מומלץ מאוד לעשות זאת).
  • אם אתם מציעים מינויים, עליכם לספק את הקישור הנדרש לניהול המינוי.
ממשק משתמש לדוגמה, למטרות המחשה בלבד, עשוי להשתנות.

חוויית משתמש

ממשקי ה-API בצד הלקוח מאפשרים את הפונקציונליות הבאה:

  • מערכת Google Play מעבדת את המידע הרלוונטי ומנהלת את מסכי הבחירה של המשתמשים
  • אם המשתמש בוחר להשתמש במערכת החיוב של Google Play, תהליך החיוב ממשיך באמצעות ממשק החיוב הרגיל של Google Play.

אפליקציה למפתחים.

מסך בחירת החיוב.

הדוגמה הזו מיועדת להמחשה בלבד.

מסך אפשרויות בחירה למשתמשים

במסך הבחירה מוצגת למשתמשים האפשרות להשתמש במערכת החיוב החלופית של המפתח או במערכת החיוב של Google Play.

מבנה של מערכת חיוב חלופית

אפשרות החיוב החלופית במסך בחירת המשתמש כוללת את רכיבי ממשק המשתמש הבאים:

  1. סמל האפליקציה.
  2. שם האפליקציה.
  3. נכס תמונה שכולל את אמצעי התשלום שהמפתח מציע.
  4. אינדיקטור נוסף (רכיב הממשק ועוד לא נכלל בנכס התמונה).

נכס תמונה של אמצעי תשלום

נכס התמונה היחיד מורכב מכמה כרטיסים של אמצעי תשלום, והוא צריך לעמוד במפרטים שמוגדרים בהנחיות האלה.

מידות

‫192dp X 20dp

המרווח בין הכרטיסים

8dp

תבנית קובץ

‫PNG, רקע שקוף

וריאציות של אמצעי תשלום

מפתחים יכולים לבחור את מספר הסמלים של אמצעי התשלום שהם רוצים לכלול בנכס התמונה, עד למקסימום של 5.

אסור לכלול בתמונה טקסט או תמונות אחרות.

מפרט הכרטיס

כרטיסי אמצעי התשלום שכלולים בנכס התמונה צריכים לעמוד בהנחיות הבאות לגבי גודל, מרווח וסגנון.

מידות הכרטיס ‫32dp X 20dp
מרווח פנימי 3dp
קווי מתאר ‫1dp (הקו הפנימי כלול בממדים), רדיוס 2dp,‏ ‎#E0E0E0
רקע הכרטיס צבע אחיד (רצוי לבן)

השלבים הבאים

כדי להתחיל לשלב את ממשקי ה-API של מערכת חיוב חלופית עם בחירת משתמש, צריך לפעול לפי המדריכים המפורטים בנושא שילוב באפליקציה ושילוב בקצה העורפי.

הצעה של מערכת חיוב חלופית בלבד

בקטע הזה מתואר איך להציע למשתמשים שלכם חיוב חלופי בלי אפשרות לבחור להשתמש במערכת החיוב של Google Play. לפני שמשתמשים בממשקי ה-API האלה, חשוב לוודא את הדברים הבאים:

מומלץ להכין שילוב של Google Play Developer API כי השילוב עם ה-Backend יתבסס עליו.

הגדרה ב-Play Console

מפתחים שסיימו את תהליך ההרשמה והטמיעו ממשקי API של מערכת חיוב חלופית יכולים לנהל את ההגדרות של מערכת החיוב החלופית דרך Play Console:

  • לכל אפליקציה שעומדת בדרישות, בוחרים אם להציע מערכת חיוב חלופית בלבד (בלי אפשרות בחירה למשתמש) בכל מדינה שבה האפשרות זמינה
ממשק משתמש לדוגמה, למטרות המחשה בלבד, עשוי להשתנות.

מסך מידע למשתמשים

מסך המידע עוזר למשתמשים להבין שבתוך האפליקציה שעומדת בדרישות מוצעת רק מערכת חיוב חלופית. מסך המידע יוצג למשתמשים בתחילת הרכישה הראשונה שלהם באפליקציה אחרי הפעלת החיוב החלופי. ההודעה הזו לא תוצג ברכישות הבאות שיבוצעו על ידי אותו משתמש באפליקציה שלכם באותו מכשיר. הערה: יכול להיות שבמקרים מסוימים, כמו אם המשתמש מוחק את מטמון הנתונים במכשיר שלו, תיבת הדו-שיח תוצג לו שוב.

השלבים הבאים

כדי להתחיל לשלב את ממשקי ה-API של מערכת החיוב החלופית, פועלים לפי המדריכים המפורטים בנושא שילוב באפליקציה ושילוב בקצה העורפי.