كيفية دمج 1-2-Pay
تعرّف على كيفية دمج 1-2-Pay مع B2CORE عبر PSS، بما في ذلك تكوين الاتصالات وإضافة طرق الإيداع والسحب بالعملات المدعومة
يمكن ربط 1-2-Pay بـ B2CORE من خلال PSS. وهو يدعم الإيداعات عبر رموز QR وعمليات السحب إلى الحسابات المصرفية، والتي تتم معالجتها بعملة THB.
اتبع الإرشادات أدناه لتكوين اتصالات 1-2-Pay وإعداد طريقتَي الإيداع والسحب في المكتب الخلفي لـ B2CORE. تتوافق هذه الإرشادات مع الإجراء العام لإضافة طرق لأنظمة الدفع التي يدعمها PSS، لكنها تتضمن تفاصيل خاصة بـ 1-2-Pay.
قبل متابعة الإرشادات، يجب أن تكون قد سجلت في 1-2-Pay ولديك حساب نشط.
يجب طلب جميع التفاصيل المطلوبة لتكوين الاتصالات بـ 1-2-Pay، بما في ذلك عنوان URL الأساسي لبدء API وعنوان URL الأساسي لمزامنة API وبيانات الاعتماد الأخرى، من دعم 1-2-Pay.
تكوين الاتصالات بـ 1-2-Pay
إذا كنت تخطط لاستخدام 1-2-Pay لكل من الإيداعات وعمليات السحب، فيجب عليك تكوين اتصالين منفصلين: أحدهما للإيداعات والآخر لعمليات السحب.
لتكوين اتصال بـ 1-2-Pay:
في المكتب الخلفي لـ B2CORE، انتقل إلى System > External connections.
انقر على +Create في الزاوية العلوية اليمنى من الصفحة.
في صفحة Create connection، املأ الحقول التالية:
-
في حقل Name، أدخل اسمًا للاتصال. يجب أن يكون الاسم فريدًا ويمكن أن يحتوي فقط على أحرف لاتينية وأرقام وشرطات وشرطات سفلية (على سبيل المثال،
Deposits_1-2-PayأوWithdrawals_1-2-Pay). -
في حقل Caption، أدخل تسمية توضيحية سيتم تطبيقها على الاتصال في المكتب الخلفي.
-
من القائمة المنسدلة Provider، اختر:
- PaymentSystemDeposit — لإضافة اتصال سيُستخدم لطريقة إيداع.
- PaymentSystemWithdrawal — لإضافة اتصال سيُستخدم لطريقة سحب.
من القائمة المنسدلة Driver التي تظهر، اختر 1-2-PAY.
في قسم Credentials الذي يظهر، قم بتكوين الإعدادات الخاصة بـ 1-2-Pay:
-
من القائمة المنسدلة Sandbox، اختر:
- Yes — لبيئة اختبار Sandbox
- No — لبيئة الإنتاج
-
في حقل API start base URL، حدد عنوان URL الأساسي لإنشاء طلبات الدفع، الذي توفره 1-2-Pay.
-
في حقل API sync base URL، حدد عنوان URL الأساسي الذي يستخدمه B2CORE لتلقي عمليات الاستدعاء والتحقق منها، والذي توفره أيضًا 1-2-Pay.
نقاط مهمة حول عناوين URL
-
يُعد API start base URL وAPI sync base URL نقطتي نهاية مختلفتين، ويجب طلبهما مباشرةً من 1-2-Pay.
-
تأكد من استخدام HTTPS دائمًا، على سبيل المثال:
- API start base URL:
https://api.example.com/ - API sync base URL:
https://inquiry.example.com/
- API start base URL:
-
توفر 1-2-Pay عناوين URL محددة لكل بيئة. تختلف عناوين URL الخاصة بـ Sandbox عن تلك الخاصة بالإنتاج، لذا تأكد من طلب المجموعتين واستخدام العناوين المناسبة لتكوينك.
- في حقل Channel، أدخل القناة التي خصصتها 1-2-Pay لعملية التكامل الخاصة بك.
- في حقل Partner code، أدخل رمز الشريك المخصص لشركتك من قبل 1-2-Pay.
- في حقل Auth key، أدخل مفتاح API لتوقيع الطلبات، الذي توفره 1-2-Pay.
انقر على Save لإنشاء الاتصال.
سيظهر اتصال 1-2-Pay في قائمة الاتصالات الخارجية.
تحقق من حالة الاتصال.
إذا كان الاتصال غير نشط (تظهر No في عمود Enabled)، فانقر على زر Edit لفتح تفاصيل الاتصال واضبط القائمة المنسدلة Enabled على Yes.
انقر على Save لتطبيق التغييرات.
إذا كنت بحاجة إلى دعم كل من الإيداعات وعمليات السحب عبر 1-2-Pay، فاتبع الإرشادات نفسها لإنشاء اتصال جديد للعملية الأخرى.
إضافة طريقة إيداع عبر 1-2-Pay
لإضافة وإعداد طريقة لإجراء الإيداعات عبر 1-2-Pay:
في المكتب الخلفي لـ B2CORE، انتقل إلى System > Deposit system > Deposit methods.
انقر على +Create في الزاوية العلوية اليمنى من الصفحة.
في صفحة Create a deposit method، املأ الحقول التالية:
- في حقل Name، أدخل اسمًا للطريقة. يجب أن يكون الاسم فريدًا ويمكن أن يحتوي فقط على أحرف لاتينية وأرقام وشرطات وشرطات سفلية.
- في حقل Caption، أدخل تسمية توضيحية للطريقة. سيتم تعيين هذه التسمية للطريقة في المكتب الخلفي وستكون مرئية للعملاء في واجهة B2CORE.
- من القائمة المنسدلة Provider، اختر PaymentSystemDeposit.
بعد اختيار PaymentSystemDeposit، تظهر الحقول التالية:
- من القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون الإيداعات عبر 1-2-Pay متاحة للحسابات المقومة بالعملات المختارة. يجب تكوين أسعار التحويل إلى
THBلهذه العملات. - من القائمة المنسدلة Driver، اختر 1-2-PAY.
- من القائمة المنسدلة Connection، اختر اتصال 1-2-Pay الذي تم تكوينه مسبقًا.
تخطَّ قسم Configuration، إذ لا توجد إعدادات مطلوبة لطريقة الإيداع 1-2-Pay.
انقر على Save لإنشاء طريقة الإيداع.
ستظهر طريقة الإيداع 1-2-Pay في قائمة طرق الإيداع.
انقر على Edit للدخول إلى تفاصيل الطريقة وأكمل الحقول التالية:
-
في علامة التبويب Settings، استخدم القائمة المنسدلة Group لاختيار مجموعة واحدة أو أكثر يجب تضمين الطريقة فيها.
-
في حقل Icon، حدد
paymethod-12payلعرض الأيقونة المحددة مسبقًا لطريقة إيداع 1-2-Pay في واجهة B2CORE. لاستخدام أيقونة مخصصة، حدد عنوان URL للصورة المراد عرضها. -
تحقق من حالة الطريقة.
إذا كانت الطريقة غير نشطة (تظهر No في حقل Enabled)، ففعّلها عبر ضبط القائمة المنسدلة Enabled على Yes.
-
في علامة التبويب PS Currencies، أضف
THB. -
عند الحاجة، قم بتكوين العمولات للطريقة في علامة التبويب Commissions (للتفاصيل، راجع كيفية تكوين العمولات لطرق الإيداع والسحب).

انقر على Test configuration للتحقق من إعدادات اتصال طريقة الإيداع.
ستظهر نتيجة الاختبار على الصفحة.
بعد التحقق من صحة التكوين بنجاح، انقر على Save.
تم الآن تكوين طريقة إيداع 1-2-Pay في المكتب الخلفي لـ B2CORE.
إضافة طريقة سحب عبر 1-2-Pay
لإضافة وإعداد طريقة لإجراء عمليات السحب عبر 1-2-Pay:
في المكتب الخلفي لـ B2CORE، انتقل إلى System > Payout system > Payout methods.
انقر على +Create في الزاوية العلوية اليمنى من الصفحة.
في صفحة Create a payout method، املأ الحقول التالية:
- في حقل Name، أدخل اسمًا للطريقة. يجب أن يكون الاسم فريدًا ويمكن أن يحتوي فقط على أحرف لاتينية وأرقام وشرطات وشرطات سفلية.
- في حقل Caption، أدخل تسمية توضيحية للطريقة. سيتم تعيين هذه التسمية للطريقة في المكتب الخلفي وستكون مرئية للعملاء في واجهة B2CORE.
- من القائمة المنسدلة Provider، اختر PaymentSystemWithdrawal.
بعد اختيار PaymentSystemWithdrawal، تظهر الحقول التالية:
- من القائمة المنسدلة Available account currencies، اختر عملة واحدة أو أكثر. ستكون عمليات السحب عبر 1-2-Pay متاحة من الحسابات المقومة بالعملات المختارة. يجب تكوين أسعار التحويل إلى
THBلهذه العملات. - من القائمة المنسدلة Driver، اختر 1-2-PAY.
- من القائمة المنسدلة Connection، اختر اتصال 1-2-Pay لعمليات السحب الذي تم تكوينه مسبقًا.
تخطَّ قسم Configuration، إذ لا توجد إعدادات مطلوبة لطريقة السحب 1-2-Pay.
انقر على Save لإنشاء طريقة السحب.
ستظهر طريقة السحب 1-2-Pay في قائمة طرق السحب.
انقر على Edit للدخول إلى تفاصيل الطريقة وأكمل الحقول التالية:
-
في علامة التبويب Settings، استخدم القائمة المنسدلة Group لاختيار مجموعة واحدة أو أكثر يجب تضمين الطريقة فيها.
-
في حقل Icon، حدد
paymethod-12payلعرض الأيقونة المحددة مسبقًا لطريقة سحب 1-2-Pay في واجهة B2CORE. لاستخدام أيقونة مخصصة، حدد عنوان URL للصورة المراد عرضها. -
تحقق من حالة الطريقة.
إذا كانت الطريقة غير نشطة (تظهر No في حقل Enabled)، ففعّلها عبر ضبط القائمة المنسدلة Enabled على Yes.
-
في علامة التبويب PS Currencies، أضف
THB. -
عند الحاجة، قم بتكوين العمولات للطريقة في علامة التبويب Commissions (للتفاصيل، راجع كيفية تكوين العمولات لطرق الإيداع والسحب).

انقر على Test configuration للتحقق من إعدادات اتصال طريقة السحب.
ستظهر نتيجة الاختبار على الصفحة.
بعد التحقق من صحة التكوين بنجاح، انقر على Save.
تم الآن تكوين طريقة سحب 1-2-Pay في المكتب الخلفي لـ B2CORE.
إعداد خطافات الويب في 1-2-Pay
لتلقي تحديثات الحالة للإيداعات وعمليات السحب في B2CORE، يجب إعداد خطافات ويب للإشعارات من جانب 1-2-Pay.
نسخ عناوين URL لخطافات الويب من المكتب الخلفي لـ B2CORE
ستحتاج إلى عناوين URL منفصلة لخطافات الويب لكل من طريقتَي الإيداع والسحب.
في المكتب الخلفي لـ B2CORE، انتقل إلى:
- System > Deposit system > Deposit methods
- System > Payout system > Payout methods
اعثر على طريقة إيداع أو سحب 1-2-Pay التي تم تكوينها وانقر على Edit لفتح تفاصيلها.
انتقل إلى علامة التبويب Webhooks.
انسخ عنوان URL المعروض في حقل Notification URL.
تزويد 1-2-Pay بعناوين URL
أرسل عناوين URL لخطافات الويب المنسوخة (لكل من الإيداعات وعمليات السحب) إلى دعم 1-2-Pay لتكوينها من جانبهم.
آخر تحديث في