اربط بوابة دفع

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

قبل أن تبدأ

• يجب أن يسمح دورك بتغيير الإعدادات.
• حساب تاجر لدى إحدى البوابات المدعومة: Tap أو Stripe أو كريدي ماكس أو AFS أو بنك آخر على بوابة ماستركارد (MPGS) أو بنفت. اطلب من البوابة مفاتيح الاختبار إلى جانب المفاتيح الفعلية.
• لتجربة المسار دون أي بوابة، اختر بوابة تجريبية (بلا أموال حقيقية)، ولا شيء فيها لتعبئته.

اربط في وضع الاختبار

1. افتح الإعدادات ← الاتصالات وابحث عن بطاقة الدفع الإلكتروني.
2. شغّل مفتاح استخدام هذا الاتصال في البطاقة واختر بوابتك في المزوّد.
3. افتح أين تجد هذه البيانات واتبع الخطوات. يفتح زر افتح لوحة التحكم لوحة البوابة.
4. أبقِ الوضع على تجريبي (اختبار). تظهر شارة وضع الاختبار: بلا أموال حقيقية.
5. الصق بيانات الاختبار لبوابتك:
   • Tap: المفتاح السري (sk_test_…) والمفتاح العام (Publishable key).
   • Stripe: المفتاح السري (sk_test_…). وبعد الخطوة 6 الصق سر توقيع الإشعارات (whsec_…) تحت إعدادات متقدمة (اختيارية).
   • كريدي ماكس أو AFS أو بنك آخر على MPGS: معرّف التاجر (Merchant ID) (تبدأ حسابات الاختبار بـ TEST) وكلمة مرور الواجهة البرمجية والاسم الظاهر في صفحة الدفع. وتحت إعدادات متقدمة (اختيارية): سر إشعارات Webhook، وعنوان البوابة للبنوك الأخرى.
   • بنفت: معرّف Tranportal (الطرفية) وكلمة مرور Tranportal ومفتاح موارد الطرفية (32 حرفاً).
6. اضغط نسخ بجانب عنوان الإشعارات (Webhook) لنسخه في لوحة البوابة وأضف العنوان في لوحة تحكم البوابة (ومع بنفت أعطه لهم كعنوان الاستجابة إن طلبوه).
7. اضغط حفظ. تعرض البطاقة متصل ووضع الاختبار.
8. اضغط اختبار الاتصال وانتظر الاتصال يعمل.، مثل قبلت Tap بيانات الدخول.

جرّب دفعة

1. افتح حجزاً تجريبياً وأنشئ له رابط دفع بمبلغ صغير.
2. افتح الرابط. تعرض صفحة الدفع وضع الاختبار: هذه البوابة في وضع التجربة ولا تُنقل أموال حقيقية. استخدم بطاقات الاختبار الخاصة بالبوابة. ومع البوابة التجريبية تنجح البطاقة 4242 4242 4242 4242 وتُرفض 4000 0000 0000 0002.
3. ادفع ببطاقة اختبار. تعود إلى صفحة الدفع وتظهر نتأكد من دفعتك مع البنك… ثم تم استلام الدفعة. شكراً لك! مع الإيصال.
4. افتح الحجز: سُجّلت الدفعة بطريقة الدفع الإلكتروني وانخفض المتبقي.

انتقل إلى الوضع الفعلي

1. في بطاقة الدفع الإلكتروني غيّر الوضع إلى فعلي. تظهر شارة مدفوعات حقيقية.
2. استبدل مفاتيح الاختبار بالمفاتيح الفعلية (مع Tap وStripe تبدأ بـ sk_live_…).
3. تأكد من إضافة عنوان الإشعارات في الجانب الفعلي من لوحة البوابة أيضاً.
4. اضغط حفظ ثم اختبار الاتصال.

بعد ربط البوابة

• تستقبل روابط الدفع وروابط العربون وصفحة رحلة العميل المدفوعات عبر بوابتك، وتعرض صفحة الدفع البطاقات والمحافظ الظاهرة تحت يمكن للعملاء الدفع بـ.
• تُسجَّل كل دفعة في الحجز تلقائياً مع مرجع البوابة، فلا تسجّلها مرة أخرى.
• إذا أغلق العميل الصفحة قبل العودة، تؤكد البوابة الدفعة عبر عنوان الإشعارات، ويتحقق النظام أيضاً من البوابة كل بضع دقائق. ويُطلب من العميل عدم الدفع مرتين ما دام البنك يؤكد الدفعة.
• يُرسل الإيصال عبر القناة المضبوطة في الإعدادات ← التفضيلات ← إرسال إيصالات الدفع الإلكتروني عبر.
• يتم الرد إلى البطاقة من صفحة الحجز، ويعود المبلغ عبر البوابة نفسها.

إذا واجهتك مشكلة

• تنبيه تحت الاتصال يعمل.: تبدو هذه بيانات فعلية، لكن الاتصال مضبوط على الوضع التجريبي. (أو العكس). اجعل الوضع مطابقاً للمفاتيح واحفظ. تظهر النتيجة بلغة شاشتك، وتحتها ردّ البوابة: بكلمات البوابة نفسها كاملة (بالإنجليزية غالباً)، لتنقلها إلى دعم البوابة إن احتجت.

• لم ينجح الاتصال: لم تقبل Tap بيانات الدخول. راجع المفاتيح أو كلمة المرور ووضع التشغيل (تجريبي أو فعلي). (باسم بوابتك)، وتحتها مثلاً … rejected the credentials: المفاتيح خاطئة، أو هي مفاتيح اختبار في الوضع الفعلي.

• لم ينجح الاتصال: …: بعض البيانات ناقصة أو غير صحيحة. انظر ردّ البوابة أدناه. وتحتها مثلاً:

  • Add the merchant ID and API password first. أو Add the tranportal ID and password first.: بيانات ناقصة، فاملأها واحفظ.
  • The BENEFIT terminal resource key must be 32 characters: مفتاح موارد الطرفية لا يتكون من 32 حرفاً.

• لم ينجح الاتصال: تعذّر الوصول إلى …. تحقق من عنوان البوابة وحاول مجدداً. وتحتها مثلاً Could not reach … أو … did not answer in time: راجع عنوان البوابة تحت إعدادات متقدمة (اختيارية) أو حاول لاحقاً.

• لم ينجح الاتصال: رفضت … اختبار الاتصال.: اقرأ ردّ البوابة وصحّح ما يذكره، أو أرسله إلى دعم البوابة.

• يجب أن يكون عنوان بوابة الدفع عنواناً عاماً على الإنترنت أو يجب أن يبدأ عنوان بوابة الدفع بـ https:// عند الحفظ: انسخ العنوان كما هو من البوابة.

• احفظ التغييرات أولاً ثم اختبر الاتصال: اضغط حفظ قبل اختبار الاتصال.