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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

مقدمة

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

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

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

استكشاف صفحة "الأرصدة"

ادخل إلى صفحة "الأرصدة" واستكشِفها على النحو الموضَّح أدناه.

إصدار رصيد

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} تعريف حزمة منتجات واجهة برمجة التطبيقات وخطة الأسعار التي ينطبق عليها الرصيد، على التوالي.

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

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

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

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

على سبيل المثال، يؤدي الطلب التالي إلى إصدار رصيد بقيمة 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"
}

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

تتوفّر مَعلمات طلب البحث التالية للاستخدام مع Credit API:

الاسم	الوصف	تلقائي	مطلوب؟
billingMonth	شهر الفوترة الذي ينطبق عليه الرصيد، مثل نيسان (أبريل)	لا ينطبق	لا
billingYear	سنة الفوترة التي ينطبق عليها الرصيد، مثل 2018	لا ينطبق	لا
currencyId	العملة المستخدمة في الرصيد. يتم إعداد العملة لخطة الأسعار في حزمة منتجات واجهة برمجة التطبيقات التي اشتراها المطوّر ولا يمكن تغييرها.	لا ينطبق	نعم
developerId	اسم المطوّر أو الشركة التي ينطبق عليها الرصيد	لا ينطبق	نعم
productId	منتج واجهة برمجة التطبيقات الذي ينطبق عليه الرصيد. وإذا لم تحدّد معرّف منتج، سيسري الرصيد على جميع منتجات واجهة برمجة التطبيقات في حزمة منتجات واجهة برمجة التطبيقات.	لا ينطبق	لا
transactionAmount	مبلغ الرصيد (بالعملة المحدّدة). حدِّد قيمة موجبة أو سالبة. لا يمكن أن تكون القيمة صفرًا.	لا ينطبق	نعم
transactionNote	لاحظ أن يصف سبب الرصيد.	لا ينطبق	نعم