كيفية دمج B2BINPAY

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

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

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

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

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

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

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

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

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

• في حقل API base URL، حدد عنوان URL الأساسي الذي توفره B2BINPAY لبيئة التكامل الخاصة بك.
• في حقل Client ID، أدخل معرّف العميل الذي توفره B2BINPAY.
• في حقل Client secret، أدخل المفتاح السري المرتبط بمعرّف العميل الخاص بك.
• في حقل Callback secret، أدخل المفتاح المستخدم للتحقق من إشعارات الاستدعاء الخلفي من B2BINPAY.

لمزيد من التفاصيل، راجع كيفية الوصول إلى API في وثائق B2BINPAY.

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

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

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

إذا كان الاتصال غير نشط (تظهر 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، اختر PaymentSystemStaticDeposit.

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

• في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون الطريقة متاحة لإيداع الأموال في محافظ العملاء في B2CORE المقومة بالعملات المضافة في علامة التبويب هذه.
• في القائمة المنسدلة Driver، اختر B2BINPAY V3.
• في القائمة المنسدلة Connection، اختر اتصال B2BINPAY المكوّن مسبقًا للإيداعات.

بعد اختيار الاتصال، يظهر نموذج Configuration. قد تظهر لك الرسالة Configuration form is temporarily unavailable. انتظر قليلًا حتى يصبح النموذج متاحًا.

في قسم Configuration، املأ الحقول التالية:

• في القائمة المنسدلة Wallet، اختر محفظة B2BINPAY الخاصة بك التي ستُستخدم لمعالجة المعاملات. لكل محفظة في القائمة، يتم عرض المعرّف الذي عيّنته B2BINPAY، ونوع المحفظة (Merchant أو Enterprise)، وعملة المحفظة، والتسمية (إن تم تحديدها في B2BINPAY).

  للتفاصيل، راجع اختيار البلوك تشين لمحافظ Merchant وEnterprise.

• يعرض حقل Collect personal data القيمة No، ولا يمكن تغييرها لأن قاعدة السفر غير مدعومة حاليًا في تكامل B2BINPAY هذا.

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

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

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

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

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

• في القائمة المنسدلة Rates provider، اختر B2BINPAY باعتباره موفر الأسعار المفضل لمعالجة الإيداعات مع التحويلات. للقيام بذلك، يجب أولًا إضافة B2BINPAY كموفر لسعر الصرف ضمن Currencies > Rates (للتفاصيل، راجع كيفية تكوين أسعار صرف العملات).

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

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

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

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

انقر على 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، اختر عملة واحدة أو أكثر. ستكون الطريقة متاحة لسحب الأموال من محافظ العملاء في B2CORE المقومة بالعملات المضافة في علامة التبويب هذه.
• في القائمة المنسدلة Driver، اختر B2BINPAY V3.
• في القائمة المنسدلة Connection، اختر اتصال B2BINPAY المكوّن مسبقًا للسحوبات.

بعد اختيار الاتصال، يظهر نموذج Configuration. قد تظهر لك الرسالة Configuration form is temporarily unavailable. انتظر قليلًا حتى يصبح النموذج متاحًا.

في قسم Configuration، املأ الحقول التالية:

• في القائمة المنسدلة Wallet، اختر محفظة B2BINPAY الخاصة بك التي ستُستخدم لمعالجة المعاملات. لكل محفظة في القائمة، يتم عرض المعرّف الذي عيّنته B2BINPAY، ونوع المحفظة (Merchant أو Enterprise)، وعملة المحفظة، والتسمية (إن تم تحديدها في B2BINPAY).

  للتفاصيل، راجع اختيار البلوك تشين لمحافظ Merchant وEnterprise.

• في القائمة المنسدلة Blockchain fee level، اختر Low أو Medium أو High.

• في القائمة المنسدلة Force blockchain (تنطبق على محافظ Merchant فقط)، اختر:

  • Yes — لاستخدام المعاملات على السلسلة فقط.
  • No — للسماح بـ المعاملات خارج السلسلة عند الإمكان.

• يعرض حقل Collect personal data القيمة No، ولا يمكن تغييرها لأن قاعدة السفر غير مدعومة حاليًا في تكامل B2BINPAY هذا.

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

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

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

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

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

• في القائمة المنسدلة Rates provider، اختر B2BINPAY باعتباره موفر الأسعار المفضل لمعالجة السحوبات مع التحويلات. للقيام بذلك، يجب أولًا إضافة B2BINPAY كموفر لسعر الصرف ضمن Currencies > Rates (للتفاصيل، راجع كيفية تكوين أسعار صرف العملات).

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

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

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

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

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

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

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