Софтвер 3Д Водич за сигурну интеграцију Документација
Водич за интеграцију 3Д Сецуре
Од 01.01.2021. године двофакторска аутентификација ће бити примењена као обавезан услов за све платне трансакције путем е-трговине картице. Да би се испунила ова обавеза,
оператери мрежа кредитних картица користиће тзв. 3Д Сецуре процедуру. За вас као трговца је обавезно да можете да извршите ову процедуру за своје купце из
01.01.2021. У наставку ћете наћи опис различитих начина интеграције и начина на који се 3Д Сецуре процедура мора имплементирати за њих.
Изаберите метод интеграције који користите
- Да ли користите образац за одјаву хЦО?
- Да ли користите образац за наплату хПФ?
- Да ли обрађујете уплате без коришћења обрасца који пружа Унзер систем?
Имајте на уму: Такође је важно на који начин се врше задужења или преауторизације (резервације). Чак и ако користите образац за плаћање компаније Унзер ГмбХ за регистрацију података о картици, 3Д Сецуре процес ће бити спроведен без обрасца за плаћање када се подаци о картици први пут задужују или ауторизују. У овом случају се примењује трећи начин интеграције без обрасца који обезбеђује Унзер.
Такође имајте на уму:
Ако користите периодична плаћања (плаћања претплате), обавезно прочитајте одељак „3Д Сецуре и периодично плаћање“.
3Д Сецуре процедура када користите образац за одјаву хЦО
Образац за одјаву хЦО је већ дизајниран за 3Д Сецуре процедуру. За спровођење поступка није потребна никаква додатна радња са ваше стране. Међутим, ти
морате да се уверите да ваш систем може да обради одговарајуће одговоре нашег система плаћања у случају да се покрене 3Д Сецуре процес. У асинхроном одговору од
платног система на ваш сервер, резултат трансакције се преноси и тамо се мора проценити пре враћања URL се преноси у платни систем.
У ту сврху морају се проценити следећи параметри.
- ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ = 000.200.000
- ПРОЦЕССИНГ.РЕТУРН = Трансакција+на чекању
- ПРОЦЕССИНГ.РЕСУЛТ = АЦК
Објашњење: Статус трансакције је “на чекању”, параметар ПРОЦЕССИНГ.РЕСУЛТ
представља само прелиминарни резултат. Све док се 3Д Сецуре процес спроводи, статус
остају на чекању.
Коначни резултат трансакције је тада или
- ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ = 000.000.000
- ПРОЦЕССИНГ.РЕСУЛТ = АЦК
or - ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ = иргендеин Верт унглеицх 000.000.000 или 000.200.000
- ПРОЦЕССИНГ.РЕСУЛТ = НОК
У првом случају трансакција је успешно завршена, у другом случају је у целини пропала. Ово последње може имати различите разлоге, укључујући и одбијање аутентификације. ти ћеш
добијате детаљније информације у параметрима „ПРОЦЕССИНГ.РЕТУРН” и „ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ”.
Препоручујемо вам да покренете тест за обе поруке. За више информација о томе како да урадите тест и које детаље кредитне картице можете да користите за тест, погледајте испод.
3Д Сецуре процедура када користите хПФ образац за одјаву
хПФ образац за одјаву је такође дизајниран да већ користи 3ДС процедуру. За спровођење поступка није потребна никаква додатна радња са ваше стране. Како је описано
за имплементацију хЦО одговор из платног система се одвија у два корака, због чега ваш систем мора да провери вредност ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ
параметар приликом обраде одговора.
У ту сврху морају се проценити следећи параметри.
- ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ = 000.200.000
- ПРОЦЕССИНГ.РЕТУРН = Трансакција+на чекању
- ПРОЦЕССИНГ.РЕСУЛТ = АЦК
Објашњење: Статус трансакције је “на чекању”, параметар ПРОЦЕССИНГ.РЕСУЛТ представља само прелиминарни резултат. Све док се 3Д Сецуре процес спроводи, статус
остају на чекању.
Коначни резултат трансакције је тада или
- ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ = 000.000.000
- ПРОЦЕССИНГ.РЕСУЛТ = АЦК
or - ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ = иргендеин Верт унглеицх 000.000.000 или 000.200.000
- ПРОЦЕССИНГ.РЕСУЛТ = НОК
У првом случају трансакција је успешно завршена, у другом случају је у целини пропала. Ово последње може имати различите разлоге, укључујући и одбијање аутентификације. ти ћеш
добијате детаљније информације у параметрима „ПРОЦЕССИНГ.РЕТУРН” и „ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ”.
Препоручујемо вам да покренете тест за обе поруке. За више информација о томе како да урадите тест и које детаље кредитне картице можете да користите за тест, погледајте испод.
3Д Сецуре процедура са директном везом
Ако не користите образац за плаћање који је обезбедио Унзер (раније хеиделпаи) за обраду плаћања кредитном картицом или ако једноставно региструјете картицу користећи један од образаца и обрадите преауторизацију (резервацију) или задужење као референцу за регистрацију као директну комуникацију са платним системом, морате имплементирати 3Д Сецуре процес.
Асинхрони ток трансакције:
Ово је асинхрони процес у коме ваш сервер прима прослеђивање URL (Преусмери URL) из нашег платног система. Ваш сервер мора проследити купца на ово URL тако да може да изврши аутентификацију путем 3Д Сецуре процедуре. Резултат ове 3Д Сецуре аутентификације се пријављује директно Унзеру од стране банке која је издала картицу.
Након успешне аутентификације, трансакција се даље обрађује у Унзер систему на начин који већ знате тако што се вашем систему на крају шаље укупни резултат, на који ви одговарате
са преусмеравањем URL. Систем плаћања ће затим преусмерити купца назад на ваш систем користећи ово преусмеравање URL из вашег система
Имајте на уму: У овом току рада ваш систем добија два одговора од платног система:
– Један са статусом „на чекању“ (ПРОЦЕССИНГ.РЕТУРН.ЦОДЕ=000.200.000 и ПРОЦЕССИНГ.РЕТУРН=Трансакција+на чекању) и параметрима преусмеравања на банку која је издала картицу клијента
– Један са коначним резултатом задужења или резервације. Постоје и два преусмеравања URLје поменуто у овом процесу, један из платног система на који клијент мора да буде преусмерен да се аутентификује у банци издаваоцу своје картице и један из вашег система, када добије коначни резултат, да преусмери клијента назад у ваш систем.
У редовну процедуру биће извршене следеће измене. Имајте на уму да због имплементације других асинхроних метода плаћања, као што је Паипал, неки од ових
процеси можда већ постоје у вашој имплементацији.
- Одговор URL
У првом позиву (бр. 2 на дијаграму) платном систему, „Одговор URL” мора бити прослеђен у фронтенд групи.
Имајте на уму: Параметар ИДЕНТИФИЦАТИОН.РЕФЕРЕНЦЕИД је релевантан само ако се позивате на регистрацију или другу већ постојећу трансакцију - Преусмеравање обраде URL Ако је потребна аутентификација, преусмеравање URL а остали параметри у групи за преусмеравање се преносе у одговору из платног система (бр. 5 на дијаграму).
- Прослеђивање купца на преусмеравање URL
Ако група за преусмеравање одговара преусмеравањем URL, претраживач клијента мора бити преусмерен на ово URL (бр. 6 на дијаграму) за извршење аутентификације. Додатни параметри из групе за преусмеравање се морају пренети на екстерни webсајт као ПОСТ параметри.
Имајте на уму: Додатни параметри се враћају у групи „ПРОЦЕССИНГ.РЕДИРЕЦТ.ккк“ само са 3Д Сецуре верзијом 1 (чак и тамо број и називи могу да варирају), док са 3Д верзијом 2 само ПРОЦЕССИНГ.РЕДИРЕЦТ.URL као што је приказано испод се враћа: хттпс://хеиделпаи.хпцгв.нет/АутхСервице/в1/аутх/публиц/2258_2863ФФА4Ц5241Ц12Е39Ф37
ЦЦФ/рун То значи да без обзира на тип и број параметара, претраживач клијента мора да преусмери на ПРОЦЕССИНГ.РЕДИРЕЦТ.URL.
Испод ћете наћи једноставан код нпрampле о томе како се такво преусмеравање може извршити. Тхе део је намењен да обавести крајње кориснике чији системи не подржавају Јавасцрипт или га имају онемогућено. Снажно препоручујемо да се преусмеравање обави унутар активног прозора претраживача клијента и да се не користе искачући прозори или нови прозори прегледача, јер би то могло
иритирати купце и навести их да затворе страницу на коју су преусмерени.
- Асинхрона провера резултата
Резултат аутентификације се асинхроно шаље на ваш сервер. Платни систем очекује валидну URL као одговор. (бр. 12 и 13 на дијаграму). За успешан или одбијен
плаћања, другачија URL ваш систем може да одговори овде. - Повратна путања купца
Платни систем преусмерава купца на URL које обезбеђује систем трговца након завршетка процеса аутентификације и платне трансакције.
Имајте на уму: Кораци 4.) и 5.) поступите на потпуно исти начин на који сте већ упознати у постојећим НОНЕ 3Д Сецуре трансакцијама.
3Д Сецуре и периодично плаћање
Од 1. јануара 2021. 3Д Сецуре ће бити обавезан за све трансакције картицама за е-трговину. Међутим, пошто је ово тешко примењиво за периодична плаћања, банкарство
системи имају посебан ток рада за ово.
У ту сврху банке разликују
- ЦИТ = трансакције иницијализоване клијентом
- МИТ = трансакције иницијализоване трговцем
Прва трансакција картице на вашем трговачком рачуну мора бити аутентификована помоћу 3Д Сецуре-а од 01.01.2021. Оваква успешна аутентификација је обавезан захтев у
како бисте могли накнадно да предате даље резервације на истој картици без 3Д Сецуре-а. Клијент стога мора бити прослеђен својој банци која је издала картицу за прво задужење
у складу са горе описаном процедуром и ту се аутентификује као власник картице. Ако задуживање није планирано у време поруџбине, нпрampда због пробног периода, резервација (пре-ауторизација) од најмање једног евра мора да се изврши уз 3Д Сецуре у присуству клијента. Снимање ове резервације није неопходно.
За постојеће купце, међутим, није потребно правити 3Д Сецуре аутентификацију. Ако се прво успешно задуживање догодило пре 01.01.2021, може се претпоставити да је евиденција о клијенту
су успешно потврђене. За нове клијенте од 01.01.2021, с друге стране, 3Д Сецуре аутентификација је обавезна за прво задужење или резервацију (пре-ауторизација).
Напомена: У том погледу, банкарски систем гледа на податке картице, а не на податке о клијентима. Дакле, ако постојећи корисник користи нову картицу након 01.01.2021, нпрampле јер претходни
један је истекао или зато што је променио банку која издаје картицу, ово је нови циклус који се понавља од тачке банке до view и морају бити потврђени помоћу 3Д Сецуре-а за прву резервацију.
Након што је ова почетна аутентификација успешно обављена, све даље трансакције су изузете од обавезе коришћења 3Д Сецуре-а. Предуслови за понављајуће плаћање без 3Д Сецуре-а су:
- Постоји најмање једно успешно задужење или резервација (пре-ауторизација) која је обављена помоћу 3Д Сецуре-а или је обављена пре 01.01.2021.
- позива се на постојећу регистрацију и задужење приликом подношења
Да би платни систем знао да је у питању периодично плаћање, мора се послати и параметар РЕЦУРРЕНЦЕ.МОДЕ=РЕПЕАТЕД. Ово сигнализира систему да а
периодично плаћање треба пријавити банкарским системима.
Напомена: Ако се параметар РЕЦУРРЕНЦЕ.МОДЕ=РЕПЕАТЕД унесе када се нова картица учита по први пут, 3Д Сецуре прослеђивање ће бити спроведено упркос овом параметру.
Тестирање имплементације 3Д Сецуре
Можете тестирати 3Д Сецуре везу у било ком тренутку путем нашег система плаћања. Да бисте то урадили, користите режим „ЦОННЕЦТОР_ТЕСТ“ за трансакцију, као што је приказано на прampлес изнад.
Подаци о вези за овај тест:
| БЕЗБЕДНОСТ.СЕНДЕР | 31HA07BC8142C5A171745D00AD63D182 |
| УСЕР.ЛОГИН | 31ha07bc8142c5a171744e5aef11ffd3 |
| УСЕР.ПВД | 93167ДЕ7 |
| ТРАНСАКЦИЈА.КАНАЛ | 31HA07BC8142C5A171749A60D979B6E4 |
| Валуте конфигурисане за 3Д верзију 2 | ЕУР, УСД, СЕК |
| Валуте конфигурисане за 3Д верзију 1 | ГБП, ЦЗК, ЦХФ |
Крајња тачка системског мрежног пролаза је или
СГВ капија:
– хттпс://тест-хеиделпаи.хпцгв.нет/сгв/гтв – кодирано латиницом-15
– хттпс://тест-хеиделпаи.хпцгв.нет/сгв/гтву – УТФ-8 кодирано
НГВ капија:
– хттпс://тест-хеиделпаи.хпцгв.нет/нгв/пост
Подаци о кредитној картици за овај тест:
| брендова | бројеви картица | ЦВВ | датум истека | напомена |
| МастерЦард | 5453010000059543 | 123 | будући датум | 3Д – лозинка: сецрет3 |
| Виса | 4711100000000000 | 123 | будући датум | 3ДС – лозинка: тајна!33 |
Имајте на уму: За 3Д Сецуре верзију 2, не морате да уносите лозинку, већ једноставно кликните на везу „Кликните овде да бисте завршили аутентификацију.
Једини начин да се симулира грешка са 3Д Сецуре верзијом 2 је да се страница са линком остави да истекне (приближно 18 минута).
Прочитајте више о овом приручнику и преузмите ПДФ:
Документи / Ресурси
 |
Водич за интеграцију софтвера 3Д Сецуре [пдфДокументација Унзер, Водич за интеграцију, 3Д Сецуре |
