بيئة اختبار بوابة الدفع Tap
بيئة مخصّصة لتجربة تكامل Tap Payments قبل اعتماده في المتجر الفعلي. تختبر كل صفحة مسارًا مختلفًا، وتعرض الطلب والاستجابة الخام المتبادلَين مع Tap.
الإعدادات الساريةالمفتاح السري:
الرابط العام:
sk_test_XKo••••••••PjhJ — مفتاح البيئة التجريبية المنشور في وثائق Tapالرابط العام:
https://eventiqueplanner.com (من PUBLIC_BASE_URL)src_all
صفحة الدفع المستضافة
إنشاء عملية دفع وتحويل العميل إلى صفحة Tap التي تعرض جميع وسائل الدفع المفعّلة على الحساب.
src_sa.madaمدى مباشرةً
المسار ذاته مع حصر وسيلة الدفع في مدى وحدها، وهي الوسيلة الأوسع انتشارًا في السوق السعودي.
Card SDK V2نموذج بطاقة مدمج
نموذج إدخال البطاقة داخل الموقع نفسه، يُنتج رمزًا مؤقتًا (token) يُرسل إلى واجهة العمليات.
post.urlالإشعارات والتوقيع
استقبال إشعارات Tap والتحقق من توقيع hashstring بخوارزمية HMAC-SHA256، مع محاكاة تعمل محليًا.
sandboxبطاقات الاختبار
أرقام بطاقات مدى وفيزا وماستركارد الرسمية، وجدول تواريخ الانتهاء التي تتحكم في نتيجة العملية.
مسار العملية
- ترسل الواجهة بيانات الطلب إلى
POST /api/chargesعلى خادمنا. - يبني الخادم جسم الطلب ويستدعي
POST https://api.tap.company/v2/chargesبالمفتاح السري، الذي لا يصل إلى المتصفح إطلاقًا. - تعيد Tap الحالة
INITIATEDمعtransaction.url، فيُحوَّل العميل إليها. - بعد إتمام الدفع تُعيد Tap العميل إلى
https://eventiqueplanner.com/result?tap_id=chg_xxx. - تستدعي صفحة النتيجة
GET /v2/charges/{tap_id}من الخادم للتأكيد؛ ولا يُعتمد على معطيات التحويل وحدها. - بالتوازي تُرسل Tap إشعارًا إلى
https://eventiqueplanner.com/api/tap-webhookويجري التحقق من توقيعه.
قبل البدء
- مفتاح Tap
- المفتاح الافتراضي هو مفتاح البيئة التجريبية المنشور في وثائق Tap. لاستخدام حسابك الخاص، أضف
TAP_SECRET_KEYإلى.env.local. - رابط العودة
- https://eventiqueplanner.com/result
- رابط الإشعارات
- https://eventiqueplanner.com/api/tap-webhook