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

أنت تعرض مستندات 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"
}

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

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