وثائق دليل التكامل الآمن للبرامج ثلاثية الأبعاد
دليل التكامل 3D Secure
اعتبارًا من 01.01.2021 سيتم تنفيذ المصادقة ذات العاملين كشرط إلزامي لجميع معاملات الدفع ببطاقات التجارة الإلكترونية. من أجل الامتثال لهذا الالتزام ، فإن
سيستخدم مشغلو شبكات بطاقات الائتمان الإجراء المسمى بـ 3D Secure. بالنسبة لك كتاجر ، من الضروري أن تكون قادرًا على تنفيذ هذا الإجراء لعملائك من
01.01.2021. ستجد فيما يلي وصفًا للطرق المختلفة للتكامل وكيفية تنفيذ إجراء 3D Secure بالنسبة لهم.
الرجاء تحديد طريقة التكامل التي تستخدمها
- هل تستخدم نموذج الخروج hCO؟
- هل تستخدم نموذج الخروج hPF؟
- هل تقوم بمعالجة المدفوعات دون استخدام النموذج المقدم من نظام Unzer؟
يرجى الملاحظة: من المهم أيضًا طريقة إجراء عمليات الخصم أو التفويضات المسبقة (الحجوزات). حتى إذا كنت تستخدم نموذج دفع من Unzer GmbH لتسجيل بيانات البطاقة ، فسيتم تنفيذ عملية 3D Secure بدون نموذج تسجيل الخروج عندما يتم خصم بيانات البطاقة أولاً أو التصريح بها لأول مرة. في هذه الحالة ، يتم تطبيق الطريقة الثالثة للتكامل بدون النموذج المقدم من Unzer.
يرجى ملاحظة أيضًا:
إذا كنت تستخدم المدفوعات المتكررة (مدفوعات الاشتراك) ، فتأكد من قراءة قسم "الدفع الآمن والمتكرر ثلاثي الأبعاد".
إجراء تأمين ثلاثي الأبعاد عند استخدام نموذج الخروج hCO
تم تصميم نموذج الخروج hCO بالفعل لإجراء 3D Secure. لا يوجد أي إجراء إضافي من جانبك لازم لتنفيذ الإجراء. ولكن هل
يجب أن تتأكد من أن نظامك يمكنه التعامل مع الإجابات المقابلة لنظام الدفع لدينا في حالة بدء عملية 3D Secure. في الاستجابة غير المتزامنة من
نظام الدفع إلى الخادم الخاص بك ، يتم إرسال نتيجة المعاملة ويجب تقييمها هناك قبل الإرجاع URL ينتقل إلى نظام الدفع.
لهذا الغرض يجب تقييم المعلمات التالية.
- رمز المعالجة.الإرجاع = 000.200.000
- PROCESSING.RETURN = المعاملة + معلقة
- PROCESSING.RESULT = شكر
توضيح: حالة المعاملة "معلقة" ، المعامل PROCESSING.RESULT
لا يمثل سوى نتيجة أولية. طالما يتم تنفيذ عملية 3D Secure ، فإن الحالة
لا تزال معلقة.
تكون النتيجة النهائية للمعاملة إما
- رمز المعالجة.الإرجاع = 000.000.000
- PROCESSING.RESULT = شكر
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 أو 000.200.000
- معالجة.النتيجة = NOK
في الحالة الأولى ، تكون المعاملة قد اكتملت بنجاح ، وفي الحالة الثانية تكون قد فشلت بشكل عام. يمكن أن يكون لهذا الأخير أسباب مختلفة ، بما في ذلك رفض المصادقة. سوف تفعلها
تلقي معلومات أكثر تفصيلاً في المعلمات "PROCESSING.RETURN" و "PROCESSING.RETURN.CODE".
نوصي بإجراء اختبار لكلتا الرسالتين. لمزيد من المعلومات حول كيفية إجراء الاختبار وتفاصيل بطاقة الائتمان التي يمكنك استخدامها للاختبار ، يرجى الاطلاع أدناه.
إجراء 3D Secure عند استخدام نموذج الخروج hPF
تم تصميم نموذج الخروج hPF أيضًا لاستخدام إجراء 3DS بالفعل. لا يوجد أي إجراء إضافي من جانبك لازم لتنفيذ الإجراء. كما وصفت
بالنسبة لتطبيق hCO ، تتم الاستجابة من نظام الدفع في خطوتين ، ولهذا السبب يجب أن يتحقق نظامك من قيمة المعالجة .RETURN.CODE
المعلمة عند معالجة الاستجابة.
لهذا الغرض يجب تقييم المعلمات التالية.
- رمز المعالجة.الإرجاع = 000.200.000
- PROCESSING.RETURN = المعاملة + معلقة
- PROCESSING.RESULT = شكر
توضيح: حالة المعاملة "معلقة" ، يمثل المعامل PROCESSING.RESULT نتيجة أولية فقط. طالما يتم تنفيذ عملية 3D Secure ، فإن الحالة
لا تزال معلقة.
تكون النتيجة النهائية للمعاملة إما
- رمز المعالجة.الإرجاع = 000.000.000
- PROCESSING.RESULT = شكر
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 أو 000.200.000
- معالجة.النتيجة = NOK
في الحالة الأولى ، تكون المعاملة قد اكتملت بنجاح ، وفي الحالة الثانية تكون قد فشلت بشكل عام. يمكن أن يكون لهذا الأخير أسباب مختلفة ، بما في ذلك رفض المصادقة. سوف تفعلها
تلقي معلومات أكثر تفصيلاً في المعلمات "PROCESSING.RETURN" و "PROCESSING.RETURN.CODE".
نوصي بإجراء اختبار لكلتا الرسالتين. لمزيد من المعلومات حول كيفية إجراء الاختبار وتفاصيل بطاقة الائتمان التي يمكنك استخدامها للاختبار ، يرجى الاطلاع أدناه.
إجراء تأمين ثلاثي الأبعاد مع اتصال مباشر
إذا كنت لا تستخدم نموذج الدفع المقدم من Unzer (المعروف سابقًا باسم heidelpay) لمعالجة مدفوعات بطاقة الائتمان ، أو إذا قمت ببساطة بتسجيل بطاقة باستخدام أحد النماذج ومعالجة التفويض المسبق (الحجز) أو الخصم كمرجع للتسجيل باعتباره التواصل المباشر مع نظام الدفع ، يجب عليك تنفيذ عملية 3D Secure.
تدفق المعاملات غير المتزامن:
هذه عملية غير متزامنة يتلقى فيها الخادم إعادة توجيه URL (إعادة توجيه URL) من نظام الدفع لدينا. يجب على الخادم الخاص بك إعادة توجيه العميل إلى هذا URL حتى يتمكن من إجراء المصادقة عبر إجراء 3D Secure. يتم الإبلاغ عن نتيجة مصادقة 3D Secure مباشرة إلى Unzer بواسطة البنك الذي أصدر البطاقة.
بعد المصادقة الناجحة ، تتم معالجة المعاملة بشكل أكبر في نظام Unzer بالطريقة التي تعرفها بالفعل عن طريق إرسال النتيجة الإجمالية لنظامك في النهاية ، والتي ترد عليها
مع إعادة توجيه URL. سيقوم نظام الدفع بعد ذلك بإعادة توجيه العميل إلى نظامك باستخدام إعادة التوجيه هذه URL من نظامك
يرجى ملاحظة ما يلي: في سير العمل هذا ، يتلقى نظامك إجابتين من نظام الدفع:
- واحد بالحالة "معلق" (PROCESSING.RETURN.CODE = 000.200.000 و PROCESSING.RETURN = معاملة + معلقة) ومعايير إعادة التوجيه إلى البنك الذي أصدر البطاقة للعميل
- واحد بالنتيجة النهائية للخصم أو الحجز. هناك نوعان من إعادة التوجيه URLمذكورة في هذه العملية ، واحدة من نظام الدفع يجب إعادة توجيه العميل إليه للمصادقة في البنك الذي أصدر بطاقته وأحدها من نظامك ، عند تلقي النتيجة النهائية ، لإعادة توجيه العميل مرة أخرى إلى نظامك.
سيتم إجراء التغييرات التالية على الإجراء العادي. يرجى ملاحظة أنه بسبب تنفيذ طرق دفع غير متزامنة أخرى ، مثل Paypal ، فإن بعضها
العمليات قد تكون موجودة بالفعل في التنفيذ الخاص بك.
- إجابة URL
في المكالمة الأولى (رقم 2 في الرسم البياني) إلى نظام الدفع ، "رد URLيجب أن يتم تمرير "في مجموعة الواجهة الأمامية.
يرجى الملاحظة: لا تكون المعلمة IDENTIFICATION.REFERENCEID ذات صلة إلا إذا أشرت إلى تسجيل أو معاملة أخرى موجودة بالفعل - إعادة توجيه المعالجة URL إذا كانت المصادقة مطلوبة ، تتم إعادة التوجيه URL والمعلمات الأخرى في مجموعة إعادة التوجيه يتم نقلها في الاستجابة من نظام الدفع (رقم 5 في الرسم التخطيطي).
- إعادة توجيه العميل إلى إعادة التوجيه URL
إذا كانت مجموعة إعادة التوجيه تستجيب بإعادة توجيه URL، يجب إعادة توجيه متصفح العميل إلى هذا URL (رقم 6 في الرسم التخطيطي) لأداء المصادقة. يجب نقل المعلمات الإضافية من مجموعة إعادة التوجيه إلى الخارجية webالموقع كمعلمات POST.
يرجى ملاحظة ما يلي: يتم إرجاع المعلمات الإضافية في مجموعة "PROCESSING.REDIRECT.xxx" فقط مع الإصدار 3 من 1D Secure (حتى هناك قد يختلف الرقم والتسمية) ، بينما في الإصدار 3 من الإصدار ثلاثي الأبعاد فقط PROCESSING.REDIRECT.URL كما هو موضح أدناه يتم إرجاعه: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run وهذا يعني أنه بغض النظر عن نوع وعدد المعلمات ، يجب على مستعرض العميل إعادة التوجيه إلى PROCESSING.REDIRECT.URL.
ستجد أدناه رمزًا بسيطًا example لكيفية تنفيذ عملية إعادة التوجيه هذه. ال الجزء المقصود منه إعلام العملاء النهائيين الذين لا تدعم أنظمتهم جافا سكريبت أو تم تعطيلها. نوصي بشدة أن تتم إعادة التوجيه داخل نافذة المتصفح النشطة للعميل وعدم استخدام النوافذ المنبثقة أو نوافذ المتصفح الجديدة ، لأن هذا قد يؤدي إلى
يزعج العملاء ويقودهم إلى إغلاق الصفحة التي تتم إعادة توجيههم إليها.
- فحص النتيجة غير المتزامن
يتم إرسال نتيجة المصادقة بشكل غير متزامن إلى الخادم الخاص بك. يتوقع نظام الدفع قيمة URL كرد. (رقم 12 و 13 في الرسم البياني). للنجاح أو الرفض
المدفوعات مختلفة URL يمكن الرد هنا من خلال نظامك. - مسار عودة العميل
يقوم نظام الدفع بإعادة توجيه العميل إلى URL التي يوفرها نظام التاجر بعد إتمام عملية المصادقة وإتمام معاملة الدفع.
يرجى ملاحظة ما يلي: الخطوتان 4 و 5) تابعان بنفس الطريقة تمامًا كما أنت معتاد بالفعل في معاملات NONE 3D Secure الحالية.
الدفع الآمن والمتكرر ثلاثي الأبعاد
اعتبارًا من الأول من كانون الثاني (يناير) 1 ، سيكون نظام الأمان الثلاثي الأبعاد إلزاميًا لجميع معاملات بطاقات التجارة الإلكترونية. ومع ذلك ، نظرًا لأن هذا لا يكاد ينطبق على المدفوعات المتكررة ، المصرفية
أنظمة لها سير عمل منفصل لهذا الغرض.
لهذا الغرض ، تميز البنوك بين
- CIT = المعاملات التي بدأها العميل
- معهد ماساتشوستس للتكنولوجيا = المعاملات التي بدأها التاجر
يجب مصادقة المعاملة الأولى للبطاقة في حساب التاجر الخاص بك باستخدام 3D Secure من 01.01.2021 فصاعدًا. مثل هذه المصادقة الناجحة هي مطلب إلزامي في
حتى تتمكن من تقديم حجوزات أخرى لاحقًا على نفس البطاقة بدون 3D Secure. لذلك يجب إعادة توجيه العميل إلى البنك الذي أصدر بطاقته مقابل الخصم الأول في
وفقًا للإجراء الموضح أعلاه وتوثيق نفسه هناك باعتباره حامل البطاقة. إذا لم يتم التخطيط للخصم في وقت الطلب ، على سبيل المثالample بسبب فترة تجريبية ، يجب إجراء حجز (تفويض مسبق) يورو واحد على الأقل باستخدام 3D Secure في وجود العميل بدلاً من ذلك. الحصول على هذا الحجز ليس ضروريا.
ومع ذلك ، بالنسبة للعملاء الحاليين ، لا يلزم إجراء مصادقة 3D Secure. إذا حدث أول خصم ناجح قبل 01.01.2021 ، فيمكن أيضًا افتراض أن سجل العميل
تم المصادقة عليه بنجاح. بالنسبة للعملاء الجدد اعتبارًا من 01.01.2021 ، من ناحية أخرى ، فإن مصادقة 3D Secure إلزامية لأول خصم أو حجز (تفويض مسبق).
يرجى ملاحظة ما يلي: في هذا الصدد ، ينظر النظام المصرفي إلى بيانات البطاقة وليس بيانات العميل. لذلك إذا استخدم عميل حالي بطاقة جديدة بعد 01.01.2021 ، على سبيل المثالampجنيه لأن السابق
واحد منتهي الصلاحية أو لأنه قام بتغيير البنك الذي أصدر بطاقته ، فهذه دورة متكررة جديدة من وجهة البنوك view ويجب أن تتم المصادقة عليه مع 3D Secure للحجز الأول.
بمجرد تنفيذ هذه المصادقة الأولية بنجاح ، تُعفى جميع المعاملات الإضافية من الالتزام باستخدام 3D Secure. وبالتالي ، فإن المتطلبات الأساسية للدفع المتكرر بدون 3D Secure هي:
- يوجد على الأقل خصم أو حجز واحد ناجح (تفويض مسبق) والذي تم إما تنفيذه باستخدام 3D Secure أو تم إجراؤه قبل 01.01.2021.
- يُشار إلى تسجيل حالي وخصم عند التقديم
لإعلام نظام الدفع ، أن هذه دفعة متكررة ، يجب إرسال المعلمة RECURRENCE.MODE = REPEATED أيضًا. هذا يشير إلى النظام أن ملف
يتم الإبلاغ عن المدفوعات المتكررة للأنظمة المصرفية.
يرجى ملاحظة ما يلي: إذا تم إدخال المعلمة RECURRENCE.MODE = REPEATED عند تحميل بطاقة جديدة لأول مرة ، فسيتم تنفيذ إعادة توجيه 3D Secure على الرغم من هذه المعلمة.
اختبار تنفيذ 3D Secure
يمكنك اختبار اتصال 3D Secure في أي وقت عبر نظام الدفع الخاص بنا. للقيام بذلك ، استخدم وضع "CONNECTOR_TEST" للمعاملة ، كما هو موضح في السابقampليه أعلاه.
بيانات الاتصال لهذا الاختبار:
| الأمن | 31HA07BC8142C5A171745D00AD63D182 |
| المستخدم | 31ha07bc8142c5a171744e5aef11ffd3 |
| المستخدم | 93167DE7 |
| صفقة. القناة | 31HA07BC8142C5A171749A60D979B6E4 |
| العملات المهيأة للإصدار ثلاثي الأبعاد 3 | يورو ، دولار أمريكي ، كرونة سويدية |
| العملات المهيأة للإصدار ثلاثي الأبعاد 3 | جنيه إسترليني ، كرونة تشيكية ، فرنك سويسري |
إما أن تكون نقطة نهاية بوابة النظام
بوابة SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - لاتينية -15 مشفرة
- https://test-heidelpay.hpcgw.net/sgw/gtwu - ترميز UTF-8
بوابة NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
بيانات بطاقة الائتمان لهذا الاختبار:
| العلامات التجارية | أرقام البطاقة | قيمة رمز التحقق | تاريخ انتهاء الصلاحية | ملحوظة |
| ماستر كارد | 5453010000059543 | 123 | نينرن | 3D - كلمة المرور: Secret3 |
| فيزا | 4711100000000000 | 123 | نينرن | 3DS - كلمة المرور: السر 33 |
يرجى ملاحظة ما يلي: بالنسبة إلى الإصدار 3 من 2D Secure ، لا تحتاج إلى إدخال كلمة مرور ، ولكن ببساطة انقر فوق الارتباط "انقر هنا لإكمال المصادقة.
الطريقة الوحيدة لمحاكاة خطأ في الإصدار 3 من 2D Secure هي ترك الصفحة التي بها رابط مهلة (حوالي 18 دقيقة).
اقرأ المزيد عن هذا الدليل وقم بتنزيل ملف PDF:
المستندات / الموارد
 |
دليل التكامل الآمن للبرامج ثلاثية الأبعاد [بي دي اف] التوثيق Unzer ، دليل التكامل ، 3D Secure |
