01
أنشئ
POST /payment/create
أبعت المبلغ ورقم محفظة العميل. رجعلك كود مرجع.
الشكل توضيحي. للتجربة الفعلية سجّل حساب واعمل أول دفعة من الكونسول.
ابدأ الآنليه مِحوَر
بوابة الدفع هي أول نقطة بيتقابل فيها عميلك مع فلوسه: من لحظة ما يضغط «ادفع» لحد ما الرصيد يوصل لحسابك. في مصر، أغلب المشترين بيدفعوا من محافظهم الرقمية — فودافون كاش، أورنج كاش، اتصالات كاش — فالربط مع بوابة دفع مظبوط معناه إنك تدعم دي المحافظ كلها من غير ما تضيّع عميل في الطريق.
المشكلة إن الربط المباشر مع كل شبكة على حدة معناه تلات تكاملات منفصلة، وكل واحدة ليها الـ API بتاعها ورسومها وحالات الخطأ بتاعتها. مع مِحوَر، بتكتب تكامل واحد — endpoint واحد، توثيق واحد، وwebhook موقّع واحد — وتوصل بيه لتلات شبكة دفع من أول يوم. العميل بيختار محفظته، يوافق على موبايله بالكود السري، والعملية بتسجّل بورقم مرجعي واحد بس.
بعدها، التسوية بتحصل بالجنيه المصري مباشرة على رصيدك من غير انتظار، وكل عملية بتتسجّل بقيدين محاسبيين متقابلين فما ينفعش الرصيد يخالف سجل الحركات. والـ API نفسه بيشتغل بالتوقيع HMAC-SHA256 ومنع تكرار الخصم على مستوى قاعدة البيانات، فما فيش عملية بتتنفّذ مرتين لو الشبكة رجعت نفس الإشعار مرتين.
دورة العملية
العميل يدفع من محفظته مباشرة على موبايله. مفيش صفحة وسط، ولا تفاصيل بطاقة، ولا step بتضيع.
POST /payment/create
أبعت المبلغ ورقم محفظة العميل. رجعلك كود مرجع.
client approves
العميل يطلب الكود من محفظته ويدخل الرقم السري.
POST /payment/confirm
اسأل الشبكة — ولو تأخرت، مِحوَر بيسأل عنك. الرصيد بيتضاف فوراً.
webhook
إشعار موقّع على خادمك. أقل من ثانية.
الشبكات
vf_cash
curl -X POST "https://mihwar.cc/api/v2/payment/create" \ -H "Authorization: pk_live_…" \ -H "Content-Type: application/json" \ -d '{ "order_id": "ORD-10023", "number": "01012345678", "amount": 150, "method": "vf_cash", "webhook_url": "https://yourstore.com/hooks" }' // 200 · MH-2001 { "reference": "SH849204821", "status": "pending", "message": "اطلب *9*1# خلال دقيقة" }
الـ API
كل رد موقّع، وكل عملية مضمونة عدم التكرار، وكل كود خطأ ليه معنى محدد تقد تتصرف بيه برمجياً.
اقرأ توثيق الـ APIالطلب نفسه ما بيتنفّذش مرتين. القيد في قاعدة البيانات، مش في الكود.
كل رد وكل إشعار موقّع. والمقارنة ثابتة الزمن — مفيش timing attack.
كل جنيه بيتقفل عليه قيدين. الرصيد ما ينفعش يخالف الدفتر.
الطابع الزمني والمعرّف الفريد بيمنعوا تنفيذ نفس الإشعار مرتين.
لكل حالة كود محدد، تعرف تصرّف إزاي برمجياً.
المفتاح السري ما يوصلش المتصفح أبداً، وبيطلع مرة واحدة بس.
الأسعار
الاستلام مجاني بالكامل — المبلغ كله بيتضاف لرصيدك. الرسوم على السحب بس. لا رسوم شهرية، لا رسوم إعداد، ولا حد أدنى للاشتراك.
الباقة
الأساسية
على الاستلام — الرسوم على السحب فقط، وبدون رسوم شهرية
الأسئلة الشائعة
بوابة الدفع هي الخدمة اللي بتوصل موقعك أو تطبيقك بنظام الدفع: بتستقبل طلب العملية، بتخاطب شبكة الدفع، وترجعلك النتيجة موقّعة. مع مِحوَر، بوابة واحدة بتوصل فودافون كاش وأورنج كاش واتصالات كاش.
بوابة دفع المحافظ بتشتغل على أرصدة المحفظة الرقمية مباشرة من غير بطاقة ولا 3D Secure — الموافقة بتتم على موبايل العميل بالكود السري. ده بيبسط التكامل وبيقلل تكلفة العملية مقارنة بقبول البطاقات.
سجّل حساب، خد الـ API key من الكونسول، وابعت POST لـ /payment/create بالمحفظة والمبلغ. العميل بيوافق على موبايله، وبعدها POST لـ /payment/confirm أو استنى الـ webhook الموقّع. التكامل كامل بيدقق في عشر دقائق.
الاستلام على مِحوَر مجاني 0% — المبلغ كله بيتضاف لرصيدك. الرسوم على السحب بس، ومافيش رسوم شهرية ولا رسوم إعداد ولا حد أدنى للاشتراك.
فوري. أول ما العملية تأكّد، الرصيد بيتضاف على حسابك في المنصة وتقدر تسحبه على محفظتك وقت ما تحب.
مفيش داعي للقلق: بعد مهلة موافقة العميل (60 ثانية) بتفتح نافذة تسوية 10 دقايق تأكّد فيها في أي وقت — ولو ما أكدتش، مِحوَر بيسأل الشبكة عنك كل دقيقة ويصفّي العملية لوحده، والرصيد والـ webhook بيحصلوا عادي. بتقفل بس بعد الـ10 دقايق بـ MH-4032.
كل رد وكل webhook موقّع HMAC-SHA256، وكل عملية ليها مرجع فريد ومنع تكرار على مستوى قاعدة البيانات، وكل جنيه مقفول بقيدين محاسبيين متقابلين.