كيفية دمج PayPal

تعرّف على كيفية دمج PayPal مع B2CORE عبر PSS للإيداعات والسحوبات. يغطي ذلك إعداد اتصالات PayPal وإضافة طرق الإيداع والسحب والتحقق من التكوينات

يمكن ربط PayPal بـ B2CORE فقط عبر PSS، مع دعم الإيداعات والسحوبات.

اتبع الإرشادات أدناه لتكوين اتصالات PayPal وإعداد طريقتَي الإيداع والسحب في Back Office الخاص بـ B2CORE. تتوافق هذه الإرشادات مع الإجراء العام لإضافة طرق لأنظمة الدفع المدعومة من PSS، لكنها تتضمن تفاصيل خاصة بـ PayPal.

قبل متابعة الإرشادات، يجب أن تكون قد سجلت في PayPal ولديك حساب نشط.

تكوين الاتصالات بـ PayPal

إذا كنت تخطط لاستخدام PayPal لكل من الإيداعات والسحوبات، فيجب عليك تكوين اتصالين منفصلين: أحدهما للإيداعات والآخر للسحوبات.

لتكوين اتصال بـ PayPal:

في Back Office الخاص بـ B2CORE، انتقل إلى System > External connections.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create connection، املأ الحقول التالية:

  • في حقل Name، أدخل اسمًا للاتصال. يجب أن يكون الاسم فريدًا وأن يحتوي فقط على أحرف لاتينية وأرقام وشرطات وشرطات سفلية (على سبيل المثال، Deposits_PayPal أو Withdrawals_PayPal).

  • في حقل Caption، أدخل تسمية توضيحية سيتم تطبيقها على الاتصال في Back Office.

  • في القائمة المنسدلة Provider، اختر:

    • PaymentSystemDeposit — لإضافة اتصال سيُستخدم لطريقة إيداع.
    • PaymentSystemWithdrawal — لإضافة اتصال سيُستخدم لطريقة سحب.

في القائمة المنسدلة Driver التي تظهر، اختر PayPal.

في قسم Credentials الذي يظهر، قم بتكوين الإعدادات الخاصة بـ PayPal:

  • في حقل API base URL، حدّد https://api-m.paypal.com.
  • في حقل Client ID، أدخل معرّف تطبيق REST API الذي أنشأته في حساب PayPal الخاص بك.
  • في حقل Client secret، أدخل السر الخاص بالعميل المرتبط بذلك التطبيق.

للعثور على معرّف العميل والسر الخاص بك، سجّل الدخول إلى حساب PayPal وانتقل إلى My Apps & Credentials في القائمة الرئيسية. في علامة التبويب Live، اختر تطبيقك لعرض بيانات الاعتماد ونسخها.

انقر على Save لإنشاء الاتصال.

سيظهر اتصال PayPal للإيداعات أو السحوبات في قائمة الاتصالات الخارجية.

تحقق من حالة الاتصال.

إذا كان الاتصال غير نشط (تظهر No في عمود Enabled)، فانقر على زر Edit لفتح تفاصيل الاتصال واضبط القائمة المنسدلة Enabled على Yes.

انقر على Save لتطبيق التغييرات.

إذا كنت بحاجة إلى دعم كل من الإيداعات والسحوبات عبر PayPal، فاتبع الإرشادات نفسها لإنشاء اتصال جديد للعملية الأخرى.

إضافة طريقة إيداع عبر PayPal

لإضافة وإعداد طريقة لإجراء الإيداعات عبر PayPal:

في Back Office الخاص بـ B2CORE، انتقل إلى System > Deposit system > Deposit methods.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create a deposit method، املأ الحقول التالية:

  • في حقل Name، أدخل اسمًا للطريقة. يجب أن يكون الاسم فريدًا وأن يحتوي فقط على أحرف لاتينية وأرقام وشرطات وشرطات سفلية.
  • في حقل Caption، أدخل تسمية توضيحية للطريقة. سيتم تعيين هذه التسمية للطريقة في Back Office وستكون مرئية للعملاء في واجهة B2CORE.
  • في القائمة المنسدلة Provider، اختر PaymentSystemDeposit.

بعد اختيار PaymentSystemDeposit، تظهر الحقول التالية:

  • في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون الإيداعات عبر PayPal متاحة للحسابات المقومة بالعملات المحددة.
  • في القائمة المنسدلة Driver، اختر PayPal.
  • في القائمة المنسدلة Connection، اختر اتصال PayPal للإيداعات الذي تم تكوينه مسبقًا.

في قسم Configuration الذي يظهر، قم بتكوين المعلمة التالية:

  • في القائمة المنسدلة Amount type، اختر كيفية احتساب مبلغ الإيداع النهائي:

    • Net amount (الخيار الافتراضي) — المبلغ الذي يتلقاه الوسيط بعد خصم رسوم معاملات PayPal. إذا لم يتم تعيين عمولة للطريقة في B2CORE، فسيتم إيداع هذا المبلغ الصافي في حساب العميل. إذا تم تعيين عمولة، فسيتم خصمها من المبلغ الصافي، وسيتلقى العميل مبلغًا أقل. في كلتا الحالتين، لا يتكبد الوسيط أي خسائر.

    • Gross amount — مبلغ الإيداع الكامل قبل خصم رسوم معاملات PayPal. إذا لم يتم تعيين عمولة للطريقة في B2CORE، فسيتلقى الوسيط مبلغًا أقل من المبلغ الإجمالي بسبب رسوم PayPal، وسيتعين عليه تغطية الفرق، مما يؤدي إلى خسارة.

      لمزيد من التفاصيل حول إعداد العمولات، راجع كيفية تكوين العمولات لطرق الإيداع والسحب.

انقر على Save لإنشاء طريقة الإيداع.

ستظهر طريقة إيداع PayPal في قائمة طرق الإيداع.

انقر على Edit للدخول إلى تفاصيل الطريقة وأكمل الحقول التالية:

  • في علامة التبويب Settings، استخدم القائمة المنسدلة Group لاختيار مجموعة واحدة أو أكثر يجب تضمين الطريقة فيها.

  • في حقل Icon، حدّد paymethod-paypal لعرض الأيقونة المحددة مسبقًا لطريقة إيداع PayPal في واجهة B2CORE. لاستخدام أيقونة مخصصة، حدّد رابط الصورة المطلوب عرضها.

  • تحقق من حالة الطريقة.

    إذا كانت الطريقة غير نشطة (تظهر No في حقل Enabled)، فقم بتنشيطها عبر ضبط القائمة المنسدلة Enabled على Yes.

  • أضف العملات المطلوبة في علامة التبويب PS Currencies. لتمكين الطريقة من معالجة الإيداعات بعملة محددة، تأكد من إضافتها في علامة التبويب هذه (للاطلاع على وصف علامة التبويب، راجع Deposit methods).

  • عند الحاجة، قم بتكوين العمولات للطريقة في علامة التبويب Commissions (للتفاصيل، راجع كيفية تكوين العمولات لطرق الإيداع والسحب).

طريقة إيداع PayPal — علامة التبويب Settings

انقر على Test configuration للتحقق من صحة إعدادات اتصال طريقة الإيداع.

ستظهر نتيجة الاختبار على الصفحة.

بعد التحقق من صحة التكوين بنجاح، انقر على Save.

تم الآن تكوين طريقة إيداع PayPal في Back Office الخاص بـ B2CORE.

إضافة طريقة سحب عبر PayPal

لإضافة وإعداد طريقة لإجراء السحوبات عبر PayPal:

في Back Office الخاص بـ B2CORE، انتقل إلى System > Payout system > Payout methods.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create a payout method، املأ الحقول التالية:

  • في حقل Name، أدخل اسمًا للطريقة. يجب أن يكون الاسم فريدًا وأن يحتوي فقط على أحرف لاتينية وأرقام وشرطات وشرطات سفلية.
  • في حقل Caption، أدخل تسمية توضيحية للطريقة. سيتم تعيين هذه التسمية للطريقة في Back Office وستكون مرئية للعملاء في واجهة B2CORE.
  • في القائمة المنسدلة Provider، اختر PaymentSystemWithdrawal.

بعد اختيار PaymentSystemWithdrawal، تظهر الحقول التالية:

  • في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون السحوبات عبر PayPal متاحة من الحسابات المقومة بالعملات المحددة.
  • في القائمة المنسدلة Driver، اختر PayPal.
  • في القائمة المنسدلة Connection، اختر اتصال PayPal للسحوبات الذي تم تكوينه مسبقًا.

تخطَّ قسم Configuration، إذ لا توجد إعدادات مطلوبة لطريقة سحب PayPal.

انقر على Save لإنشاء طريقة السحب.

ستظهر طريقة سحب PayPal في قائمة طرق السحب.

انقر على Edit للدخول إلى تفاصيل الطريقة وأكمل الحقول التالية:

  • في علامة التبويب Settings، استخدم القائمة المنسدلة Group لاختيار مجموعة واحدة أو أكثر يجب تضمين الطريقة فيها.

  • في حقل Icon، حدّد paymethod-paypal لعرض الأيقونة المحددة مسبقًا لطريقة سحب PayPal في واجهة B2CORE. لاستخدام أيقونة مخصصة، حدّد رابط الصورة المطلوب عرضها.

  • تحقق من حالة الطريقة.

    إذا كانت الطريقة غير نشطة (تظهر No في حقل Enabled)، فقم بتنشيطها عبر ضبط القائمة المنسدلة Enabled على Yes.

  • أضف العملات المطلوبة في علامة التبويب PS Currencies. لتمكين الطريقة من معالجة السحوبات بعملة محددة، تأكد من إضافتها في علامة التبويب هذه (للاطلاع على وصف علامة التبويب، راجع Payout methods).

  • عند الحاجة، قم بتكوين العمولات للطريقة في علامة التبويب Commissions (للتفاصيل، راجع كيفية تكوين العمولات لطرق الإيداع والسحب).

طريقة سحب PayPal — علامة التبويب Settings

انقر على Test configuration للتحقق من صحة إعدادات اتصال طريقة السحب.

ستظهر نتيجة الاختبار على الصفحة.

بعد التحقق من صحة التكوين بنجاح، انقر على Save.

تم الآن تكوين طريقة سحب PayPal في Back Office الخاص بـ B2CORE.

آخر تحديث في

في هذه الصفحة