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

ضبط مقدّم خدمة الدفع في 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 بتنسيق 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)
• الحدّ الأدنى الذي يجب أن ينخفض إليه رصيد الحساب المدفوع مسبقًا لبدء عملية reloading (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)
• الحدّ الأدنى الذي يجب أن ينخفض إليه رصيد الحساب المدفوع مسبقًا لبدء عملية reloading (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. في حال إعداد ميزة إعادة التحميل التلقائي لحساب مسبق الدفع باستخدام موفِّر الدفع، عليك إعادة ضبط ميزة إعادة التحميل التلقائي لاستخدام رقم تعريف موفِّر الخدمة الجديد، كما هو موضّح في مقالة إعداد ميزة إعادة التحميل التلقائي لأرصدة الحسابات المدفوعة مسبقًا باستخدام واجهة برمجة التطبيقات.

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

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