Программалык камсыздоо 3D Secure Integration Guide Documentation
Integration Guide 3D Secure
01.01.2021-жылдан тартып эки фактордук аутентификация электрондук соода карталарын төлөө боюнча бардык транзакциялар үчүн милдеттүү талап катары ишке ашырылат. Бул милдеттенмени аткаруу үчүн,
кредиттик карталардын операторлору 3D Secure процедурасы деп аталат. Соодагер катары сиз үчүн кардарлар үчүн бул процедураны жүргүзүү милдеттүү
01.01.2021. Төмөндө сиз интеграциянын ар кандай жолдору жана алар үчүн 3D Secure процедурасы кандайча жүзөгө ашырылышы керектиги жөнүндө баяндайт.
Сураныч, сиз колдонгон интеграциялоо ыкмасын тандаңыз
- HCO эсептөө формасын колдонуп жатасызбы?
- HPF чыгуу формасын колдонуп жатасызбы?
- Унзер системасы тарабынан берилген форманы колдонбостон, сиз төлөмдөрдү иштеп чыгасызбы?
Эскертүү: Дебет же алдын-ала авторизация (эскертүүлөр) кандай жол менен жүргүзүлө тургандыгы да маанилүү. Карталар жөнүндө маалыматтарды каттоо үчүн Unzer GmbH компаниясынын төлөө формасын колдонгон күндө дагы, 3D Secure процесси картанын маалыматтары биринчи жолу дебеттелгенде же биринчи жолу уруксат берилгенде, кассасыз жүргүзүлөт. Бул учурда, Унзер берген формасыз интеграциянын үчүнчү жолу колдонулат.
Ошондой эле көңүл буруңуз:
Эгер сиз кайталанма төлөмдөрдү (жазылуу төлөмдөрү) колдонсоңуз, анда “3D коопсуз жана кайталанма төлөм” бөлүмүн окуп чыгыңыз.
HCO эсептөө формасын колдонууда 3D Secure процедурасы
HCO текшерүү формасы буга чейин 3D Secure процедурасы үчүн иштелип чыккан. Процедураны ишке ашыруу үчүн сиз тараптан кошумча иш-аракеттер талап кылынбайт. Бирок, сиз
3D Secure процесси башталган учурда, сиздин системаңыз биздин төлөм системабыздын тиешелүү жоопторун аткара аларына ынанууңуз керек. Асинхрондук жоопто
Сиздин серверге төлөм системасы, транзакциянын жыйынтыгы берилет жана кайтып келгенге чейин ошол жерде бааланууга тийиш URL төлөм тутумуна берилет.
Бул үчүн төмөнкү параметрлерди баалоо керек.
- ӨНДҮРҮҮ.КАЙТАРУУ.КОД = 000.200.000
- PROCESSING.RETURN = Транзакция + күтүлүүдө
- PROCESSING.RESULT = ACK
Түшүндүрмө: бүтүмдүн абалы "күтүлүүдө", параметр PROCESSING.RESULT
алдын-ала жыйынтыкты гана билдирет. 3D Secure процесси жүргүзүлүп жатканда, статус
күтүлүүдө.
Транзакциянын акыркы жыйынтыгы ошондо дагы болот
- ӨНДҮРҮҮ.КАЙТАРУУ.КОД = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 же 000.200.000
- ПРОЦЕССТИК НАТЫЙЖА = NOK
Биринчи учурда транзакция ийгиликтүү аяктады, экинчи учурда ал жалпысынан ишке ашпай калды. Акыркы ар кандай себептер болушу мүмкүн, анын ичинде аутентификациядан баш тартуу. Сиз кыласыз
"PROCESSING.RETURN" жана "PROCESSING.RETURN.CODE" параметрлеринде кененирээк маалымат алуу.
Эки билдирүү үчүн тең тестирлөө жүргүзүүнү сунуштайбыз. Тестти кантип жасоо керек жана кредиттик картанын кайсы деталдарын тестирлөө үчүн колдонсо болору жөнүндө көбүрөөк маалымат алуу үчүн, төмөндө караңыз.
HPF чыгуу формасын колдонууда 3D Secure процедурасы
HPF эсептөө формасы буга чейин 3DS процедурасын колдонуу үчүн иштелип чыккан. Процедураны ишке ашыруу үчүн сиз тараптан кошумча иш-аракеттер жок. Сүрөттөлгөндөй
hCO ишке ашыруу үчүн төлөм системасынан жооп эки этапта жүрөт, ошондуктан сиздин системаңыз PROCESSING.RETURN.CODE маанисин текшерип турушу керек
жоопту иштеп жатканда параметр.
Бул үчүн төмөнкү параметрлерди баалоо керек.
- ӨНДҮРҮҮ.КАЙТАРУУ.КОД = 000.200.000
- PROCESSING.RETURN = Транзакция + күтүлүүдө
- PROCESSING.RESULT = ACK
Түшүндүрмө: Транзакциянын абалы "күтүлүүдө", PROCESSING.RESULT параметри алдын ала жыйынтыкты гана билдирет. 3D Secure процесси жүргүзүлүп жатканда, статус
күтүлүүдө.
Транзакциянын акыркы жыйынтыгы ошондо дагы болот
- ӨНДҮРҮҮ.КАЙТАРУУ.КОД = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 же 000.200.000
- ПРОЦЕССТИК НАТЫЙЖА = NOK
Биринчи учурда транзакция ийгиликтүү аяктады, экинчи учурда ал жалпысынан ишке ашпай калды. Акыркы ар кандай себептер болушу мүмкүн, анын ичинде аутентификациядан баш тартуу. Сиз кыласыз
"PROCESSING.RETURN" жана "PROCESSING.RETURN.CODE" параметрлеринде кененирээк маалымат алуу.
Эки билдирүү үчүн тең тестирлөө жүргүзүүнү сунуштайбыз. Тестти кантип жасоо керек жана кредиттик картанын кайсы деталдарын тестирлөө үчүн колдонсо болору жөнүндө көбүрөөк маалымат алуу үчүн, төмөндө караңыз.
Түз байланыш менен 3D Secure процедурасы
Эгерде сиз кредиттик төлөмдөрдү иштеп чыгуу үчүн Унзер (мурунку heidelpay) тарабынан берилген төлөм формасын колдонбосоңуз, же жөн гана бланктардын бирин колдонуп, картаны каттоодон өткөрүп, алдын-ала авторизацияны (брондоону) же дебетти иштетип, каттоо катары шилтеме катары төлөм системасы менен түздөн-түз байланышуу, сиз 3D Secure жараянын ишке ашыруу керек.
Асинхрондук бүтүм агымы:
Бул сиздин сервер багыттаманы алган асинхрондук процесс URL (Багыттама URL) биздин төлөм тутумунан. Сиздин сервер кардарыңызды буга багыттоосу керек URL ошондо ал 3D Secure процедурасы аркылуу аутентификациядан өткөрө алат. Бул 3D Secure аутентификациясынын натыйжасы жөнүндө картаны чыгарган банк Unzerге түздөн-түз билдирет.
Ийгиликтүү аутентификациядан кийин, транзакция мындан ары Унзер тутумунда сиз билгендей жол менен иштелип чыгып, жыйынтыгында сиздин системаңызга жалпы жыйынтык жөнөтүлүп, сиз жооп бересиз.
багыттоо менен URL. Андан кийин төлөө тутуму ушул багыттаманы колдонуп, кардарды кайра сиздин системаңызга багыттайт URL сиздин системаңыздан
Көңүл буруңуз: Бул жумуш процессинде сиздин системаңыз төлөм системасынан эки жооп алат:
- "күтүүдө" статусу бар (PROCESSING.RETURN.CODE = 000.200.000 жана PROCESSING.RETURN = Транзакция + күтүүдө) жана кардардын карточка чыгарган банкына багыттоо параметрлери.
- дебеттин же броньдоонун акыркы жыйынтыгы менен. Ошондой эле эки багыттоо бар URLБул процессте айтылган, кардардын банк тутумунда аутентификациядан өтүү үчүн төлөм тутумунун бирөөсүн, анын карточкаларын чыгарган банкта жана сиздин системаңыздан бирөөнү, акыркы натыйжаны алганда, кардарыңызды өз тутумуна кайра багыттоо үчүн.
Кадимки процедурага төмөнкүдөй өзгөртүүлөр киргизилет. Paypal сыяктуу башка асинхрондук төлөм ыкмаларын ишке ашырууга байланыштуу, алардын айрымдарынын бар экендигин эске алыңыз
Сиздин ишке ашырууда буга чейин процесстер болушу мүмкүн.
- Жооп URL
Төлөм тутумуна биринчи чалууда (схемада №2), “Жооп URL”Алдыңкы топто өтүшү керек.
Эскертүү: IDENTIFICATION.REFERENCEID параметри каттоого же буга чейин болгон башка транзакцияга шилтеме бергенде гана тиешелүү болот. - Багыттаманы иштетүү URL Эгер аутентификация талап кылынса, анда багыттоо URL жана башка багыттоо тобундагы параметрлер төлөм системасынан алынган жоопто которулат (диаграммада No5).
- Кардарды багыттоого багыттоо URL
Эгер багыттоо тобу багыттоо менен жооп берип жатса URL, кардардын браузери буга багытталышы керек URL (Диаграммада No 6) аныктыгын текшерүү үчүн. Багыттоо тобунун кошумча параметрлери тышкыге өткөрүлүп берилиши керек webPOST параметрлери катары сайт.
Эскертүү: Кошумча параметрлер "PROCESSING.REDIRECT.xxx" тобуна 3D Secure Version 1 менен гана кайтарылат (ал жакта алардын саны жана аталышы ар кандай болушу мүмкүн), ал эми 3D Version 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" режимин колдонуңузamples жогоруда.
Бул тест үчүн туташуу маалыматтары:
| SECURITY.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| USER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSACTION.CHANNEL | 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 |
| Visa | 4711100000000000 | 123 | келечектеги күн | 3 |
Эскертүү: 3D Secure Version 2 үчүн сыр сөздү киргизүүнүн кажети жок, болгону шилтемени чыкылдатыңыз ”Аныктыгын тастыктоо үчүн бул жерди басыңыз.
Катаны 3D Secure Version 2 менен окшоштуруунун бирден-бир жолу - шилтемедеги убакыттын өтүшү менен баракчага жол берүү (болжол менен 18 мүнөт).
Бул колдонмо жөнүндө көбүрөөк окуу жана PDF жүктөп алуу:
Документтер / Ресурстар
 |
Программалык камсыздоо 3D Secure Интеграциясынын Жетекчиси [pdf] Документация Unzer, Integration Guide, 3D Secure |
