شارك المقالة
شرح Paymob في Postman: إنشاء Intention والتحقق من Callback

شرح Paymob في Postman: إنشاء Intention والتحقق من Callback

راجع تكامل Paymob في Postman ببيئة اختبار، وافهم Intention والمفاتيح والمبلغ والتحقق من HMAC دون نقل الأسرار إلى تطبيق Flutter.

شرح Paymob في Postman يساعدك على فهم ما يرسله خادمك قبل ربط Flutter، لكنه لا يعني نقل طلبات التاجر السرية إلى الهاتف. هدف هذا الدرس إعداد Collection اختبارية ومراجعة إنشاء جلسة الدفع والنتيجة، مع التمييز بين المسار القديم القائم على tokens والمسار الذي يعرّفه التوثيق الحالي باسم Intention.

اختر المسار والمنطقة قبل نسخ الطلب

راجع لوحة حسابك وتوثيق التكامل المفعّل. في مسار Intention الموثق يكون إنشاء العملية على الخادم مع Authorization من نوع Token يليه Secret Key. لا تستبدل ذلك بـBearer من مقال لخدمة أخرى، ولا تستخدم Public Key مكان Secret Key. المنطقة تحدد base URL، ووسائل الدفع وIntegration IDs يجب أن تنتمي للحساب والبيئة نفسها.

كانت الصور القديمة تعرض auth/tokens وecommerce/orders وpayment_keys ثم iframe. قد تحتاج هذه المسارات عند صيانة تكامل قائم وفق عقده، لكنها ليست خطوات تُضاف تلقائيًا قبل Create Intention. خلط الجيلين ينتج رسائل رفض أو تدفقًا يصعب اختباره؛ دوّن النسخة والمنطقة التي تعمل عليها لكل Collection بدل تجميع طلبات مختلفة بلا تمييز.

حماية بيانات Postman

استخدم متغيرات محلية أو Vault للأسرار، ولا تحفظ مفتاحًا فعليًا داخل جسم طلب ثابت أو لقطة شاشة أو مستودع عام. راجع ما يُصدّر عند مشاركة Collection أو Environment. روابط الفحص ومحتوى callback قد يحملان بيانات عميل، لذلك لا ترسل بيانات تشغيل حقيقية إلى موقع عرض Webhooks عام دون حاجة وسياسة واضحة.

اضبط PAYMOB_BASE_URL وPAYMOB_SECRET_KEY وIntegration ID تجريبيًا من حساب الاختبار فقط. لا تغيّر إعداد حساب التاجر الحي لتجربة مقال. البيانات الوهمية في الشرح لا تمنح حسابًا ولا تفعل وسيلة دفع، وقد تكون بعض الحقول إلزامية وفق السوق والمسار الذي اخترته.

ماذا يحتوي طلب Create Intention؟

يشمل العقد الموثق مبلغًا وعملة ووسائل دفع وبيانات الطلب والفوترة اللازمة، ويمكن ربطه بمرجع داخلي مثل special_reference. اجعل المبلغ ناتجًا من الطلب في خادمك، لا رقمًا يقبله من الهاتف بلا تحقق. مبلغ الاختبار البسيط يجب أن يراعي وحدة العملة في مسار المزوّد، ولا تعمم الضرب في 100 على أي عملة تمررها لتطبيق آخر.

عند بناء Collection يمكنك استخدام POST على {{PAYMOB_BASE_URL}}/v1/intention/ ورأس Authorization: Token {{PAYMOB_SECRET_KEY}}. هذه صيغة إعداد تعليمية وليست طلبًا نُفّذ هنا. أكمل الحقول حسب المرجع الرسمي، واستبدل Integration ID بالمعرّف الاختباري الفعلي لحسابك، ولا تنسخ أرقام التكامل من صورة تخص حساب مؤلف المقال.

قراءة الاستجابة دون افتراض نجاح الشراء

تحقق أولًا من حالة HTTP وبنية JSON. استجابة إنشاء Intention تتضمن معرّفات وclient_secret يُستخدم لتجربة Checkout؛ لا يعني client_secret أن الطلب مدفوع، ولا يُعامل كأنه مفتاح التاجر العام. احتفظ بما يلزم في الخادم وأعد للتطبيق بيانات الجلسة المقيدة فقط، دون تسجيل الرابط الكامل إذا تضمن رمزًا.

راجع 401 و404 وأخطاء الحقول قبل المحاولة التالية. قد يكون السبب خلط Test وLive أو اختلاف المنطقة أو Integration ID غير تابع للحساب، وليس عطلًا في Flutter. لا تجعل validateStatus تقبل كل شيء ثم تقرأ response.data.token باستخدام ! وتصدر نجاحًا حتى عند وجود استجابة خطأ.

Callback وHMAC

تصل نتيجة المعالجة إلى خادمك عبر callbacks وفق تكاملك. تحقق من HMAC بالطريقة وترتيب الحقول الموثقين، ثم طابق المبلغ والعملة والطلب والمعاملة. لا ترتب JSON أبجديًا وتفترض أنه توقيع صحيح؛ طريقة بناء البيانات تختلف بحسب الحدث والمسار. صفحة العودة تساعد تجربة المستخدم ولا تمنح وحدها صلاحية تنفيذ الطلب.

صمم معالجة آمنة للتكرار: وصول الحدث نفسه مرتين لا يعني تسليم المنتج مرتين. احفظ هوية الحدث أو المعاملة وحدث الطلب ذريًا حسب قاعدة بياناتك. افصل رفض التوقيع عن فشل مؤقت في التخزين، وراجع سياسة إعادة المحاولة الموثقة بدل تجاهل كل إشعار غير متوقع.

خطة الاختبار قبل Flutter

اختبر الطلب الصحيح، والحقول الناقصة، واختلاف البيئة، ومعرّف تكامل غير صحيح، وإشعارًا بتوقيع مرفوض، وتكرار إشعار مؤكد. استخدم بيانات الاختبار التي ينشرها المزوّد حاليًا بدل بطاقة وصلاحية من لقطة قديمة. لم أرسل طلبات إلى Paymob أو أنشئ عمليات دفع خلال إعداد هذا الشرح؛ الاختبارات المرفقة تخص منطق التطبيق بعقود وهمية فقط.

بعد تثبيت عقد الطلب في بيئة الاختبار، انتقل إلى ربط Paymob مع Flutter باستخدام Backend وجلسة Checkout لفصل اتصالات التاجر عن تطبيق الهاتف.

مراجع التنفيذ الرسمية

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع