الخطوة 1 من 5•~6 دقيقة

فتح حساب تجاري Paymob + KYC

Paymob Merchant Sign-Up

المستندات المطلوبة

السجل التجاري الساري (مش منتهي)

البطاقة الضريبية

بطاقة الرقم القومي للمالك (الوجهين)

IBAN باسم الشركة (مش حساب شخصي)

عقد إيجار / تمليك المقر (لو فيه)

رابط المتجر + لقطات شاشة

الخطوات

املأ بياناتك التجارية (اسم الشركة، الرقم الضريبي، المجال)
ارفع المستندات (PDF أو JPG، كل واحد < 5 MB)
أكّد الإيميل + رقم الموبايل بـ OTP
وقّع العقد إلكترونياً (DocuSign-style)
هتستلم إيميل بقبول/رفض الحساب خلال 2-5 أيام عمل

الخطوة 2 من 5•~5 دقيقة

استخراج API Keys + Integration IDs

لوحة Paymob Dashboard مع API Key + Integration IDs

بعد قبول الحساب، Paymob بيدّيك dashboard. محتاج تستخرج 4 قيم لربط CloudMarkit:

الـ 4 قيم

API Key (Secret): Dashboard → Profile → API Keys. سلسلة طويلة بـ Base64. لا تشاركها في أي مكان.
Public Key: Profile → API Keys → القسم العلوي. آمن في المتصفح.
Card Integration ID: Dashboard → Developers → Payment Integrations. رقم لـ "Visa/Mastercard" integration.
Wallet Integration ID: نفس المكان، رقم آخر لـ "Mobile Wallet" integration (Vodafone Cash + Orange Money + Etisalat Cash).

HMAC Secret (للـ webhook)

في Developers → Webhooks، اضغط Generate HMAC. هذا السر يستخدم للتحقق من توقيع الـ webhooks اللي بتيجي من Paymob (لمنع spoofing).

الخطوة 3 من 5•~4 دقيقة

تفعيل طرق الدفع المتاحة

صفحة تفعيل Cards + Wallets + Fawry + InstaPay

في Paymob Dashboard، فعّل اللي تحتاجه:

1

Cards (Visa / Mastercard / ميزة)

مفعّلة افتراضياً للـ accounts الجديدة. عمولة 2.7% + 2.50 ج.م لكل معاملة.

2

Mobile Wallets (Vodafone Cash / Orange Money / Etisalat Cash)

فعّل من Settings → Mobile Wallets. عمولة 1.5%. جزء كبير من الجمهور المصري بيفضّلها على الكروت.

3

Fawry Online (الدفع في أي منفذ Fawry)

للعملاء بدون بطاقات. العميل يختار "Fawry" → يحصل على رقم → يدفع كاش في أي outlet. عمولة 1.5% + 5 ج.م. مفعّل تلقائياً مع كل حساب جديد.

4

InstaPay

مدفوعات بنكية مباشرة لحظية. عمولة 0.5% فقط (الأرخص). فعّل من Settings → InstaPay(يحتاج موافقة Paymob إضافية — بياخد أسبوع).

الخطوة 4 من 5•~5 دقيقة

ربط Paymob بـ CloudMarkit

CloudMarkit dashboard - Paymob keys form

على CloudMarkit: لوحة التحكم → الإعدادات → Payments → Paymob

API Key: الصق الـ Secret (يخزّن في Vault)
Public Key: الصق الـ Public
Card Integration ID: الرقم
Wallet Integration ID: الرقم الآخر
HMAC Secret: سر الـ Webhook
Iframe ID: من Developers → Iframes في Paymob — اعمل iframe جديد + خد الـ ID
Mode: Live (مش Test) بعد ما تختبر
اضغط Save

Webhook URL

في Paymob Dashboard → Developers → Webhooks → +:

https://yourdomain.com/api/paymob/webhook

أو URL الـ Edge Function اللي CloudMarkit بيدّيك في الـ Integration page.

الخطوة 5 من 5•~4 دقيقة

اختبار معاملة كاملة قبل الإطلاق

1. شغّل Test Mode

في CloudMarkit → Paymob Settings → فعّل Test Mode. هذا يجعل الـ iframe يستخدم الـ test integration IDs اللي Paymob بيدّيك من الأول.

2. اعمل order تجريبي

افتح متجرك من جوال شخصي (مش admin)
أضف منتج للسلة → checkout → اختار Paymob
ضع بيانات Test Card من Paymob: 5123 4567 8901 2346 / CVV 099 / تاريخ 05/29
OTP: 123456
اضغط دفع

3. تحقق من 4 نقاط

الـ iframe فتح صح + المعاملة قبلت

العميل اتحوّل لـ /order-success

الـ order ظهر "مدفوع" في dashboard المتجر

الـ webhook وصل (شف pg_net._http_response في Supabase)

4. حوّل لـ Live Mode

بعد التأكد، أوقف Test Mode. الـ Live Integration IDs بيتفعّلوا. اعمل order حقيقي بـ 5 ج.م لتأكيد الإنتاج (Paymob ما عندوش حد أدنى).

جاهز تطبّق هذه الخطوة على متجرك؟

CloudMarkit يعمل لك ربط Paymob الكامل في دقيقة بدون كود.

ابدأ مجاناً 14 يوماً