كيفية دمج PayRetailers

تعرّف على كيفية دمج PayRetailers مع B2CORE عبر PSS لتمكين الإيداعات والسحوبات بالعملات المدعومة

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

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

قبل متابعة التعليمات، يجب أن تكون قد سجّلت في PayRetailers ولديك حساب نشط. يمكنك الرجوع إلى وثائق PayRetailers الرسمية أو التواصل مع فريق الدعم لديهم إذا كانت لديك أي أسئلة.

العملات المدعومة

يوضح الجدول أدناه العملات المدعومة للإيداعات والسحوبات عبر PayRetailers:

Alpha code Name Supported for deposits Supported for withdrawals
ARS Argentine peso ✔ ✔
BRL Brazilian real ✔ ✔
CLP Chilean peso ✔ ✔
COP Colombian peso ✔ ✔
CRC Costa Rican colon ✔ ✘
USD US dollar ✔ ✔
MXN Mexican peso ✔ ✔
PEN Peruvian sol ✔ ✔
RWF Rwandan franc ✔ ✘
TZS Tanzanian shilling ✔ ✘
KES Kenyan shilling ✔ ✘
NGN Nigerian naira ✔ ✘
ZAR South African rand ✔ ✘

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

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

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

في المكتب الخلفي لـ B2CORE، انتقل إلى System > External connections.

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

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

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

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

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

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

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

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

  • في حقل API base URL، حدّد:

    • https://api.payretailers.com — لبيئة الإنتاج
    • https://api-sandbox.payretailers.com — لبيئة اختبار Sandbox
  • في حقل Shop ID، أدخل المعرّف الذي عيّنته PayRetailers لحسابك.

  • في حقل Secret key، حدّد المفتاح السري من حسابك في PayRetailers.

  • في حقل Subscription key، حدّد مفتاح الاشتراك من حسابك في PayRetailers.

توفّر PayRetailers جميع هذه التفاصيل أثناء عملية الانضمام، ويمكن العثور عليها أيضًا في قسم Shops في حسابك على PayRetailers.

PayRetailers — قائمة Shops

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في قسم Configuration الذي يظهر، املأ الحقول التالية:

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

    • Online — للمدفوعات عبر الإنترنت
    • Wallet — للمدفوعات عبر المحافظ الإلكترونية
    • Credit card — لتمويل الإيداعات بالبطاقات المصرفية
    • Cash — لإجراء المدفوعات النقدية عبر البنوك
  • في القائمة المنسدلة Country، اختر البلد الذي ستتم معالجة الدفع فيه.

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

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

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

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

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

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

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

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

بالنسبة إلى إيداعات PayRetailers، ترتبط العملات المستخدمة لمعالجة الإيداعات بالبلد المحدد في قسم Configuration للطريقة. يمكن أن يدعم بلد واحد أكثر من عملة إيداع واحدة:

  • الأرجنتين → ARS، USD
  • البرازيل → BRL، USD
  • تشيلي → CLP، USD
  • كولومبيا → COP، USD
  • كوستاريكا → CRC، USD
  • الإكوادور → USD
  • السلفادور → USD
  • المكسيك → MXN، USD
  • بنما → USD
  • بيرو → PEN، USD
  • رواندا → RWF، USD
  • تنزانيا → TZS، USD
  • كينيا → KES، USD
  • نيجيريا → NGN، USD
  • جنوب أفريقيا → ZAR، USD

على سبيل المثال، بالنسبة إلى البرازيل، يمكن معالجة الإيداعات بعملتي BRL وUSD، ويمكن إضافة كلتيهما في علامة التبويب PS Currencies.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في قسم Configuration، اختر قناة الدفع من القائمة المنسدلة Channel.

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

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

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

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

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

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

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

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

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

توضح الخريطة التالية البلد المرتبط بكل عملة سحب:

  • الأرجنتين → ARS
  • البرازيل → BRL
  • تشيلي → CLP
  • كولومبيا → COP
  • الإكوادور → USD
  • المكسيك → MXN
  • بيرو → PEN
طريقة سحب PayRetailers — علامة التبويب Settings

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

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

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

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

آخر تحديث في

في هذه الصفحة