بوابة CyberSource للدفع لـ WooCommerce — إضافة Flex Microform v2
استقبل مدفوعات البطاقات في WooCommerce عبر واجهة CyberSource REST مع Flex Microform v2 — رقم البطاقة وCVV داخل إطارات مستضافة لدى CyberSource، فلا يصل خادمك سوى رمز قصير العمر. جاهز لـ HPOS وCheckout Blocks، مع الحجز والإلغاء والاسترداد الأصلي.
حقول بطاقة ليست لك، على صفحة دفع هي لك
سبب طول ربط CyberSource ليس استدعاء الدفع — بل كل ما حوله: إبقاء بيانات البطاقة خارج خادمك، وتوقيع كل طلب توقيعاً صحيحاً، ودعم صفحتَي الدفع في WooCommerce معاً. وهذه الإضافة هي ذلك العمل، منجَزاً ومختبَراً.
🔐 Flex Microform v2 — بيانات البطاقة لا تمسّ استضافتك
رقم البطاقة ورمز الأمان يُكتبان في إطارات مستضافة لدى CyberSource، ويُرمَّزان في المتصفح، ولا يصل خادمك سوى رمز عابر قصير العمر. فاستضافتك لا ترى رقم بطاقة ولا تسجّله ولا تخزّنه، وهو ما يُبقي نطاق امتثالك في أدنى مستوى بدل أن يجرّ خادمك كله إليه.
💳 المدفوعات
- بيع (تفويض وتحصيل معاً) أو تفويض فقط، يُختار من الإعدادات
- تحصيل وإلغاء / عكس التفويض كإجراءات على الطلب في الإدارة — بلا دخول إلى Business Center لتحرير تفويض أو إلغائه
- مرتجعات WooCommerce الأصلية، كاملة وجزئية، من شاشة الطلب كما ينبغي أن تعمل كل بوابة
- شبكات البطاقات قابلة للضبط: Visa وMastercard وAmerican Express وDiscover وDiners Club وJCB
- مراجع العمليات محفوظة على الطلب، فيطابق سطر في إدارتك سطراً في تقرير تسويتك
🧩 صفحتا الدفع، وHPOS
- الدفع الكلاسيكي وكتل السلة والدفع الأحدث — فمعظم إضافات البوابات تدعم واحدة وتتعطل بصمت على الأخرى
- توافق تخزين الطلبات عالي الأداء (HPOS) معلَن كما ينبغي عبر FeaturesUtil في WooCommerce نفسها، لا مفترَضاً
- كلاهما معلَن عند الإقلاع، فتتوقف WooCommerce عن تحذير عميلك بأن البوابة قد تكون غير متوافقة
🔑 توقيع الطلبات كما ينبغي
كل استدعاء موثَّق بـ HTTP Signature (HMAC-SHA256) — نص التوقيع وترويسة البصمة ومعرّف المفتاح مجمَّعة وفق مواصفة CyberSource. وهذا هو الجزء الذي يعيد 401 بصمت لأسبوع حين يُبنى يدوياً، وهو يعمل هنا أصلاً.
🌍 العملات
تعدّد عملات، مع معالجة صحيحة للعملات عديمة الكسور — الين والوون والدونغ والبيزو التشيلي وغيرها تُرسل كوحدات صحيحة لا مضروبة بمئة. تفصيل يكلّف التاجر تحصيلاً بمئة ضعف حين يُغفَل.
🧪 الاختبار والإنتاج، منفصلان
مجموعتا بيانات اعتماد منفصلتان للاختبار والإنتاج، يُبدَّل بينهما بقائمة واحدة. فلا تعديل للمفاتيح ذهاباً وإياباً، ولا خطر وصول مفتاح اختبار إلى متجر حيّ.
🪵 تسجيل تستطيع استخدامه فعلاً
تسجيل تنقيح عبر مسجّل WooCommerce القياسي، مع حجب الأسرار وبيانات البطاقات قبل كتابة أي شيء. يكفي لتشخيص دفعة فاشلة؛ ولا شيء يحوّل ملف السجل إلى مسؤولية قانونية.
🙂 أخطاء يفهمها العميل
استجابات الرفض والخطأ تُترجَم إلى رسائل يستطيع المتسوّق التصرّف بناءً عليها، بدل تمرير رمز سبب خام من البوابة إلى شخص أراد الشراء فحسب.
⚙️ المتطلبات
- WordPress 6.0 فأعلى · WooCommerce 7.0 فأعلى (مختبَرة حتى 9.5) · PHP 7.4 فأعلى
- حساب CyberSource بمفاتيح REST — Business Center ← Payment Configuration ← Key Management ← Generate Key ← REST Shared Secret
- مرخَّصة بـ GPL-2.0 أو أحدث، وجاهزة للترجمة بنطاق نصي ومجلد لغات
ما تحصل عليه
الإضافة كاملة غير مشفّرة، مع ملف التعريف ودليل التركيب. وتأتي معها أدوات اختبار للواجهة ولطبقة التوقيع، فيستطيع المطوّر التحقق من بيانات الاعتماد قبل أن يمسّ صفحة الدفع.
هذا ربط مستقل. CyberSource علامة تجارية لشركة CyberSource / Visa؛ والإضافة غير معتمدة منها ولا تابعة لها.
لا توجد مراجعات بعد. كن أول من يراجع هذا المنتج!