كيفية دمج TopChange Pay
تعرّف على كيفية دمج TopChange Pay مع B2CORE عبر PSS لتمكين الإيداعات والسحوبات، بما في ذلك الإعداد وتكوين الطريقة والتحقق
يمكن ربط TopChange Pay (TC Pay) بـ B2CORE عبر PSS، مع دعم الإيداعات والسحوبات بعملات USD وIRR وEUR وAED وTRY وCNY وRUB وUSDT.
اتبع التعليمات أدناه لتكوين اتصالات TC Pay وإعداد طريقتَي الإيداع والسحب في المكتب الخلفي لـ B2CORE. تتوافق هذه التعليمات مع الإجراء العام لإضافة طرق لأنظمة الدفع المدعومة من PSS، لكنها تتضمن تفاصيل خاصة بـ TC Pay.
قبل متابعة التعليمات، يجب أن تكون قد سجلت في TC Pay ولديك حساب نشط. يمكنك الرجوع إلى وثائق TC Pay الرسمية أو التواصل مع فريق الدعم لديهم إذا كانت لديك أي أسئلة.
تكوين الاتصالات بـ TopChange Pay
إذا كنت تخطط لاستخدام TC Pay لكلٍّ من الإيداعات والسحوبات، فيجب عليك تكوين اتصالين منفصلين: أحدهما للإيداعات والآخر للسحوبات.
لتكوين اتصال بـ TC Pay:
في المكتب الخلفي لـ B2CORE، انتقل إلى System > External connections.
انقر على +Create في الزاوية العلوية اليمنى من الصفحة.
في صفحة Create connection، املأ الحقول التالية:
-
في حقل Name، أدخل اسمًا للاتصال. يجب أن يكون الاسم فريدًا، ولا يجوز أن يحتوي إلا على أحرف لاتينية وأرقام وشرطات وشرطات سفلية (على سبيل المثال،
Deposits_TC_PayأوWithdrawals_TC_Pay). -
في حقل Caption، أدخل تسمية توضيحية سيتم تطبيقها على الاتصال في المكتب الخلفي.
-
في القائمة المنسدلة Provider، اختر:
- PaymentSystemDeposit — لإضافة اتصال سيُستخدم لطريقة إيداع.
- PaymentSystemWithdrawal — لإضافة اتصال سيُستخدم لطريقة سحب.
في القائمة المنسدلة Driver التي تظهر، اختر TC Pay.
في قسم Credentials الذي يظهر، كوّن الإعدادات الخاصة بـ TC Pay:
-
في حقل API base URL، حدّد
https://pg.topayment.net. -
في حقل Merchant ID، أدخل معرّف التاجر المعيّن لحسابك من قِبل TC Pay.
-
أنشئ زوجًا من مفاتيح RSA الخاصة والعامة باستخدام TC RSA Key Generator.
يمكنك الرجوع إلى وثائق TC Pay الرسمية أو التواصل مع فريق الدعم لديهم إذا كانت لديك أي أسئلة.
-
في حقل Private RSA key، حدّد المفتاح الخاص، وتأكد من تحديد المفتاح العام المقابل في حساب TC Pay الخاص بك.
انقر على Save لإنشاء الاتصال.
سيظهر اتصال TC Pay في قائمة الاتصالات الخارجية.
تحقق من حالة الاتصال.
إذا كان الاتصال غير نشط (تظهر No في عمود Enabled)، فانقر على زر Edit لفتح تفاصيل الاتصال واضبط القائمة المنسدلة Enabled على Yes.
انقر على Save لتطبيق التغييرات.
إذا كنت بحاجة إلى دعم كلٍّ من الإيداعات والسحوبات عبر TC Pay، فاتبع التعليمات نفسها لإنشاء اتصال جديد للعملية الأخرى.
إضافة طريقة إيداع عبر TopChange Pay
لإضافة وإعداد طريقة لتنفيذ الإيداعات عبر TC Pay:
في المكتب الخلفي لـ B2CORE، انتقل إلى System > Deposit system > Deposit methods.
انقر على +Create في الزاوية العلوية اليمنى من الصفحة.
في صفحة Create a deposit method، املأ الحقول التالية:
- في حقل Name، أدخل اسمًا للطريقة. يجب أن يكون الاسم فريدًا، ولا يجوز أن يحتوي إلا على أحرف لاتينية وأرقام وشرطات وشرطات سفلية.
- في حقل Caption، أدخل تسمية توضيحية للطريقة. سيتم تعيين هذه التسمية للطريقة في المكتب الخلفي، وستكون مرئية للعملاء في واجهة B2CORE.
- في القائمة المنسدلة Provider، اختر PaymentSystemDeposit.
بعد اختيار PaymentSystemDeposit، تظهر الحقول التالية:
- في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون الإيداعات عبر TC Pay متاحة للحسابات المقومة بالعملات المحددة.
- في القائمة المنسدلة Driver، اختر TC Pay.
- في القائمة المنسدلة Connection، اختر اتصال TC Pay المُكوَّن مسبقًا للإيداعات.
في قسم Configuration، املأ Terminal ID المرتبط بحساب التاجر الخاص بك في TC Pay. يضمن ذلك توجيه المعاملات بشكل صحيح وإسنادها إلى محطة الدفع المناسبة. لاحظ أن العملة المسموح بها تُحدَّد بواسطة Terminal ID المحدد.
انقر على Save لإنشاء طريقة الإيداع.
ستظهر طريقة إيداع TC Pay في قائمة طرق الإيداع.
انقر على Edit لإدخال تفاصيل الطريقة وإكمال الحقول التالية:
-
في علامة التبويب Settings، استخدم القائمة المنسدلة Group لاختيار مجموعة واحدة أو أكثر ينبغي تضمين الطريقة فيها.
-
في حقل Icon، حدّد عنوان URL لصورة ستُعرض كأيقونة لطريقة الإيداع في واجهة B2CORE.
-
تحقق من حالة الطريقة.
إذا كانت الطريقة غير نشطة (تظهر No في حقل Enabled)، فقم بتنشيطها بتعيين القائمة المنسدلة Enabled إلى Yes.
-
في علامة التبويب PS Currencies، أضف العملة المطلوبة. لتمكين الطريقة من معالجة الإيداعات بعملة محددة، تأكد من إضافتها في علامة التبويب هذه.
بالنسبة إلى TC Pay، يمكن لكل طريقة إيداع دعم عملة واحدة فقط ضمن علامة التبويب PS Currencies. لذلك، إذا كنت تريد السماح لعملائك بالإيداع بجميع العملات المدعومة (USD وIRR وEUR وAED وTRY وCNY وRUB وUSDT)، فيجب عليك إنشاء ثماني طرق إيداع منفصلة — واحدة لكل عملة، تتوافق مع Terminal ID المحدد.
- عند الحاجة، كوّن العمولات للطريقة في علامة التبويب Commissions (للتفاصيل، راجع كيفية تكوين العمولات لطرق الإيداع والسحب).

انقر على Test configuration للتحقق من إعدادات اتصال طريقة الإيداع.
ستظهر نتيجة الاختبار على الصفحة.
بعد التحقق من صحة التكوين بنجاح، انقر على Save.
أصبحت طريقة إيداع TC Pay مُكوَّنة الآن في المكتب الخلفي لـ B2CORE.
إضافة طريقة سحب عبر TopChange Pay
لإضافة وإعداد طريقة لتنفيذ السحوبات عبر TC Pay:
في المكتب الخلفي لـ B2CORE، انتقل إلى System > Payout system > Payout methods.
انقر على +Create في الزاوية العلوية اليمنى من الصفحة.
في صفحة Create a payout method، املأ الحقول التالية:
- في حقل Name، أدخل اسمًا للطريقة. يجب أن يكون الاسم فريدًا، ولا يجوز أن يحتوي إلا على أحرف لاتينية وأرقام وشرطات وشرطات سفلية.
- في حقل Caption، أدخل تسمية توضيحية للطريقة. سيتم تعيين هذه التسمية للطريقة في المكتب الخلفي، وستكون مرئية للعملاء في واجهة B2CORE.
- في القائمة المنسدلة Provider، اختر PaymentSystemWithdrawal.
بعد اختيار PaymentSystemWithdrawal، تظهر الحقول التالية:
- في القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون السحوبات عبر TC Pay متاحة من الحسابات المقومة بالعملات المحددة.
- في القائمة المنسدلة Driver، اختر TC Pay.
- في القائمة المنسدلة Connection، اختر اتصال TC Pay المُكوَّن مسبقًا للسحوبات.
في قسم Configuration، املأ Terminal ID المرتبط بحساب التاجر الخاص بك في TC Pay. يضمن ذلك توجيه المعاملات بشكل صحيح وإسنادها إلى محطة الدفع المناسبة. لاحظ أن العملة المسموح بها تُحدَّد بواسطة Terminal ID المحدد.
انقر على Save لإنشاء طريقة السحب.
ستظهر طريقة سحب TC Pay في قائمة طرق السحب.
انقر على Edit لإدخال تفاصيل الطريقة وإكمال الحقول التالية:
-
في علامة التبويب Settings، استخدم القائمة المنسدلة Group لاختيار مجموعة واحدة أو أكثر ينبغي تضمين الطريقة فيها.
-
في حقل Icon، حدّد عنوان URL لصورة ستُعرض كأيقونة لطريقة السحب في واجهة B2CORE.
-
تحقق من حالة الطريقة.
إذا كانت الطريقة غير نشطة (تظهر No في حقل Enabled)، فقم بتنشيطها بتعيين القائمة المنسدلة Enabled إلى Yes.
-
في علامة التبويب PS Currencies، أضف العملة المطلوبة. لتمكين الطريقة من معالجة السحوبات بعملة محددة، تأكد من إضافتها في علامة التبويب هذه.
بالنسبة إلى TC Pay، يمكن لكل طريقة سحب دعم عملة واحدة فقط ضمن علامة التبويب PS Currencies. لذلك، إذا كنت تريد السماح لعملائك بالسحب بجميع العملات المدعومة (USD وIRR وEUR وAED وTRY وCNY وRUB وUSDT)، فيجب عليك إنشاء ثماني طرق سحب منفصلة — واحدة لكل عملة، تتوافق مع Terminal ID المحدد.
- عند الحاجة، كوّن العمولات للطريقة في علامة التبويب Commissions (للتفاصيل، راجع كيفية تكوين العمولات لطرق الإيداع والسحب).

انقر على Test configuration للتحقق من إعدادات اتصال طريقة السحب.
ستظهر نتيجة الاختبار على الصفحة.
بعد التحقق من صحة التكوين بنجاح، انقر على Save.
أصبحت طريقة سحب TC Pay مُكوَّنة الآن في المكتب الخلفي لـ B2CORE.
آخر تحديث في