הגדרת עמלות לתוכנית תעריפים

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

מבוא

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

הגדרת עמלות לתוכנית תעריפים באמצעות ממשק המשתמש

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

Edge

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

הגדרת פרטי החוזה

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

שדה תיאור ברירת מחדל
מטבע המטבע לכל העמלות. בוחרים ערך מהתפריט הנפתח. USD
עמלת הגדרה עמלה חד-פעמית שבה נחייב כל מפתח בתאריך ההתחלה של התוכנית. מזינים ערך כספי בשדה, או משתמשים במקשי החיצים למעלה/למטה כדי לבחור ערך. 0
עמלת ביטול מוקדם עמלה חד-פעמית שתחויב אם המפתח יסיים את התוכנית לפני תקופת החידוש. 0
אורך החוזה תקופת הזמן שבה התוכנית מתחדשת באופן אוטומטי (אלא אם המפתח מסיים את ההסכם לפני תאריך החידוש). מציינים את המספר והיחידה (יום, שבוע או חודש). אם מגדירים את הערך הזה כ-0, התוכנית תישאר בתוקף עד שהמפתח יבחר לסיים אותה. חודש אחד
המועד לתשלום חל בתוך מספר הימים ממועד פירעון התשלום. 30

הגדרת העלות של תוכנית תעריפים

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

שדה תיאור ברירת מחדל
עמלה בסיסית המפתח מחויב באופן קבוע עד שהמפתח יסיים את התוכנית. אם מציינים עמלת בסיס, צריך לציין גם את תקופת החיוב (או משך הזמן), כלומר יש לציין את פרק הזמן שחולף בין החיובים של עמלת הבסיס (למשל 30 ימים). 0
תקופת חיוב משך הזמן או משך הזמן בין החיובים של עמלת הבסיס. למשל, 30 יום. מציינים את המספר והיחידה (יום, שבוע או חודש). חודש אחד
משולם מראש יש לציין אם עמלת הבסיס נגבית מראש.

אם העמלה הבסיסית חויבה מראש (true):

  • עבור מפתחים שמשלמים מראש, סכום הבסיס מנוכה בזמן הרכישה של תוכנית התמחור והתשלומים. אם אין מספיק כסף בחשבון בתשלום מראש, הרכישה תיכשל. אפשר לעיין בקטע איך מחשבים את היתרה ששולמה מראש בחשבון?
  • מפתחים שמשלמים לאחר השימוש (postpay) מחויבים בחשבונית בתאריך הרכישה של תוכנית התמחור והתשלומים.

אם העמלה הבסיסית לא חויבה מראש (false):

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

Classic Edge (ענן פרטי)

כדי להגדיר עמלות לתוכנית תעריפים באמצעות ממשק המשתמש של Classic Edge:

  1. בוחרים בכרטיסייה 'עמלות' בחלון 'תוכנית מחירים'.

  2. הזן את המידע הבא:
    שדה תיאור
    מטבע

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

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

    עמלה חד-פעמית שתיגבה אם המפתח יסיים את התוכנית לפני החידוש מונח. מזינים את הסכום לחיוב.
    חוזרת

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

    פרק הזמן בין חיובי העמלות הקבועים. צריך להזין מספר (בין 1 ל- 12) ובוחרים באפשרות 'שבוע' או 'חודש'. לדוגמה, מזינים 1 ובוחרים באפשרות 'חודש' כדי לציין המפתח מחויב בתשלום הקבוע פעם בחודש.
    שיעור יחסי?

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

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

    מציין אם העמלה הקבועה חויבה מראש או לא. יש לבחור אחד מ- לחצני הבחירה הבאים:

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

    מציין את המועד לתשלום העמלות. בוחרים 30, 45, 60 או 90 ימים. או לבחור התאמה אישית כדי לציין תקופת פירעון נוספת של עמלות.

הגדרת עמלות לתוכנית תעריפים באמצעות ה-API

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

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

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "advance": false,
     "name": "Simple rate plan",
     "currency": {
      "id" : "usd"
     },
     "earlyTerminationFee": "10",
     "frequencyDuration": "30",
     "description": "Simple rate plan",
     "displayName" : "Simple rate plan",
     "frequencyDurationType": "DAY",
     "monetizationPackage": {
      "id": "location_package"
     },
     "organization": {
      "id": "myorg"
     },
     "prorate": "true",
     "paymentDueDays": "30",
     "published": "true",
     "ratePlanDetails": [
     {
      …
      }
      ],
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password

רשימה מלאה של האפשרויות של תוכניות תעריפים מופיעה במאמר מאפייני הגדרה של תוכניות תעריפים.