كيفية دمج KoraPay

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

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

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

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

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

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

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

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

• KoraPay — للإيداعات.
• KoraPay bank account — للسحوبات إلى الحسابات البنكية.
• KoraPay mobile money — للسحوبات إلى المحافظ المحمولة عبر الأموال المحمولة.

في قسم Credentials الذي يظهر، اضبط الإعدادات الخاصة بـ KoraPay:

• في حقل API base URL، حدد https://api.korapay.com.
• في حقل Secret key، أدخل المفتاح السري من حساب KoraPay الخاص بك.
• في حقل Public key، أدخل المفتاح العام من حساب KoraPay الخاص بك.

للعثور على مفتاحيك السري والعام، سجّل الدخول إلى حساب KoraPay الخاص بك، وانتقل إلى Settings، ثم افتح علامة التبويب API Configuration.

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

سيظهر اتصال KoraPay في قائمة الاتصالات الخارجية.

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

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

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

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

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

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

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

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

• في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر مدعومة للإيداعات، مثل NGN وGHS وKES وXAF وXOF. ستكون الإيداعات عبر KoraPay متاحة للحسابات المقومة بالعملات المختارة.
• في القائمة المنسدلة Driver، اختر KoraPay.
• في القائمة المنسدلة Connection، اختر اتصال KoraPay المُعد مسبقًا للإيداعات.

في قسم Configuration، اضبط خيار Merchant bears cost على:

• Yes — يدفع الوسيط (التاجر) رسوم المعاملة.
• No — يدفع المتداول (العميل) رسوم المعاملة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون السحوبات عبر KoraPay متاحة من الحسابات المقومة بالعملات المختارة.

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

  • KoraPay bank account — للسحوبات إلى الحسابات البنكية.

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

  • KoraPay mobile money — للسحوبات إلى المحافظ المحمولة عبر الأموال المحمولة.

    تُدعم السحوبات لحسابات الأموال المحمولة الكينية (KES) والغانية (GHS) والإيفوارية (XOF) والكاميرونية (XAF).

• في القائمة المنسدلة Connection، اختر اتصال KoraPay المُعد مسبقًا للسحوبات.

في قسم Configuration، أكمل الإعدادات التالية:

لبرنامج التشغيل KoraPay bank account:

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

  • Yes — يدفع الوسيط (التاجر) رسوم المعاملة.
  • No — يدفع المتداول (العميل) رسوم المعاملة.

لبرنامج التشغيل KoraPay mobile money:

• اضبط خيار Merchant bears cost كما هو موضح أعلاه.
• في القائمة المنسدلة Country، اختر البلد الذي ستكون طريقة السحب هذه متاحة فيه، مثل كينيا أو غانا أو كوت ديفوار أو الكاميرون.

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

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

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

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

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

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

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

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

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

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

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