نظام الدفع الموحد من سايبر سورس

لمن هذا المنتج؟

أي تاجر لديه حساب إنتاجي فعال على منصة CyberSource ويستخدم حاليًا خدمة Hosted Checkout ، ويرغب في الانتقال إلى خدمة Unified Checkout ، لن يحتاج إلى حساب CyberSource جديد؛ إذ يكفي تفعيل خدمة جديدة على معرّف التاجر (MID) الحالي، ونقل إعدادات OpenApply إليه.

⚠️ في OpenApply ، يُعدّ وضع CyberSource ( Hosted Checkout مقابل Unified Checkout ) إعدادًا واحدًا لكل مدرسة ، وليس لكل مستخدم أو لكل جلسة. بمجرد تفعيله، يبدأ جميع أولياء الأمور في تلك المدرسة باستخدام الدفع الموحد. نظرًا لعدم وجود طرح تدريجي أو معاينة خاصة بالموظفين فقط، يُرجى التخطيط وفقًا لذلك.

قائمة التحقق

1. قم بتقديم طلب تكوين MID لتمكين الدفع الموحد، ومصادقة الدافع (3DS)، ومدير القرار على MID الإنتاجي
2. قم بإنشاء مفتاح REST API جديد بمجرد الموافقة على الخدمة
3. خلال فترة انخفاض حركة المرور: قم بعمل نسخة احتياطية من بيانات اعتماد Hosted Checkout، ثم قم بالتبديل OpenApply وUnified Checkout باستخدام المفتاح الجديد ومربع اختيار Decision Manager
4. قم بإعداد رابط الويب الموحد للدفع
5. تحقق من صحة العملية بمعاملة حقيقية واحدة، ثم احتفظ بالتغيير أو تراجع عنه.

الخطوة 1: تفعيل الخدمة (تمكين الخدمة)

في مركز الأعمال، افتح الدعم ← مركز الدعم :

يؤدي هذا إلى فتح مركز دعم حلول قبول التأشيرات. انتقل إلى حالات الدعم ← طلب تكوين MID :

أرسل النموذج، مع تحديد خيار "تفعيل الخدمة" فقط، ثم اطلب ما يلي:

• عملية الدفع الموحدة (واجهة برمجة تطبيقات REST)
• التحقق من هوية الدافع (3DS)
• مدير القرار (في حال الحاجة إلى فحص الاحتيال)

ضمن قسم البيئة ، حدد خيار الإنتاج فقط. اترك خيار الخاص محددًا.

لأي استفسارات خاصة بـ CyberSource، يرجى التواصل مباشرة مع فريق دعم CyberSource.

تقوم شركة CyberSource بمعالجة هذا الأمر داخليًا (وفقًا لوثائقها العامة، عادةً خلال 3 أيام عمل). لا يمكن لأي إجراء آخر في هذه الخطة أن يستمر حتى تتم الموافقة على هذا الأمر، حيث أن مفتاح REST الذي تم إنشاؤه في الخطوة 2 ومربع اختيار مدير القرار في الخطوة 3 يعتمدان على تفعيل هذه الخدمات في حساب التاجر أولًا.

الخطوة الثانية: إنشاء وحفظ مفتاح REST API الجديد

⚠️ مفتاح الدفع الموحد ليس هو نفسه مفتاح الدفع المستضاف ، على الرغم من أنهما ينتميان إلى نفس التاجر/الملف الشخصي. يستخدم الدفع المستضاف مفتاح وصول قبول آمن + مفتاح سري؛ بينما يستخدم الدفع الموحد مفتاح REST API منفصل (معرف المفتاح + سر مشترك). يوجد كل منهما في مكان مختلف في مركز الأعمال، ولا يمكن استبدالهما.

بمجرد تفعيل الخدمة، انتقل إلى مركز الأعمال ← إعدادات الدفع ← إدارة المفاتيح :

انقر + إنشاء المفتاح :

حدد نوع المفتاح REST - Shared Secret ، وهو النوع الموصى به لواجهات برمجة تطبيقات REST التي يستخدمها Unified Checkout:

تجاهل خيارات SCMP / SOAP Toolkit القديمة الموجودة أسفلها (لقد حددت CyberSource أنها انتهت صلاحيتها) وانقر فوق إنشاء مفتاح :

تأكيد الجيل:

انسخ (أو حمل) المفتاح والسر المشترك فوراً، لأن CyberSource لا يعرض السر المشترك إلا مرة واحدة:

الخطوة 3: قم بعمل نسخة احتياطية من عملية الدفع المستضافة، ثم قم بتحويل OpenApply إلى عملية الدفع الموحدة

⚠️ هذه الخطوة تُحوّل جميع أولياء الأمور في المدرسة فورًا إلى نظام الدفع الموحد: إعداد الوضع مُشترك بين جميع طلاب المدرسة (انظر التحذير في الأعلى)، ولا يُمكن اختبار نظام الدفع الموحد دون التبديل إليه. يُنصح بإتمام هذه الخطوات حتى الخطوة 5 في جلسة واحدة، خلال فترة انخفاض حركة المرور على الإنترنت.

قبل تغيير أي شيء ، افتح إعدادات الدفع الخاصة بالمدرسة في لوحة تحكم OpenApply وسجل تكوين Hosted Checkout الحالي (معرف التاجر، معرف الملف الشخصي، مفتاح الوصول، المفتاح السري) في مكان آمن، في حالة الحاجة إلى التراجع لاحقًا:

ثم قم بتغيير الوضع إلى الدفع الموحد واملأ القيم الجديدة:

• معرّف التاجر : نفس القيمة السابقة؛ لم يتغير حساب التاجر
• مفتاح الوصول / المفتاح السري : معرف المفتاح والسر المشترك اللذان تم إنشاؤهما في الخطوة 2 ( لا تعيد استخدام مفتاح الوصول / المفتاح السري الخاص بخدمة الدفع المستضافة؛ راجع التحذير في الخطوة 2)
• لاحظ أن معرّف الملف الشخصي يختفي في هذا الوضع: إنه حقل خاص بخدمة الدفع المستضافة فقط، ولا يستخدمه نظام الدفع الموحد.
• البيئة : حدد البيئة الحية
• تحقق من معاملات الشاشة باستخدام مدير القرار الآن، إذا تم تضمينها في طلب الخطوة 1 وتمت الموافقة عليها (قم بذلك قبل الخطوة 4: يتم إنشاء اشتراك webhook من أي شيء يحدده مربع الاختيار هذا في وقت الإعداد).

الخطوة الرابعة: إعداد رابط الويب

احفظ إعدادات الدفع الموحد من الخطوة 3 أولاً. بعد الحفظ، انتقل إلى شاشة الإعدادات نفسها (انظر قسم "خطاف الدفع الموحد" في لقطة الشاشة أعلاه) وانقر على "إعداد خطاف الدفع تلقائيًا" . سيؤدي هذا إلى إنشاء بيانات اعتماد خطاف الدفع المشفرة وتسجيلها، وإجراء فحص سلامة النظام، وإنشاء الاشتراك. لا حاجة لأي خطوات يدوية في مركز الأعمال.

الخطوة 5: التحقق من صحة العملية بمعاملة حقيقية واحدة، ثم الاحتفاظ بالتغيير أو التراجع عنه

1. تأكد من حفظ مفتاح REST الجديد، وأنّ كلاً من مدير القرارات / 3DS / اشتراك webhook نشط لمعرّف MID الخاص بالإنتاج.
2. قم بإجراء معاملة حقيقية صغيرة واحدة وتأكد من نجاح عملية التفويض، وسيتم تحديث حالة الرسوم/الفاتورة بشكل صحيح في OpenApply
3. إذا سارت الأمور على ما يرام، فسيتم الانتقال إلى النظام الجديد كما هو: لا حاجة لأي إجراء إضافي، حيث يدفع أولياء الأمور الآن عبر نظام الدفع الموحد. أما إذا بدا أي شيء خاطئًا، فيجب التراجع عنه فورًا.

التراجع: قم بتغيير الوضع إلى الدفع المستضاف واستعد بيانات الاعتماد التي تم نسخها احتياطيًا في الخطوة 3. سيؤدي هذا إلى إعادة كل ولي أمر في المدرسة إلى الدفع المستضاف على الفور.