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

يتم الآن عرض مستندات 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

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

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

يمكنك إدارة أرصدة الحسابات المدفوعة مسبقًا من خلال إعداد حساب تاجر مع مقدّم خدمة دفع تابع لجهة خارجية، مثل 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"
  } ]
}

تفعيل وحدتَي تحقيق الربح و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 Secure Payment في referenceUrl مع إلحاق مفتاح الطلب الفريد كمَعلمة طلب بحث.

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

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

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

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

لإعادة تحميل رصيد حساب مسبق الدفع لمطوّر برامج يستخدم واجهة برمجة التطبيقات، يجب إصدار طلب POST إلى /mint/organizations/{org_name}/developers/{developer_id}/developer-balances، حيث يكون {developer_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}/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. إذا أعددت إعادة التحميل التلقائية لحساب مُسبق الدفع باستخدام مقدّم خدمات الدفع، عليك إعادة ضبط عملية إعادة التحميل التلقائية لاستخدام رقم التعريف الجديد لمقدّم الخدمة، كما هو موضّح في إعداد إعادة التحميل التلقائي لأرصدة الحسابات المدفوعة مسبقًا باستخدام واجهة برمجة التطبيقات.

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

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