إدارة أرصدة الحسابات المدفوعة مسبقًا

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

لإدارة الرصيد في حساب دفع مُسبَق، يمكنك:

• اعرض الرصيد الحالي في الحساب المدفوع مسبقًا. راجع عرض الدفع المسبق أرصدة الحسابات باستخدام واجهة برمجة التطبيقات.
• إعادة تحميل رصيد الحساب (إضافة أموال إليه) على النحو المطلوب من خلال الاستعانة بمقدّم خدمات دفع تابع لجهة خارجية مثل Worldpay. يُرجى الاطِّلاع على مقالة إدارة أرصدة الدفع المُسبَق باستخدام جهة خارجية. مقدّم خدمات الدفع

  وبدلاً من ذلك، يمكنك إدارة عملية إعادة التحميل عن طريق تتبُّع الدفعات يدويًا أو من خلال نظام فوترة متكامل ثم طلب واجهة برمجة تطبيقات تحقيق الربح لإعادة تحميل الحساب الموضَّحة في مقالة إدارة أرصدة الدفع المُسبَق يدويًا.

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

كيف أحسب الرصيد المتبقي في الحساب المدفوع مسبقًا؟

عند الاطّلاع على رصيد الحساب المدفوع مسبقًا لمطوّر برامج أو شركة، كما هو موضَّح في الأقسام التالية، يجب: الحصول على القيم التالية من الاستجابة:

• amount: إجمالي المبلغ المتاح للمدة الزمنية الحالية للفوترة يتم تعديل هذه القيمة عند إعادة التحميل. للحساب المدفوع مسبقًا باستخدام الطرق الموضحة في هذا القسم.
• usage: إجمالي المبلغ الذي تم استخدامه خلال المدة الزمنية الحالية للفوترة يتم تعديل هذه القيمة مع كل مؤهل يتم تحقيق الربح منه. معاملة أو عن طريق إصدار رصيد (إيجابي أو سلبي).

يمكنك حساب رصيد الحساب المدفوع مسبقًا المتبقي للمدة الزمنية الحالية للفوترة عن طريق طرح قيمة usage من amount. على سبيل المثال، إذا كانت قيمة amount هي 335.50 وقيمة usage هي 34، يتم يتم احتساب الرصيد المتبقي على النحو التالي:

amount(335.50) - usage(34) = 229.50

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

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

عرض أرصدة حسابات الدفع المسبق لمطوّر البرامج

لعرض أرصدة حسابات الدفع المُسبَق لمطوّر برامج، يمكنك إصدار طلب GET إلى إحدى واجهات برمجة التطبيقات التالية، حيث يكون {developer_id} هو عنوان البريد الإلكتروني للمطوّر:

• /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: لعرض رصيد الحساب المدفوع مسبقًا ومعلومات الإعداد المتكررة لمطوّر البرامج.
• /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: لعرض معلومات رصيد الحساب المدفوع مسبقًا بما في ذلك الرصيد الحالي والإجمالي، والاستخدام، وإضافة رصيد، وضريبة الاستخدام.

يمكنك تمرير مَعلمات طلب البحث التالية لفلترة النتائج:

على سبيل المثال:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

يقدم ما يلي مثالاً على الرد:

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

عرض أرصدة الحسابات المدفوعة مسبقًا لشركة

للاطّلاع على أرصدة الحسابات المدفوعة مسبقًا لإحدى الشركات، يمكنك إصدار طلب استرداد بيانات باستخدام GET إلى /mint/organizations/{org_name}/companies/{company_id}/developer-balances، حيث {company_id} هو الرقم التعريفي للشركة. إذا كانت الشركة تستخدم نظام الدفع المسبق، فسيطلب لاسترداد الرصيد الحالي في الحساب المدفوع مسبقًا. إذا كانت الشركة تعمل بنظام الدفع عند الاستخدام، فإن الطلب يسترد حد الائتمان الحالي.

يمكنك تمرير مَعلمات طلب البحث التالية لفلترة النتائج:

على سبيل المثال:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

تشبه الإجابة الرد الموضح أعلاه، عند عرض أرصدة حسابات الدفع المسبق مطور برامج.