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

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

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

• عرض رصيد حساب الدفع المُسبق الحالي اطّلِع على عرض أرصدة حسابات الدفع المسبق باستخدام واجهة برمجة التطبيقات.
• إعادة تحميل (إضافة أموال إلى) رصيد الحساب حسب الحاجة باستخدام مقدّم خدمة دفع تابع لجهة خارجية، مثل 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

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

إدارة أرصدة حسابات الدفع المُسبَق باستخدام مقدّم خدمة دفع

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

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

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

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

• إعداد حساب تاجر لدى موفّر خدمة الدفع Worldpay
• ضبط مقدم خدمات الدفع في Edge
• عرض مقدّمي خدمات الدفع الذين تم إعدادهم لمؤسستك
• تفعيل الوحدات المطلوبة وإعدادها في بوابة المطوّرين
• بدء عملية دفع إلى حساب دفع مسبق باستخدام مقدّم خدمة دفع
• إعادة تعبئة رصيد حساب مدفوع مسبقًا باستخدام واجهة برمجة التطبيقات
• حذف مقدّم خدمة دفع تابع لجهة خارجية

إعداد حساب تاجر لدى مقدّم خدمة الدفع Worldpay

قبل البدء، عليك التواصل مع مقدّم خدمة دفع تابع لجهة خارجية (Worldpay) لإعداد حسابات التجّار. ننصحك بإعداد حسابَين، أحدهما للاختبار والآخر للإنتاج. لمزيد من المعلومات حول حسابات التجّار على Worldpay، يُرجى الانتقال إلى www.worldpay.com وwp-support.crm.worldpay.com (مركز دعم Worldpay).

بعد إعداد حساب التاجر وتلقّي بيانات الاعتماد الخاصة به، اتّبِع الخطوات التالية لإعداد حساب التاجر باستخدام Worldpay:

1. انتقِل إلى https://secure.worldpay.com/sso/public/auth/login.html.
2. سجِّل الدخول إلى حسابك على Worldpay باستخدام بيانات الاعتماد التي قدّمتها لك Worldpay.
3. اضبط كلمة مرور XML والمفتاح السري لرمز مصادقة الرسائل (MAC):
   1. انقر على الملف الشخصي.
   2. اضبط كلمة المرور التي سيتم استخدامها عند إعداد موفّر خدمة الدفع Worldpay في Edge في حقل كلمة مرور XML.
   3. أدخِل مفتاحًا سريًا لعنوان MAC يتألف من 20 إلى 30 حرفًا في حقل المفتاح السري لإعادة التوجيه لعنوان MAC.
   4. انقر على حفظ الملف الشخصي.
4. أضِف خادم إدارة Apigee Edge إلى قائمة عناوين IP الخاصة بالتاجر (القائمة المسموح بها):
   1. انقر على الملف التجاري > بيئة التاجر.
   2. انقر على عنوان IP جديد للاختبار.
   3. أدخِل عنوان IP لخادم إدارة Apigee Edge.
   4. انقر على حفظ.
5. اضبط عنوان URL الخاص بالتاجر لإلحاق مَعلمات Worldpay، بما في ذلك رمز مصادقة الطريقة (MAC):
   1. انقر على عمليات التثبيت > صفحات الدفع المستضافة > مصمّم صفحة الدفع.
   2. ضمن تعديل صفحات الدفع، اختَر معرّف التثبيت من القائمة المنسدلة اختيار قناة.
   3. في علامة التبويب "السمات"، انقر على تعديل إعدادات التاجر.
   4. اضبط قيمة "إرسال مَعلمات عنوان URL" على صحيح.
   5. انقر على علامة التبويب نشر.
   6. يمكنك نقل التغييرات على النحو التالي:
      • بالنسبة إلى بيئات الاختبار، انقر على ترقية ضمن التصميم للترقية من "التصميم" إلى "وضع الحماية".
      • بالنسبة إلى بيئات الإنتاج، انقر على نقل ضمن بيئة الاختبار للنقل من بيئة الاختبار إلى بيئة الإنتاج.

ضبط مقدّم خدمة الدفع في Edge

الخطوة التالية هي إعداد مقدّم خدمة الدفع في Edge.

يمكنك ضبط مقدّم خدمة الدفع لمؤسسة معيّنة باستخدام واجهة برمجة التطبيقات التالية:

/organizations/{org-name}/providers

يمكن لعملاء Apigee Edge Private Cloud فقط الذين لديهم امتيازات مشرف النظام ضبط مزوّد خدمة دفع عالمي اختياريًا باستخدام واجهة برمجة التطبيقات التالية:

/config/providers

عند استدعاء كل واجهة برمجة تطبيقات، يجب تحديد المعلومات التالية في نص الطلب:

على سبيل المثال، يؤدي ما يلي إلى إعداد حساب تاجر لدى Worldpay باسم Worldpay-myorg:

$ curl  -H "Content-Type:application/json" -X POST -d \
'{
    "name": "Worldpay-myorg",
    "description": "Worldpay payment provider",
    "endpoint": "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "authType": "123456",
    "credential": "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "merchantCode": "myMerchantCode"
  }' \
"https://api.enterprise.apigee.com/v1/organizations/myOrg/providers" \
-u email:password 

عرض مقدّمي خدمات الدفع التابعين لجهات خارجية

يمكنك عرض مقدّمي خدمات الدفع التابعين لجهات خارجية الذين تم ضبط إعداداتهم لمؤسسة Edge وتأكيدهم من خلال إرسال طلب استرداد بيانات باستخدام GET إلى المورد التالي:

/mint/organizations/{org-name}/providers

على سبيل المثال، يعرض ما يلي مقدّمي خدمات الدفع التابعين لجهات خارجية الذين تم إعدادهم حاليًا لـ myorg:

$ curl  -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers" \
-u email:password

في ما يلي مثال على الردّ الذي يعرض حسابَي تاجر، أحدهما للاختبار والآخر للإنتاج.

{
  "provider" : [ {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-myorg",
    "merchantCode" : "MERCH_CODE",
    "name" : "Worldpay-myorg"
  }, {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-test",
    "merchantCode" : "MERCH_CODE_FROM_PROVIDER",
    "name" : "Worldpay-test"
  } ]
}

تفعيل وحدتَي Monetization وWorldpay وإعدادهما في بوابة مخصّصة للمطوّرين

فعِّل وحدتَي "تحقيق الربح" وWorldpay المطلوبتَين في "بوابة مخصّصة للمطوّرين". للحصول على التفاصيل، يُرجى الاطّلاع على ضبط إعدادات تحقيق الربح في "بوابة المطوّرين".

بدء عملية الدفع إلى حساب دفع مسبق باستخدام مقدّم خدمة الدفع

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

• قبول خطة أسعار، ولكن لا يتوفّر رصيد كافٍ في حساب الدفع المُسبَق
• طلب إضافة أموال إلى حسابه المدفوع مسبقًا

لبدء عملية دفع من خلال مزوّد خدمة دفع تابع لجهة خارجية باستخدام واجهة برمجة التطبيقات، أرسِل طلب POST إلى المرجع التالي، حيث يمثّل {developer_id} عنوان البريد الإلكتروني للمطوّر.

/mint/organizations/{org_name}/developers/{developer_id}/payment?amount={amount}&provider={providerId}&supportedCurrencyId={currency}

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

• المبلغ المطلوب إضافته إلى رصيد حساب الدفع المُسبَق (amount={amount})
• معرّف مقدّم خدمة الدفع (provider={providerId})
• العملة المتاحة (supportedCurrencyId={currency})

بالإضافة إلى ذلك، عليك تقديم تفاصيل أساسية عن الحساب، مثل عنوان إرسال الفواتير الخاص بالشركة.

على سبيل المثال، يعيد ما يلي تحميل رصيد حساب مدفوع مسبقًا باستخدام موفّر خدمة الدفع Worldpay. سيكون التحويل الأوّلي إلى حسابك المدفوع مسبقًا بقيمة 10 دولار أمريكي (تم ضبط مَعلمة طلب البحث amount على 10).

$ curl  -H "Content-Type:application/xml" -X POST -d \
'{
    "address1": "5115 Hopyard Ave.",
    "city": "Pleasanton",
    "country": "US",
    "state": "CA",
    "zip": "58158"
}'
' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/payment?amount=10&provider=worldpay-myorg&supportedCurrencyId=usd" \
-u email:password

في ما يلي مثال على الردّ:

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

يتم عرض عنوان URL الخاص بصفحة الدفع الآمنة من Worldpay في referenceUrl مع مفتاح الطلب الفريد الذي تم إلحاقه كمعلَمة طلب البحث.

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

كما هو موضّح في الخطوة 15 من عملية إدارة الحساب المدفوع مسبقًا، بعد أن يتأكّد مقدّم خدمات الدفع من إتمام العملية بنجاح، يرسل "بوابة مخصّصة للمطوّرين" طلبًا إلى Edge لإعادة تحميل الحساب المدفوع مسبقًا.

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

إعادة تعبئة رصيد حساب الدفع المسبق لأحد المطوّرين

لإعادة تحميل رصيد حساب مسبق الدفع لأحد المطوّرين باستخدام واجهة برمجة التطبيقات، أرسِل طلب POST إلى /mint/organizations/{org_name}/developers/{developer_id}/developer-balances، حيث {developer_id} هو عنوان البريد الإلكتروني للمطوّر. عند إرسال الطلب، عليك تحديد المبلغ المطلوب إضافته إلى الرصيد والعملة المستخدَمة في نص الطلب.

على سبيل المثال، يضيف الطلب التالي 1, 000 دولار أمريكي إلى رصيد حساب الدفع المسبق الخاص بأحد المطوّرين:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

للحصول على وصف لخصائص الطلب، راجِع ملخّص خصائص الطلب لإعادة تحميل حساب الدفع المسبق.

إعادة تعبئة رصيد حساب الدفع المُسبَق لشركة

لإعادة تحميل رصيد حساب مسبق الدفع لشركة باستخدام واجهة برمجة التطبيقات، أرسِل طلب POST إلى /mint/organizations/{org_name}/companies/{company_id}/developer-balances، حيث {company_id} هو رقم تعريف الشركة. عند إرسال الطلب، عليك تحديد المبلغ المطلوب إضافته إلى الرصيد والعملة المستخدَمة في نص الطلب.

على سبيل المثال، يضيف الطلب التالي 1000 دولار أمريكي إلى رصيد حساب الدفع المسبق الخاص بالشركة:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

للحصول على وصف لخصائص الطلب، راجِع ملخّص خصائص الطلب لإعادة تحميل حساب الدفع المسبق.

ملخّص لخصائص الطلب لإعادة تحميل حساب مدفوع مسبقًا

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

حذف مقدّمي خدمات الدفع التابعين لجهات خارجية

يمكنك حذف موفّر خدمة دفع تابع لجهة خارجية تم إعداده لمؤسسة Edge من خلال إرسال طلب DELETE إلى المورد التالي:

لحذف مقدّم خدمة دفع لمؤسسة معيّنة، استخدِم واجهة برمجة التطبيقات التالية:

/mint/organizations/{org-name}/providers/id

يمكن لعملاء Apigee Edge Private Cloud فقط الذين لديهم امتيازات مشرف النظام حذف مزوّد خدمة دفع عالمي اختياريًا باستخدام واجهة برمجة التطبيقات التالية:

/config/providers/id

على سبيل المثال، يؤدي ما يلي إلى حذف موفّري خدمات الدفع التابعين لجهات خارجية الذين تم إعدادهم حاليًا لحساب myorg:

$ curl  -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers/worldpay-myorg" \
-u email:password

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

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

إعداد ميزة "زيادة الرصيد تلقائيًا" في حسابات الدفع المسبق باستخدام واجهة برمجة التطبيقات

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

إعداد ميزة "زيادة الرصيد تلقائيًا" في حساب مدفوع مسبقًا لأحد المطوّرين

لإعداد ميزة إعادة التعبئة التلقائية لرصيد حساب الدفع المسبق الخاص بأحد المطوّرين عندما ينخفض الرصيد عن حدّ معيّن، أرسِل طلب POST إلى /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup، حيث يمثّل {developer_id} عنوان البريد الإلكتروني للمطوّر.

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

• معرّف مقدّم خدمة الدفع الذي سيتم استخدامه لإعادة تحميل الحساب (providerID)
• العلامة التي تتيح إعادة التحميل التلقائي (isRecurring)
• الحدّ الذي يجب أن ينخفض دونه رصيد حساب الدفع المسبق لتفعيل إعادة التعبئة التلقائية (replenishAmount)
• المبلغ الذي سيتم إضافته تلقائيًا إلى الحساب (recurringAmount)
• مَعلمة طلب البحث supportedCurrencyID لتحديد العملة

في المثال التالي، عندما ينخفض رصيد حساب المطوّر للدفع المسبق إلى أقل من 5 دولارات أمريكية، ستتم إضافة 10 دولارات أمريكية أخرى تلقائيًا إلى الحساب.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

للحصول على وصف لخصائص الطلب، يُرجى الاطّلاع على ملخّص خصائص الطلب لإعداد إعادة تحميل تلقائية للحسابات المدفوعة مسبقًا.

إعداد ميزة "زيادة الرصيد تلقائيًا" في حساب مدفوع مسبقًا لشركة

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

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

• معرّف مقدّم خدمة الدفع الذي سيتم استخدامه لإعادة تحميل الحساب (providerID)
• العلامة التي تتيح زيادة الرصيد تلقائيًا (isRecurring)
• الحدّ الذي يجب أن ينخفض دونه رصيد حساب الدفع المسبق لتفعيل إعادة التعبئة التلقائية (replenishAmount)
• المبلغ الذي سيتم إضافته تلقائيًا إلى الحساب (recurringAmount)
• مَعلمة طلب البحث supportedCurrencyID لتحديد العملة

في المثال التالي، عندما ينخفض رصيد حساب الدفع المسبق الخاص بالشركة إلى أقل من 5 دولارات أمريكية، سيتم تلقائيًا إضافة 10 دولارات أمريكية أخرى إلى الحساب.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

للحصول على وصف لخصائص الطلب، يُرجى الاطّلاع على ملخّص خصائص الطلب لإعداد إعادة تحميل تلقائية للحسابات المدفوعة مسبقًا.

ملخّص لخصائص الطلب لإعداد إعادة التعبئة التلقائية لحسابات الدفع المُسبَق

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

نقل البيانات إلى صفحات الدفع المستضافة من WorldPay

عدّلت WorldPay مسار معالجة الدفع الآمن لاستخدام مجموعة جديدة من الصفحات، يُشار إليها باسم "صفحات الدفع المستضافة".

إذا كنت قد أعددت مقدمي خدمات الدفع في WorldPay باستخدام عملية معالجة الدفع الآمنة المتوقّفة نهائيًا(قبل آب/أغسطس 2017)، عليك الانتقال إلى صفحات الدفع المستضافة الجديدة في WorldPay قبل كانون الثاني (يناير) 2018.

للانتقال إلى صفحات الدفع المستضافة من WorldPay، اتّبِع الخطوات التالية:

1. يُرجى التواصل مع WorldPay لنقل حسابك الحالي لاستخدام صفحات الدفع المستضافة الجديدة والحصول على معرّف تثبيت جديد لحسابك.
2. اضبط مقدّمي خدمات الدفع الجدد في WorldPay، كما هو موضّح في ضبط مقدّم خدمة الدفع في Edge، مع تمرير معرّف التثبيت في الحقل authType.
3. اضبط مقدّمي خدمات الدفع الجدد على بوابة مخصّصة للمطوّرين، كما هو موضّح في مقالة ضبط إعدادات تحقيق الربح في بوابة مخصّصة للمطوّرين.
4. إذا أعددت ميزة "تعبئة الرصيد تلقائيًا" في حساب مدفوع مسبقًا باستخدام موفّر خدمة الدفع، عليك إعادة ضبط إعدادات هذه الميزة لاستخدام رقم تعريف الموفّر الجديد، كما هو موضّح في مقالة إعداد ميزة "تعبئة الرصيد تلقائيًا" في حساب مدفوع مسبقًا باستخدام واجهة برمجة التطبيقات.

الخطوات التالية

يمكنك ضبط حدود ائتمان لكل مطوّر يستخدم الدفع الآجل. يمكنك الاطّلاع على كيفية إجراء ذلك في مقالة إدارة أرصدة الدفع الآجل.