انتقل إلى المحتوى الرئيسي

باي تابس (PayTabs)

باي تابس بوابة بطاقات تغطي مصر (EGY / EGP) والسعودية (SAU / SAR). يدفع المشترون على صفحة باي تابس المستضافة ثم يعودون إلى متجرك.

الربط​

الإعدادات ← المدفوعات ← باي تابس.

البياناتمطلوبةملاحظات
معرّف الملف (Profile ID)نعممعرّف رقمي لملف التاجر لدى باي تابس
مفتاح الخادم (Server Key)نعممفتاح مصادقة الخادم، ويُستخدم أيضًا للتحقق من الاستدعاءات
العملةنعمEGP أو SAR
المنطقةنعمEGY أو SAU
يجب أن تتطابق العملة والمنطقة معًا — ومع متجرك

EGY تقابل EGP، وSAU تقابل SAR. كما يجب أن تطابق العملة المضبوطة هنا عملة متجرك، وإلا فسيُخصم من المشترين بعملة مختلفة عن الأسعار التي رأوها. وبما أن عملة المتجر تُقفل بعد أول طلب، تأكد من ذلك قبل الإطلاق.

الإعدادات​

الإعدادالافتراضيالوظيفة
السماح للعملاء بحفظ البطاقاتغير مفعّليتيح للمشترين حفظ بطاقاتهم لدى باي تابس لتسريع الشراء لاحقًا
إرسال بريد تأكيد الدفعمفعّليرسل بريدًا للعميل عند نجاح الدفع
التنبيه عند فشل الدفع (عناوين بريد)فارغينبّه فريقك عند فشل عملية دفع
تعليم الطلبات كمدفوعة تلقائيًامفعّلغير مُفعَّل حاليًا — أي دفع مؤكَّد يجعل الطلب مدفوعًا على أي حال

مسار الدفع​

  1. يختار المشتري باي تابس ويؤكد الشراء.
  2. تُنشئ TakeTheme جلسة دفع موقّعة وتحوّله إليها.
  3. يدفع بالبطاقة.
  4. ترسل باي تابس إشعار IPN إلى TakeTheme، ويُنشأ الطلب هناك وهو مدفوع بالفعل.
  5. يعود المشتري إلى صفحة نجاح الطلب.
POST https://<your-api-host>/api/v1/payment/webhook/paytabs

التحقق من التوقيع إلزامي. كل جلسة دفع موقّعة بمفتاح الخادم، لذا يُرفض أي استدعاء غير موقّع أو غير مطابق بالرمز 403 ولا يُسجَّل شيء. ويُقبل الشكلان اللذان تستخدمهما باي تابس — إشعار IPN بصيغة JSON، واستدعاء العودة من المتصفح — ويُتحقق من كليهما.

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

الاسترداد​

يُسجَّل الاسترداد في TakeTheme فقط — ولا يصل أي طلب استرداد إلى باي تابس. نفّذه من لوحة تحكم باي تابس وسجّله هنا. راجع الاسترداد.

حل المشكلات​

الاستدعاءات تُرفض بالرمز 403. مفتاح الخادم المحفوظ لا يطابق المفتاح الذي توقّع به باي تابس. أعد كتابته كاملًا — فالقيم المقنّعة تُتجاهل عند الحفظ.

يُخصم من المشترين بعملة خاطئة. حقل currency في باي تابس مستقل عن عملة متجرك. اضبط الاثنين على القيمة نفسها.

البطاقات المحفوظة لا تظهر. فعّل السماح للعملاء بحفظ البطاقات هنا، وتأكد من تفعيل حفظ البطاقات في ملفك لدى باي تابس.

اقرأ أيضًا​