مستندات راهنمای یکپارچه سازی نرم افزارهای سه بعدی 3D

راهنمای یکپارچه سازی 3D امن

از تاریخ 01.01.2021 ، احراز هویت دو عاملی به عنوان یک الزام اجباری برای همه معاملات پرداخت کارت تجارت الکترونیکی اجرا می شود. برای رعایت این تعهد ،
اپراتورهای شبکه های کارت اعتباری از روش به اصطلاح 3D Secure استفاده می کنند. برای شما به عنوان یک بازرگان اجباری است که می توانید این روش را برای مشتریان خود انجام دهید
01.01.2021. در ادامه می توانید توضیحی در مورد روشهای مختلف ادغام و نحوه اجرای روش 3D Secure برای آنها بیابید.

لطفاً روش تلفیقی را که استفاده می کنید انتخاب کنید

• آیا از فرم پرداخت hCO استفاده می کنید؟
• آیا از فرم پرداخت hPF استفاده می کنید؟
• آیا بدون استفاده از فرم ارائه شده توسط سیستم Unzer پرداخت ها را پردازش می کنید؟

لطفا توجه داشته باشید: همچنین مهم است که بدهی یا پیش مجوز (رزرو) انجام شود. حتی اگر برای ثبت داده های کارت از فرم پرداخت Unzer GmbH استفاده می کنید ، وقتی داده های کارت برای اولین بار بدهکار یا مجاز می شوند ، روند 3D Secure بدون فرم تسویه حساب انجام می شود. در این حالت روش سوم ادغام بدون فرم ارائه شده توسط Unzer اعمال می شود.

لطفاً توجه داشته باشید:
اگر از پرداخت های دوره ای (پرداخت اشتراک) استفاده می کنید ، حتما بخش "پرداخت سه بعدی و تکراری" را بخوانید.

روش Secure 3D هنگام استفاده از فرم پرداخت hCO

فرم پرداخت hCO قبلاً برای روش 3D Secure طراحی شده است. از طرف شما هیچ اقدام اضافی برای اجرای روش مورد نیاز نیست. با این حال ، شما
باید اطمینان حاصل کنید که در صورت شروع فرایند 3D Secure ، سیستم شما می تواند پاسخ های مربوط به سیستم پرداخت ما را مدیریت کند. در پاسخ ناهمزمان از
سیستم پرداخت به سرور شما ، نتیجه معامله منتقل می شود و باید قبل از بازده در آنجا ارزیابی شود URL به سیستم پرداخت منتقل می شود.

برای این منظور باید پارامترهای زیر ارزیابی شوند.

• پردازش مجدد. کد = 000.200.000
• PROCESSING.RETURN = معامله + درانتظار
• پردازش. نتیجه = ACK

توضیحات: وضعیت معامله "در انتظار" است ، پارامتر PROCESSING.RESULT
فقط یک نتیجه اولیه را نشان می دهد. تا زمانی که فرایند 3D Secure انجام شود ، وضعیت موجود است
معلق مانده است

نتیجه نهایی معامله در این صورت است

•  پردازش مجدد. کد = 000.000.000
• پردازش. نتیجه = ACK
  or
• پردازش
• پردازش. نتایج = بدون

در حالت اول معامله با موفقیت انجام شده است ، در حالت دوم به طور کلی شکست خورده است. دلیل دوم می تواند دلایل مختلفی داشته باشد ، از جمله امتناع از تأیید اعتبار. خواهی کرد
اطلاعات دقیق تر را در پارامترهای "PROCESSING.RETURN" و "PROCESSING.RETURN.CODE" دریافت کنید.
توصیه می کنیم برای هر دو پیام آزمایشی اجرا کنید. برای کسب اطلاعات بیشتر در مورد نحوه انجام آزمون و جزئیات کارت اعتباری که می توانید برای آزمون استفاده کنید ، لطفاً به زیر مراجعه کنید.

روش Secure 3D هنگام استفاده از فرم پرداخت hPF

فرم پرداخت hPF نیز برای استفاده از روش 3DS در حال حاضر طراحی شده است. از طرف شما هیچ اقدام اضافی برای اجرای روش مورد نیاز نیست. همانطور که توضیح داده شد
برای پیاده سازی hCO پاسخ از سیستم پرداخت در دو مرحله انجام می شود ، به همین دلیل سیستم شما باید مقدار پردازش را بررسی کند.
پارامتر هنگام پردازش پاسخ.

برای این منظور باید پارامترهای زیر ارزیابی شوند.

• پردازش مجدد. کد = 000.200.000
• PROCESSING.RETURN = معامله + درانتظار
• پردازش. نتیجه = ACK

توضیح: وضعیت معامله "درانتظار" است ، پارامتر PROCESSING.RESULT فقط یک نتیجه اولیه را نشان می دهد. تا زمانی که فرایند 3D Secure انجام شود ، وضعیت موجود است
معلق مانده است

نتیجه نهایی معامله در این صورت است

• پردازش مجدد. کد = 000.000.000
• پردازش. نتیجه = ACK
  or
• پردازش
• پردازش. نتایج = بدون

در حالت اول معامله با موفقیت انجام شده است ، در حالت دوم به طور کلی شکست خورده است. دلیل دوم می تواند دلایل مختلفی داشته باشد ، از جمله امتناع از تأیید اعتبار. خواهی کرد
اطلاعات دقیق تر را در پارامترهای "PROCESSING.RETURN" و "PROCESSING.RETURN.CODE" دریافت کنید.
توصیه می کنیم برای هر دو پیام آزمایشی اجرا کنید. برای کسب اطلاعات بیشتر در مورد نحوه انجام آزمون و جزئیات کارت اعتباری که می توانید برای آزمون استفاده کنید ، لطفاً به زیر مراجعه کنید.

روش 3D امن با اتصال مستقیم

اگر از فرم پرداخت ارائه شده توسط Unzer (هایدل پی سابق) برای پردازش پرداخت کارت اعتباری استفاده نمی کنید ، یا اگر به سادگی با استفاده از یکی از فرم ها کارت را ثبت می کنید و پیش مجوز (رزرو) یا بدهی را به عنوان مرجع ثبت نام به عنوان ارتباط مستقیم با سیستم پرداخت ، شما باید فرایند 3D Secure را پیاده سازی کنید.

جریان معاملات ناهمزمان:

این یک فرآیند ناهمزمان است که در آن سرور شما فوروارد را دریافت می کند URL (تغییر مسیر دهید URL) از سیستم پرداخت ما. سرور شما باید مشتری را به این قسمت هدایت کند URL تا بتواند احراز هویت را از طریق روش 3D Secure انجام دهد. نتیجه این احراز هویت سه بعدی امن توسط بانک صادر کننده کارت مستقیماً به آنزر گزارش می شود.

پس از احراز هویت موفقیت آمیز ، معامله در سیستم Unzer به روشی که قبلاً می دانید با ارسال یک نتیجه کلی از سیستم در پایان ، که به آن پاسخ می دهید ، پردازش می شود.
با تغییر مسیر URL. سپس سیستم پرداخت با استفاده از این تغییر مسیر مشتری را به سیستم شما هدایت می کند URL از سیستم شما

لطفا توجه داشته باشید: در این گردش کار سیستم شما دو پاسخ از سیستم پرداخت دریافت می کند:

- یکی با وضعیت "در حال تعلیق" (PROCESSING.RETURN.CODE = 000.200.000 و PROCESSING.RETURN = معامله + درانتظار) و پارامترهای هدایت مجدد به بانک صادر کننده کارت مشتری
- یکی با نتیجه نهایی بدهی یا رزرو. همچنین دو تغییر مسیر وجود دارد URLدر این فرآیند ذکر شده است ، یکی از سیستم پرداختی که مشتری باید به آن هدایت شود تا در کارت صادر کننده کارت خود و در سیستم دریافت یکی از سیستم شما ، در هنگام دریافت نتیجه نهایی ، مشتری را مجدداً به سیستم شما احراز کند.

تغییرات زیر در روش معمول ایجاد می شود. لطفا توجه داشته باشید که با توجه به اجرای روشهای پرداخت غیرهمزمان دیگر ، مانند Paypal ، برخی از این موارد
فرآیندها ممکن است از قبل در اجرای شما وجود داشته باشد.

1. پاسخ URL
   در اولین تماس (شماره 2 در نمودار) با سیستم پرداخت ، "پاسخ URL”باید در گروه frontend منتقل شود.
   
   لطفا توجه داشته باشید: پارامتر IDENTIFICATION.REFERENCEID فقط درصورت ارتباط با ثبت یا معامله موجود از قبل موجود است
2. پردازش تغییر مسیر URL در صورت نیاز به احراز هویت ، یک تغییر مسیر دهید URL و سایر پارامترهای موجود در گروه تغییر مسیر در پاسخ از سیستم پرداخت (شماره 5 در نمودار) منتقل می شوند.
   
   
3. حمل و نقل مشتری به هدایت مجدد URL
   اگر گروه ریدایرکت با ریدایرکت پاسخ می دهد URL، مرورگر مشتری باید به این قسمت هدایت شود URL (شماره 6 در نمودار) برای انجام احراز هویت. پارامترهای اضافی از گروه تغییر مسیر باید به خارجی منتقل شوند webسایت به عنوان پارامترهای POST.
   لطفا توجه داشته باشید: پارامترهای اضافی فقط در نسخه امن 3D 1 به گروه "PROCESSING.REDIRECT.xxx" بازگردانده می شوند (حتی در آنجا تعداد و نامگذاری ممکن است متفاوت باشد) ، در حالی که در نسخه 3 بعدی نسخه فقط 2 یک پردازش. REDIRECT.URL همانطور که در زیر نشان داده شده است بازگردانده می شود: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
   CCF / run این بدان معناست که صرف نظر از نوع و تعداد پارامترها ، مرورگر مشتری باید به PROCESSING.REDIRECT هدایت شود.URL.
   در زیر یک کد ساده ex را خواهید دیدampچگونه می توان چنین تغییر مسیری را اجرا کرد. این بخشی برای اطلاع رسانی به مشتریان نهایی است که سیستم‌هایشان از جاوا اسکریپت پشتیبانی نمی‌کند یا آن را غیرفعال کرده‌اند. ما قویاً توصیه می‌کنیم که تغییر مسیر در پنجره فعال مرورگر مشتری انجام شود و از پنجره‌های بازشو یا پنجره‌های مرورگر جدید استفاده نکنید، زیرا ممکن است
   مشتریان را اذیت کرده و آنها را به سمت بستن صفحه ای که به آن هدایت می شوند سوق می دهد.
   
4. بررسی نتیجه ناهمزمان
   نتیجه تأیید اعتبار به طور همزمان به سرور شما ارسال می شود. سیستم پرداخت معتبر انتظار دارد URL به عنوان پاسخ (شماره 12 و 13 در نمودار). برای موفق یا رد شده
   پرداخت ، متفاوت است URL در اینجا توسط سیستم شما پاسخ داده می شود.
5. مسیر بازگشت مشتری
   سیستم پرداخت مشتری را به سمت هدایت می کند URL پس از انجام مراحل احراز هویت و انجام معامله پرداخت ، توسط سیستم بازرگان ارائه شده است.
   لطفا توجه داشته باشید: مراحل 4.) و 5.) دقیقاً به همان روشی که قبلاً در معاملات موجود NONE 3D Secure با آن آشنا هستید ، پیش بروید.

پرداخت سه بعدی امن و تکراری

از اول ژانویه 1 ، 2021D Secure برای کلیه معاملات کارت تجارت الکترونیکی اجباری است. با این حال ، از آنجا که این برای پرداخت های مکرر به سختی قابل اجرا است ، بانکداری
سیستم ها گردش کار جداگانه ای برای این کار دارند.

برای این منظور ، بانک ها بین یکدیگر تفاوت قائل می شوند

• CIT = معاملات اولیه مشتری
• MIT = معاملات مقداردهی اولیه بازرگان

اولین تراکنش کارت در حساب بازرگان شما باید از تاریخ 3 به بعد با 01.01.2021D Secure احراز هویت شود. چنین احراز هویتی موفق یک الزام اجباری در است
برای اینکه بتوانید پس از آن رزروهای بیشتری را در همان کارت بدون 3D Secure ارسال کنید. بنابراین مشتری باید برای اولین بدهی به بانک صادر کننده کارت خود ارسال شود
مطابق با روشی که در بالا توضیح داده شد و خود را در آنجا به عنوان دارنده کارت احراز هویت کند. اگر در زمان سفارش، بدهی برنامه ریزی نشده باشد، برای مثالampبه دلیل یک دوره آزمایشی، در عوض باید با 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 به رغم این پارامتر انجام می شود.

آزمایش پیاده سازی 3D Secure

شما می توانید اتصال 3D Secure را در هر زمان از طریق سیستم پرداخت ما آزمایش کنید. برای انجام این کار، همانطور که در شکل قبلی نشان داده شده است، از حالت "CONNECTOR_TEST" برای تراکنش استفاده کنیدamples بالا.
اطلاعات اتصال برای این آزمون:

امنیت. ارسال کننده	31HA07BC8142C5A171745D00AD63D182
ورود کاربر	31ha07bc8142c5a171744e5aef11ffd3
USER.PWD	93167DE7
TRANSACTION.CANNEL	31HA07BC8142C5A171749A60D979B6E4
ارزهای پیکربندی شده برای نسخه 3 بعدی	EUR ، USD ، SEK
ارزهای پیکربندی شده برای نسخه 3 بعدی	GBP ، CZK ، CHF

نقطه پایانی دروازه سیستم یا یکی است
دروازه 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

داده های کارت اعتباری برای این آزمون:

مارک ها	شماره کارت	CVV	تاریخ انقضا	توجه داشته باشید
مسترکارت	5453010000059543	123	تاریخ آینده	3D - رمز عبور: secret3
ویزا	4711100000000000	123	تاریخ آینده	3DS - رمز عبور: مخفی! 33

لطفا توجه داشته باشید: برای نسخه 3D امن 2 ، نیازی به وارد کردن رمز عبور ندارید ، اما کافیست روی پیوند کلیک کنید "برای تکمیل احراز هویت اینجا را کلیک کنید.
تنها راه شبیه سازی خطا با 3D Secure Version 2 این است که به صفحه دارای پیوند خاتمه دهید (تقریباً 18 دقیقه).

 

اطلاعات بیشتر درباره این راهنما و دانلود PDF:

اسناد / منابع

راهنمای ادغام سه بعدی ایمن نرم افزارها [pdfمستندات Unzer ، راهنمای ادغام ، 3D Secure

مراجع

• راهنمای کاربر