Софтуер 3D Сигурно ръководство за интеграция Документация
Ръководство за интеграция 3D Secure
От 01.01.2021 г. нататък ще бъде внедрено двуфакторно удостоверяване като задължително изискване за всички транзакции на разплащания с електронна търговия. За да изпълни това задължение,
операторите на мрежи с кредитни карти ще използват така наречената 3D Secure процедура. За вас като търговец е задължително да можете да изпълните тази процедура за вашите клиенти от
01.01.2021. По-долу ще намерите описание на различните начини за интеграция и как трябва да се приложи процедурата 3D Secure за тях.
Моля, изберете метода на интеграция, който използвате
- Използвате ли формуляр за плащане hCO?
- Използвате ли формуляра за плащане hPF?
- Обработвате ли плащания, без да използвате формуляр, предоставен от системата Unzer?
Моля, обърнете внимание: Също така е важно по какъв начин се правят дебити или предварителни разрешения (резервации). Дори ако използвате формуляр за плащане от Unzer GmbH за регистрация на данни за карти, процесът 3D Secure ще се извърши без формуляр за плащане, когато данните за картата се дебитират или упълномощават за първи път. В този случай се прилага третият начин на интеграция без формуляр, предоставен от Unzer.
Моля, обърнете внимание също:
Ако използвате периодични плащания (абонаментни плащания), не забравяйте да прочетете раздела „3D сигурно и периодично плащане“.
Процедура 3D Secure при използване на формуляра за плащане на hCO
Формулярът за плащане на hCO вече е проектиран за процедурата 3D Secure. Няма допълнителни действия от ваша страна, необходими за изпълнението на процедурата. Ти обаче
трябва да се уверите, че вашата система може да обработва съответните отговори на нашата платежна система в случай, че процесът 3D Secure стартира. В асинхронния отговор от
платежна система към вашия сървър, резултатът от транзакцията се предава и трябва да бъде оценен там преди връщане URL се предава в платежната система.
За тази цел трябва да бъдат оценени следните параметри.
- ОБРАБОТКА.ВРЪЩАНЕ.КОД = 000.200.000
- PROCESSING.RETURN = Транзакция + в очакване
- ПРОЦЕСИРАНЕ.РЕЗУЛТАТ = АКК
Обяснение: Състоянието на транзакцията е „в очакване“, параметърът PROCESSING.RESULT
представлява само предварителен резултат. Докато се извършва процесът 3D Secure, състоянието
остават в очакване.
Тогава крайният резултат от транзакцията е или
- ОБРАБОТКА.ВРЪЩАНЕ.КОД = 000.000.000
- ПРОЦЕСИРАНЕ.РЕЗУЛТАТ = АКК
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 или 000.200.000 XNUMX
- ОБРАБОТКА.РЕЗУЛТАТ = NOK
В първия случай транзакцията е завършена успешно, във втория случай е неуспешна като цяло. Последните могат да имат различни причини, включително отказ за удостоверяване. Ти ще
получавате по-подробна информация в параметрите „ПРОЦЕСИРАНЕ.ВРЪЩАНЕ“ и „ПРОЦЕСИРАНЕ.ВРЪЩАНЕ.КОД“.
Препоръчваме ви да изпълните тест за двете съобщения. За повече информация как да направите тест и кои данни за кредитни карти можете да използвате за тест, моля вижте по-долу.
3D Secure процедура при използване на hPF формуляр за плащане
Формата за плащане на hPF също е предназначена да използва процедурата 3DS вече. Няма допълнителни действия от ваша страна, необходими за изпълнението на процедурата. Както е описано
за внедряването на hCO отговорът от платежната система се извършва в две стъпки, поради което вашата система трябва да провери стойността на PROCESSING.RETURN.CODE
параметър при обработка на отговора.
За тази цел трябва да бъдат оценени следните параметри.
- ОБРАБОТКА.ВРЪЩАНЕ.КОД = 000.200.000
- PROCESSING.RETURN = Транзакция + в очакване
- ПРОЦЕСИРАНЕ.РЕЗУЛТАТ = АКК
Обяснение: Състоянието на транзакцията е „в очакване“, параметърът PROCESSING.RESULT представлява само предварителен резултат. Докато се извършва процесът 3D Secure, състоянието
остават в очакване.
Тогава крайният резултат от транзакцията е или
- ОБРАБОТКА.ВРЪЩАНЕ.КОД = 000.000.000
- ПРОЦЕСИРАНЕ.РЕЗУЛТАТ = АКК
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 или 000.200.000 XNUMX
- ОБРАБОТКА.РЕЗУЛТАТ = NOK
В първия случай транзакцията е завършена успешно, във втория случай е неуспешна като цяло. Последните могат да имат различни причини, включително отказ за удостоверяване. Ти ще
получавате по-подробна информация в параметрите „ПРОЦЕСИРАНЕ.ВРЪЩАНЕ“ и „ПРОЦЕСИРАНЕ.ВРЪЩАНЕ.КОД“.
Препоръчваме ви да изпълните тест за двете съобщения. За повече информация как да направите тест и кои данни за кредитни карти можете да използвате за тест, моля вижте по-долу.
3D Secure процедура с директна връзка
Ако не използвате формуляр за плащане, предоставен от 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“ само с 3D Secure Версия 1 (дори там броят и именуването може да варират), докато при 3D Версия 2 само PROCESSING.REDIRECT.URL както е показано по-долу, се връща: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Това означава, че независимо от вида и броя на параметрите, клиентският браузър трябва да пренасочи към PROCESSING.REDIRECT.URL.
По -долу ще намерите прост код, напрampза това как може да се изпълни такова пренасочване. The част е предназначена да информира крайните клиенти, чиито системи не поддържат Javascript или са го деактивирали. Силно препоръчваме пренасочването да се извършва в активния прозорец на браузъра на клиента и да не се използват изскачащи прозорци или нови прозорци на браузъра, тъй като това би могло
дразнят клиентите и ги карат да затворят страницата, към която са пренасочени.
- Асинхронна проверка на резултатите
Резултатът от удостоверяването се изпраща асинхронно на вашия сървър. Платежната система очаква валиден URL като отговор. (№ 12 и 13 на диаграмата). За успешен или отхвърлен
плащания, различен URL може да се отговори тук от вашата система. - Път на връщане на клиента
Платежната система пренасочва клиента към URL предоставени от системата на търговеца след приключване на процеса на удостоверяване и платежната транзакция.
Моля, обърнете внимание: Стъпки 4.) и 5.) продължават по абсолютно същия начин, както вече сте запознати със съществуващите NONE 3D Secure транзакции.
3D сигурно и периодично плащане
От 1 януари 2021 г. 3D Secure ще бъде задължителен за всички транзакции с карти за електронна търговия. Тъй като обаче това едва ли е приложимо за периодични плащания, банкирането
системите имат отделен работен процес за това.
За тази цел банките правят разлика
- CIT = клиентски инициализирани транзакции
- MIT = търговски инициализирани транзакции
Първата транзакция на карта във вашия търговски акаунт трябва да бъде удостоверена с 3D Secure от 01.01.2021 нататък. Подобно успешно удостоверяване е задължително изискване в
за да можете впоследствие да подавате допълнителни резервации на същата карта без 3D Secure. Поради това клиентът трябва да бъде препратен до банката си, издала картата, за първия дебит в
в съответствие с описаната по -горе процедура и да се удостовери там като картодържател. Ако дебит не е планиран по време на поръчката, напрampпоради пробен период трябва да се направи резервация (предварително разрешение) от поне едно евро с 3D Secure в присъствието на клиента. Записването на тази резервация не е необходимо.
За съществуващите клиенти обаче не е необходимо да се измисля 3D Secure удостоверяване. Ако първият успешен дебит е извършен преди 01.01.2021 г., може да се приеме и клиентският запис
са успешно удостоверени. За новите клиенти от 01.01.2021, от друга страна, 3D Secure удостоверяването е задължително за първия дебит или резервация (предварително разрешение).
Моля, обърнете внимание: В това отношение банковата система разглежда данните на картата, а не данните на клиентите. Така че, ако съществуващ клиент използва нова карта след 01.01.2021 г., напрample защото предишното
една е изтекла или тъй като е сменил банката си, издаваща карти, това е нов повтарящ се цикъл от гледна точка на банките на view и трябва да бъдат удостоверени с 3D Secure за първата резервация.
След като това първоначално удостоверяване бъде успешно проведено, всички по-нататъшни транзакции са освободени от задължението за използване на 3D Secure Предпоставките за периодично плащане без 3D Secure са следователно:
- Има поне един успешен дебит или резервация (предварително разрешаване), който е бил извършен с 3D Secure или е бил извършен преди 01.01.2021.
- той се позовава на съществуваща регистрация и дебит при подаване
За да уведомите платежната система, че това е периодично плащане, трябва да бъде изпратен и параметърът RECURRENCE.MODE = REPEATED. Това сигнализира на системата, че a
периодично плащане трябва да се докладва на банковите системи.
Моля, обърнете внимание: Ако параметърът RECURRENCE.MODE = REPEATED е въведен, когато нова карта се зарежда за първи път, 3D Secure препращане ще се извърши въпреки този параметър.
Тестване на 3D Secure изпълнението
Можете да тествате връзката 3D Secure по всяко време чрез нашата платежна система. За да направите това, използвайте режима „CONNECTOR_TEST“ за транзакция, както е показано в прampпо -горе.
Данни за връзка за този тест:
| SIGURITY.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| ПОТРЕБИТЕЛСКИ ВХОД | 31ha07bc8142c5a171744e5aef11ffd3 |
| ПОТРЕБИТЕЛ.PWD | 93167DE7 |
| СДЕЛКА.КАНАЛ | 31HA07BC8142C5A171749A60D979B6E4 |
| Валути, конфигурирани за 3D версия 2 | EUR, USD, SEK |
| Валути, конфигурирани за 3D версия 1 | 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 | срок на годност | бележка |
| MasterCard | 5453010000059543 | 123 | бъдеща дата | 3D - парола: secret3 |
| Виза | 4711100000000000 | 123 | бъдеща дата | 3DS - парола: тайна! 33 |
Моля, обърнете внимание: За 3D Secure версия 2 не е необходимо да въвеждате парола, а просто щракнете върху връзката ”Щракнете тук, за да завършите удостоверяването.
Единственият начин да симулирате грешка с 3D Secure Version 2 е да оставите страницата с времето за изчакване на връзката (приблизително 18 минути).
Прочетете повече за това ръководство и изтеглете PDF:
Документи / Ресурси
 |
Ръководство за 3D Secure интегриране на софтуера [pdfДокументация Unzer, Ръководство за интеграция, 3D Secure |
