الأرصدة الصادرة

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

مقدمة

تمنحك ميزة تحقيق الربح المرونة في إصدار رصيد مطوّر.

بالنسبة إلى المطوّرين الذين يدفعون مسبقًا، يظهر الرصيد على شكل انخفاض في الاستخدام، ما يؤدي إلى زيادة أو خفض رصيد الدفع المسبق للمطوّر في المستقبل. كما هو الحال عند استخدام بطاقة السحب الآلي، يتم سحب الأموال من الرصيد المدفوع مسبقًا للمطوّر عندما يشتري المطوّر حزمة منتجات من واجهة برمجة التطبيقات. يجب أن يحتفظ المطوّر برصيد كافٍ لإجراء عمليات الشراء. اطّلِع على كيف يمكنني احتساب رصيد حساب الدفع المسبق المتبقّي؟

بالنسبة إلى المطوّرين الذين يستخدمون الدفع الآجل، يظهر الرصيد كسطر منفصل في الفاتورة، ما يؤدي إلى خفض الرسوم في الفاتورة.

استكشاف صفحة "الاعتمادات"

الوصول إلى صفحة "الأرصدة" واستكشافها، كما هو موضّح أدناه

إصدار رصيد

1. الوصول إلى صفحة "الرصيد"
2. انقر على + ائتمان.
3. أدخل المعلومات التالية:

   الحقل	الوصف
   شهر الفوترة	شهر الفوترة الذي يتم فيه تطبيق الرصيد اختَر شهرًا من القائمة.
   المطوّر	اسم المطوّر أو الشركة التي ينطبق عليها الرصيد أدخِل الاسم في مربّع النص. أثناء الكتابة، ستظهر قائمة بالمطوّرين أو الشركات التي تتضمّن السلسلة في قائمة منسدلة. انقر على اسم المطوّر أو الشركة من القائمة المنسدلة. ملاحظة: بعد اختيار مطوّر أو شركة، يتم عرض الحقول المتبقية. إذا اخترت شركة أو مطوّرًا لم يقبل خطة أسعار، لن تتمكّن من إصدار رصيد.
   حزمة المنتجات	حزمة منتجات واجهة برمجة التطبيقات التي ينطبق عليها الرصيد اختَر من قائمة حِزم منتجات واجهة برمجة التطبيقات المتاحة.
   المنتج	منتج واجهة برمجة التطبيقات في حزمة منتجات واجهة برمجة التطبيقات المحدّدة التي ينطبق عليها الرصيد اختَر كل المنتجات أو منتجًا واحدًا من منتجات واجهة برمجة التطبيقات من القائمة.
   العملة	العملة المستخدَمة في الرصيد. يتم ضبط العملة لخطة الأسعار في حزمة منتجات واجهة برمجة التطبيقات التي اشتراها المطوّر، ولا يمكن تغييرها. إذا كانت هناك عملات متعدّدة محدّدة في خطة أسعار، يمكنك الاختيار من بين إحدى العملات.
   المبلغ	مبلغ الرصيد (بالعملة المحدّدة) حدِّد قيمة موجبة أو سالبة. لا يمكن أن تكون القيمة صفرًا.
   ملاحظة	ملاحظة اختيارية لوصف سبب الرصيد

4. انقر على حفظ بطاقة الائتمان.

إصدار أرصدة باستخدام واجهة برمجة التطبيقات

باستخدام واجهة برمجة التطبيقات، يمكنك منح رصيد لمطوّر مقابل حزمة منتجات واجهة برمجة تطبيقات بأكملها، أو مقابل استخدام منتج معيّن من منتجات واجهة برمجة التطبيقات في حزمة منتجات واجهة برمجة تطبيقات.

لإصدار رصيد باستخدام واجهة برمجة التطبيقات، أرسِل طلب POST إلى /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions، حيث يحدّد {package_id} و{rate-plan_id} معرّف حزمة منتجات واجهة برمجة التطبيقات وخطة الأسعار التي ينطبق عليها الرصيد، على التوالي.

عند إرسال الطلب، عليك تحديد ما يلي كمعلَمات طلب بحث:

• معرّف المطوّر (عنوان البريد الإلكتروني) الذي ينطبق عليه الرصيد
• مبلغ الرصيد
• العملة المستخدَمة في الرصيد.
• ملاحظة تصف سبب منح الرصيد.

يمكنك اختياريًا تحديد مَعلمات طلب البحث الإضافية التالية:

• شهر الفوترة الذي ينطبق عليه الرصيد تكون هذه القيمة تلقائيًا هي الشهر الحالي.
• سنة الفوترة التي ينطبق عليها الرصيد تكون هذه القيمة تلقائيًا هي السنة الحالية.
• تمثّل هذه السمة منتج واجهة برمجة التطبيقات الذي ينطبق عليه الرصيد. إذا لم تحدّد معرّف منتج API، سيتم تطبيق الرصيد على جميع منتجات API في حزمة منتجات API.

على سبيل المثال، يمنح الطلب التالي رصيدًا بقيمة 100 دولار أمريكي لشهر الفوترة في أبريل 2018 لمطوّر تم تعريفه على أنّه dev1@myorg.com. ينطبق الرصيد على حزمة منتجات واجهة برمجة التطبيقات payment وخطة الأسعار payment_standard_plan:

اطّلِع على مَعلمات طلب البحث لواجهة برمجة التطبيقات الخاصة بالرصيد للحصول على قائمة كاملة بمَعلمات طلب البحث التي يمكنك تحديدها في طلب رصيد.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/rate-plans/payment_standard_plan/real-currency-credit-transactions?currencyId=usd&developerId=dev1@myorg.com&transactionAmount=100&transactionNote=Credit+for+failed+transactions&billingMonth=APRIL&billingYear=2013" \
-u email:password

في ما يلي مثال على مقتطف من الردّ:

{
  "currency" : "USD",
  "developer" : {
    "address" : [ {
      "address1" : "Dev One Address",
     ...
    } ],
    "approxTaxRate" : 0.0000,
    "billingType" : "PREPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev1@myorg.com",
    "hasSelfBilling" : false,
    "id" : "K4jW2QLjZ1h8GFA8",
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
     ...
    },
    "registrationId" : "TestRegId",
    "status" : "ACTIVE",
    "type" : "TRUSTED"
  },
  "endTime" : "2013-09-04 15:54:36",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8107,
  "gbpExchangeRate" : 0.6860,
  "id" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "isVirtualCurrency" : false,
  "notes" : "Credit for failed transactions",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  "providerTxId" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "rate" : 100,
  "ratePlan" : {
    ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "description" : "Standard Plan",
    "displayName" : "Standard Plan",
    …
    "monetizationPackage" : {
      "description" : "Payment",
      ...
        } ],
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Payment",
        "displayName" : "Payment",
        "id" : "payment",
        "name" : "payment",
        "organization" : {
          ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Standard Plan",
    "organization" : {
     ...
    },
    ...
      },
      ...
      },
      ...
  },
  "revenueShareAmount" : 0,
  "startTime" : "2013-09-04 15:54:36",
  "status" : "SUCCESS",
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "CREDIT",
  "usdExchangeRate" : 1.0675,
  "utcEndTime" : "2013-09-04 15:54:36",
  "utcStartTime" : "2013-09-04 15:54:36"
}

مَعلمات طلب البحث في واجهة برمجة التطبيقات الخاصة بالأرصدة

تتوفّر مَعلمات طلب البحث التالية لاستخدامها مع واجهة برمجة التطبيقات الخاصة بالرصيد: