بيئة اختبار بوابة الدفع Tap
موقع محلي لتجربة تكامل Tap Payments قبل ما ندخله في المتجر الفعلي. كل صفحة بتختبر مسار مختلف، وبتعرض الـ request والـ response الخام اللي راح ورجع من Tap.
الإعدادات الحاليةالمفتاح السري:
الرابط العام:
sk_test_XKo••••••••PjhJ (مفتاح الساندبوكس المنشور في دوكس Tap)الرابط العام:
https://eventiqueplanner.com (من PUBLIC_BASE_URL)src_all
صفحة الدفع المستضافة
ننشئ charge ونحوّل العميل لصفحة Tap اللي بتعرض كل وسائل الدفع المتاحة للحساب.
src_sa.madaمدى مباشرة
نفس المسار بس نجبر Tap تعرض مدى لوحدها — الوسيلة الأساسية في السوق السعودي.
Card SDK V2فورم كارت مدمج
فورم الكارت جوّه موقعنا، بيرجّع token نبعته للـ charges API. تجربة دفع من غير خروج من الموقع.
post.urlالـ Webhooks والتوقيع
استقبال إشعارات 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}من السيرفر للتأكيد — ما بنثقش في الـ redirect لوحده. - بالتوازي Tap بتبعت webhook على
https://eventiqueplanner.com/api/tap-webhookوإحنا نتحقق من توقيعه.
قبل ما تبدأ
- مفتاح Tap
- الافتراضي هو مفتاح الساندبوكس المنشور في الدوكس. لو عايز تختبر على حسابك، حط
TAP_SECRET_KEYفي.env.local. - الـ redirect
- https://eventiqueplanner.com/result
- الـ webhook
- https://eventiqueplanner.com/api/tap-webhook