درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
مقدمه
کارمزدها زمانی برای توسعه‌دهندگان نرم‌افزار اعمال می‌شود که برای طرح نرخ ثبت‌نام می‌کنند. می‌توانید کارمزدها را برای هر نوع طرح نرخ به‌جز اعلان قابل‌تنظیم پیکربندی کنید. کارمزدها اختیاری هستند؛ لازم نیست هیچ کارمزدی را در طرح نرخ مشخص کنید.
پیکربندی کارمزدها برای طرح نرخ بااستفاده از واسط کاربر
کارمزدهای طرح نرخ را همان‌طور که در زیر توضیح داده شده است پیکربندی کنید.
Edge
برای پیکربندی کارمزدها، هنگام ایجاد یا ویرایش طرح نرخ هر نوع طرح نرخی (به‌جز «اعلان قابل‌تنظیم») را انتخاب کنید و موارد زیر را پیکربندی کنید:
درحال پیکربندی جزئیات قرارداد
جزئیات قرارداد را در بخش جزئیات قرارداد هنگام ایجاد یا ویرایش طرح قیمت پیکربندی کنید.
| فیلد | شرح | پیش‌فرض |
|---|---|---|
| واحد پول | واحد پول برای همه کارمزدها. مقداری را از منوِ کرکره‌ای انتخاب کنید. | ۲٫۷۹ |
| کارمزد راه‌اندازی | کارمزد یک‌باره‌ای که در تاریخ شروع طرح از هر توسعه‌دهنده کسر می‌شود. مقدار درآمدزایی را در فیلد وارد کنید یا از کلیدهای جهت‌نمای بالا/پایین برای انتخاب مقدار استفاده کنید. | 0 |
| کارمزد فسخ زودهنگام | کارمزد یک‌باره‌ای که درصورتی‌که توسعه‌دهنده طرح را قبل‌از دوره تمدید پایان دهد دریافت می‌شود. | 0 |
| طول قرارداد | فاصله زمانی که طرح به‌طور خودکار تمدید می‌شود (مگر اینکه توسعه‌دهنده قرارداد را قبل‌از تاریخ تمدید فسخ کند). تعداد و واحد (روز، هفته، یا ماه) را مشخص کنید. اگر این مقدار را روی ۰ تنظیم کنید، طرح تا زمانی که توسعه‌دهنده تصمیم بگیرد آن را پایان دهد، برقرار می‌ماند. | ۱ ماه |
| پرداخت ظرف | تعداد روزهایی که پرداخت سررسید می‌شود. | 30 |
درحال پیکربندی هزینه طرح نرخ
هنگام ایجاد یا ویرایش طرح نرخ، هزینه طرح نرخ را در بخش هزینه پیکربندی کنید.
| فیلد | شرح | پیش‌فرض |
|---|---|---|
| کارمزد پایه | کارمزدی که به‌طور مستمر از توسعه‌دهنده کسر می‌شود تا زمانی که توسعه‌دهنده طرح را پایان دهد. اگر کارمزد پایه مشخص می‌کنید، باید دوره صورت‌حساب (یا مدت) را نیز مشخص کنید، یعنی دوره زمانی بین کسر هزینه‌های کارمزد پایه را مشخص کنید (مثلاً ۳۰ روز). | 0 |
| دوره صورت‌حساب | مدت یا زمان بین کسر هزینه‌های پایه. برای مثال، ۳۰ روز. تعداد و واحد (روز، هفته، یا ماه) را مشخص کنید. | ۱ ماه |
| پیش‌پرداخت‌شده | مشخص کنید که آیا کارمزد پایه ازقبل کسر می‌شود یا خیر. اگر کارمزد پایه ازقبل کسر شود (
اگر کارمزد پایه ازقبل کسر نشود (
|
فعال |
| کارمزد سرشکن | مشخص کنید که آیا کارمزد سرشکن می‌شود یا خیر. این موضوع مربوط به توسعه‌دهندگانی است که طرح را در میانه ماه شروع یا تمام می‌کنند. اگر کارمزد سرشکن شود، کارمزد اولیه براساس تعداد روزهای باقی‌مانده تا پایان دوره (یا تعداد روزهای استفاده‌شده در دوره) محاسبه می‌شود. اگر کارمزد سرشکن نشود، توسعه‌دهندگان صرف‌نظر از زمان شروع (یا پایان) طرح، کارمزد اولیه کامل را پرداخت می‌کنند. | فعال |
Classic Edge (ابر خصوصی)
برای پیکربندی کارمزدها در طرح نرخ بااستفاده از «واسط کاربر Edge کلاسیک»:
- برگه «کارمزدها» را در پنجره «طرح نرخ» انتخاب کنید.
- اطلاعات زیر را وارد کنید:
فیلد شرح واحد پول واحد پولی که می‌خواهید کارمزدها به آن کسر شود. ارزی را از فهرست ارزهای پشتیبانی‌شده در منوِ کرکره‌ای انتخاب کنید.
مبلغ کارمزد راه‌اندازی کارمزد یک‌باره‌ای که در تاریخ شروع طرح از هر توسعه‌دهنده کسر می‌شود (یعنی تاریخی که توسعه‌دهنده طرح را خریداری می‌کند). مبلغی را که باید کسر شود وارد کنید.
فسخ زودهنگام کارمزد یک‌باره‌ای که درصورتی‌که توسعه‌دهنده طرح را قبل‌از دوره تمدید پایان دهد دریافت می‌شود. مبلغی را که باید کسر شود وارد کنید.
تکرارشونده کارمزدی که به‌طور مستمر از توسعه‌دهنده کسر می‌شود تا زمانی که توسعه‌دهنده طرح را پایان دهد. مبلغی را که باید کسر شود مشخص کنید.
نقطه دوره زمانی بین کسر هزینه‌های تکرارشونده. عددی (بین ۱ تا ۱۲) وارد کنید و «هفته» یا «ماه» را انتخاب کنید. برای مثال، ۱ را وارد کنید و «ماه» را انتخاب کنید تا مشخص کنید کارمزد تکرارشونده یک‌بار در ماه از توسعه‌دهنده کسر می‌شود.
سهم متناسب؟ نشان می‌دهد که آیا کارمزد تکرارشونده سرشکن می‌شود یا نه. این فیلد مربوط به توسعه‌دهنده‌ای است که بخش طرح را در میانه ماه شروع یا پایان می‌دهد. یکی از دکمه‌های رادیویی زیر را انتخاب کنید:
- بله، سرشکن می‌شود. «درآمدزایی» کارمزد اولیه را براساس تعداد روزهای باقی‌مانده تا پایان دوره (یا تعداد روزهای استفاده‌شده در دوره) سرشکن می‌کند.
- نه، کارمزد کامل. درآمدزایی صرف‌نظر از اینکه توسعه‌دهنده چه زمانی طرح را شروع (یا تمام) می‌کند، هزینه اولیه کامل را کسر می‌کند. این گزینه پیش‌فرض است.
ازقبل؟ نشان می‌دهد که آیا کارمزد تکرارشونده ازقبل کسر می‌شود یا نه. یکی از دکمه‌های رادیویی زیر را انتخاب کنید:
- بله، ازقبل کسر می‌شود. کسر هزینه درآمدزایی کارمزد تکرارشونده را ازقبل کسر می‌کند. برای مثال، اگر دوره ۱ ماهه باشد، کارمزد تکرارشونده در صورت‌حسابی که در پایان ماه صورت‌حساب قبلی تولید می‌شود کسر می‌شود.
- نه، معوقه است. «درآمدزایی» کارمزد را در پایان دوره کسر می‌کند. برای مثال، اگر دوره ۱ ماهه باشد، کارمزد تکرارشونده در صورت‌حساب در پایان ماه صورت‌حساب جاری کسر می‌شود. این گزینه پیش‌فرض است.
کارمزدهای سررسید نشان می‌دهد که کارمزدها چه زمانی سررسید می‌شوند. یکی از گزینه‌های ۳۰، ۴۵، ۶۰، یا ۹۰ روز را انتخاب کنید. یا «سفارشی» را انتخاب کنید تا دوره سررسید کارمزدهای دیگر را مشخص کنید.
پیکربندی کارمزدها برای طرح نرخ بااستفاده از API
هنگام ایجاد یا به‌روزرسانی طرح، می‌توانید کارمزدها را به طرح نرخ اضافه کنید. کارمزدها را در بدنه درخواست تماس مشخص می‌کنید.
برای مثال، درخواست زیر طرح نرخ استانداردی با کارمزد فسخ زودهنگام، کارمزد راه‌اندازی، و کارمزد تکرارشونده ایجاد می‌کند (هرکدام روی ۱۰ دلار امریکا تنظیم شده‌اند). مدت کارمزد ۳۰ روز است، کارمزدها ظرف ۳۰ روز سررسید می‌شوند، و کارمزد تکرارشونده به‌صورت تناسبی محاسبه می‌شود. (مشخصات مربوط به کارمزد برجسته شده است.)
$ 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
برای فهرست کامل گزینه‌های طرح نرخ، ویژگی‌های پیکربندی برای طرح‌های نرخ را ببینید.