Бағдарламалық жасақтама 3D қауіпсіз интеграциялау бойынша құжаттама
3D Secure интеграциялық нұсқаулығы
01.01.2021 ж. Бастап екі факторлы аутентификация барлық электронды сауда карточкалары бойынша төлем операциялары үшін міндетті талап ретінде енгізілетін болады. Осы міндеттемені орындау үшін
несиелік карталар операторлары 3D Secure деп аталатын процедураны қолданады. Сіз үшін саудагер ретінде клиенттер үшін осы процедураны жүзеге асыруға міндетті
01.01.2021. Төменде сіз интеграцияның әртүрлі тәсілдерінің сипаттамасын және олар үшін 3D Secure процедурасын қалай жүзеге асыруға болатындығын білесіз.
Сіз қолданатын интеграция әдісін таңдаңыз
- Сіз hCO кассалық формасын қолданасыз ба?
- Сіз hPF кассалық формасын қолданасыз ба?
- Сіз Unzer жүйесі ұсынған форманы қолданбай төлем жасайсыз ба?
Ескерту: Сондай-ақ дебет немесе алдын-ала авторизация (ескертулер) қандай жолмен жасалатыны маңызды. Карточкалық деректерді тіркеу үшін сіз Unzer GmbH компаниясының төлем формасын қолдансаңыз да, 3D Secure процедурасы карта деректері бірінші рет дебеттелгенде немесе бірінші рет авторизацияланған кезде кассасыз жүзеге асырылады. Бұл жағдайда Унзер ұсынған формасыз интеграцияның үшінші тәсілі қолданылады.
Назар аударыңыз:
Егер сіз қайталанатын төлемдерді қолдансаңыз (жазылым төлемдері), міндетті түрде «3D қауіпсіз және қайталанатын төлем» бөлімін оқып шығыңыз.
HCO төлем нысанын пайдалану кезінде 3D Secure процедурасы
HCO төлем формасы 3D Secure процедурасына арналған. Процедураны жүзеге асыру үшін сіздің тарапыңыздан ешқандай қосымша әрекет қажет емес. Алайда, сіз
3D Secure процесі басталған жағдайда сіздің жүйеңіз біздің төлем жүйесінің тиісті жауаптарын қабылдай алатындығына сенімді болуыңыз керек. Асинхронды жауапта
төлем жүйесі сіздің серверіңізге, транзакцияның нәтижесі жіберіледі және оны қайтарылғанға дейін сол жерде бағалау керек URL төлем жүйесіне беріледі.
Ол үшін келесі параметрлерді бағалау қажет.
- ӨҢДЕУ.ҚАЙТАРУ.КОД = 000.200.000
- ӨҢДЕУ.RETURN = Транзакция + күтуде
- ӨҢДЕУ.НӘТИЖЕ = ACK
Түсініктеме: мәміленің күйі «күтілуде», параметрі PROCESSING.RESULT
тек алдын-ала нәтижені білдіреді. 3D Secure процесі жүзеге асырылғанша, мәртебе
күтілуде.
Транзакцияның соңғы нәтижесі сол кезде болады
- ӨҢДЕУ.ҚАЙТАРУ.КОД = 000.000.000
- ӨҢДЕУ.НӘТИЖЕ = ACK
or - ӨҢДЕУ.RETURN.CODE = irgendein Wert ungleich 000.000.000 немесе 000.200.000
- ӨҢДЕУ.НӘТИЖЕ = NOK
Бірінші жағдайда мәміле сәтті аяқталды, екінші жағдайда ол сәтсіз аяқталды. Соңғысы әр түрлі себептерге, соның ішінде аутентификациядан бас тартуға әкелуі мүмкін. Сіз істейсіз
«ӨҢДЕУ.ҚАЙТАРУ» және «ӨНДІРУ.ҚАЙТАРУ.КОД» параметрлерінен толығырақ ақпарат алыңыз.
Екі хабарламаға да тест жүргізуге кеңес береміз. Тестті қалай жасау керектігі және несиелік картаның қандай мәліметтерін тестілеу үшін пайдалануға болатыны туралы қосымша ақпаратты төменде қараңыз.
HPF шығу формасын пайдалану кезінде 3D Secure процедурасы
HPF кассалық формасы 3DS процедурасын қазірдің өзінде қолдануға арналған. Процедураны жүзеге асыру үшін сіздің тарапыңыздан ешқандай қосымша әрекет қажет емес. Сипатталғандай
hCO-ны іске асыру үшін төлем жүйесінен жауап екі кезеңде жүреді, сондықтан сіздің жүйеңіз PROCESSING.RETURN.CODE мәнін тексеруі керек
жауап өңдеу кезінде параметр.
Ол үшін келесі параметрлерді бағалау қажет.
- ӨҢДЕУ.ҚАЙТАРУ.КОД = 000.200.000
- ӨҢДЕУ.RETURN = Транзакция + күтуде
- ӨҢДЕУ.НӘТИЖЕ = ACK
Түсініктеме: транзакцияның күйі «күтілуде», PROCESSING.RESULT параметрі тек алдын ала нәтижені білдіреді. 3D Secure процесі жүзеге асырылғанша, мәртебе
күтілуде.
Транзакцияның соңғы нәтижесі сол кезде болады
- ӨҢДЕУ.ҚАЙТАРУ.КОД = 000.000.000
- ӨҢДЕУ.НӘТИЖЕ = ACK
or - ӨҢДЕУ.RETURN.CODE = irgendein Wert ungleich 000.000.000 немесе 000.200.000
- ӨҢДЕУ.НӘТИЖЕ = NOK
Бірінші жағдайда мәміле сәтті аяқталды, екінші жағдайда ол сәтсіз аяқталды. Соңғысы әр түрлі себептерге, соның ішінде аутентификациядан бас тартуға әкелуі мүмкін. Сіз істейсіз
«ӨҢДЕУ.ҚАЙТАРУ» және «ӨНДІРУ.ҚАЙТАРУ.КОД» параметрлерінен толығырақ ақпарат алыңыз.
Екі хабарламаға да тест жүргізуге кеңес береміз. Тестті қалай жасау керектігі және несиелік картаның қандай мәліметтерін тестілеу үшін пайдалануға болатыны туралы қосымша ақпаратты төменде қараңыз.
Тікелей қосылымы бар 3D Secure процедурасы
Егер сіз несие карточкалары бойынша төлемдерді өңдеу үшін Унзер ұсынған төлем формасын пайдаланбасаңыз (бұрынғы heidelpay) немесе сіз жай ғана карталардың бірінің көмегімен картаны тіркеп, алдын-ала авторизацияны (брондауды) немесе дебетті рәсімдеп, оны тіркеу есебіне сілтеме ретінде қолдансаңыз төлем жүйесімен тікелей байланыс, сіз 3D Secure процесін енгізуіңіз керек.
Асинхронды транзакция ағыны:
Бұл сіздің серверіңіз бағыттауды алатын асинхронды процесс URL (Қайта бағыттау URL) төлем жүйесінен. Сіздің серверіңіз клиентті осыған бағыттауы керек URL ол 3D Secure процедурасы арқылы аутентификацияны жүзеге асыра алады. Осы 3D Secure аутентификациясының нәтижесі туралы карточкаларды шығарушы банк Unzer-ге тікелей хабарлайды.
Сәтті аутентификациядан кейін транзакция бұдан әрі Унцер жүйесінде сіз білетін әдіспен өңделеді, оған сіздің жүйеңізге жалпы нәтиже жіберіледі, оған сіз жауап бересіз.
бағыттаумен URL. Содан кейін төлем жүйесі клиентті осы қайта бағыттаудың көмегімен жүйеңізге қайта бағыттайды URL сіздің жүйеңізден
Назар аударыңыз: бұл жұмыс процесінде сіздің жүйеңіз төлем жүйесінен екі жауап алады:
- «күтілуде» мәртебесі бар (PROCESSING.RETURN.CODE = 000.200.000 және PROCESSING.RETURN = Transaction + pending) және клиенттің карточка шығаратын банкіне қайта бағыттау параметрлері бар.
- дебеттің немесе брондаудың соңғы нәтижесімен бір. Сонымен қатар екі бағыттау бар URLОсы процесте айтылған төлемдер жүйесінен клиентті оның карточкаларын шығаратын банкте аутентификациялау үшін сіздің жүйеңізден біреуін қайта жіберу қажет төлем жүйесінен соңғы нәтиже алған кезде клиентті жүйеңізге қайта бағыттау қажет.
Тұрақты процедураға келесі өзгерістер енгізіледі. Paypal сияқты басқа асинхронды төлем әдістерін қолдануға байланысты олардың кейбіреулері бар екенін ескеріңіз
процестер сіздің іске асырылуыңызда болуы мүмкін.
- Жауап URL
Төлем жүйесіне бірінші қоңырауда (диаграммада №2) «Жауап URL”Алдыңғы топта өту керек.
Ескерту: IDENTIFICATION.REFERENCEID параметрі тек тіркеуге немесе бұрыннан бар транзакцияға сілтеме жасаған жағдайда ғана маңызды болады. - Қайта бағыттауды өңдеу URL Егер аутентификация қажет болса, қайта бағыттаңыз URL және қайта бағыттау тобындағы басқа параметрлер төлем жүйесіндегі жауапта беріледі (диаграммада №5).
- Тапсырыс берушіні қайта бағыттауға бағыттау URL
Егер қайта бағыттау тобы қайта бағыттаумен жауап берсе URL, клиенттің шолушысы осыған бағытталуы керек URL (диаграммадағы No6) аутентификацияны орындау үшін. Қайта бағыттау тобының қосымша параметрлері сыртқыға жіберілуі керек webPOST параметрлері ретінде сайт.
Пожалуйста, назар аударыңыз: «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 = саудагерлердің бастамашылық операциялары
Сіздің сауда шотыңыздағы картаның алғашқы транзакциясы 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 Secure қайта бағыттау жүзеге асырылады.
3D Secure іске асырылуын тексеру
3D Secure қосылымын кез келген уақытта біздің төлем жүйеміз арқылы тексере аласыз. Мұны істеу үшін транзакция үшін «CONNECTOR_TEST» режимін пайдаланыңыз, мысалыampжоғарыда.
Осы тест үшін қосылым деректері:
| ҚАУІПСІЗДІК | 31HA07BC8142C5A171745D00AD63D182 |
| ПАЙДАЛАНУШЫ | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.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 - құпия сөз: құпия3 |
| Виза | 4711100000000000 | 123 | болашақ күн | 3 |
Назар аударыңыз: 3D Secure 2 нұсқасы үшін сізге пароль енгізудің қажеті жоқ, тек сілтемені басыңыз »Аутентификацияны аяқтау үшін осы жерді басыңыз.
Қатені 3D Secure 2 нұсқасымен имитациялаудың жалғыз жолы - сілтеме уақыты бетті жіберу (шамамен 18 минут).
Осы нұсқаулық туралы толығырақ оқыңыз және PDF файлын жүктеп алыңыз:
Құжаттар / Ресурстар
 |
Бағдарламалық қамтамасыз ету 3D Secure біріктіру нұсқаулығы [pdf] Құжаттама Unzer, біріктіру нұсқаулығы, 3D Secure |
