Dasturlar 3D Secure Integration Guide Documentation
3D Secure integratsiya qo'llanmasi
01.01.2021 yildan boshlab ikki faktorli autentifikatsiya bo'yicha barcha elektron tijorat kartalari to'lovlari uchun majburiy talab sifatida amalga oshiriladi. Ushbu majburiyatni bajarish uchun,
kredit karta tarmoqlari operatorlari 3D Secure protsedurasidan foydalanadilar. Siz uchun savdogar sifatida ushbu protsedurani mijozlaringiz uchun amalga oshirishi shart
01.01.2021 yil. Quyida siz turli xil integratsiya usullari va ular uchun 3D Secure protsedurasini qanday amalga oshirish kerakligi haqida ma'lumot topasiz.
Iltimos, foydalanadigan integratsiya usulini tanlang
- Siz hCO kassa shaklidan foydalanayapsizmi?
- Siz hPF to'lov shaklidan foydalanayapsizmi?
- Siz Unzer tizimi tomonidan taqdim etilgan shakldan foydalanmasdan to'lovlarni amalga oshirasizmi?
Esda tuting: Shuningdek, debetlar yoki avtorizatsiya (zaxiralar) qaysi usulda amalga oshirilishi ham muhimdir. Karta ma'lumotlarini ro'yxatdan o'tkazish uchun Unzer GmbH kompaniyasining to'lov shaklidan foydalansangiz ham, 3D Secure jarayoni karta ma'lumotlari birinchi marta debetlanganda yoki birinchi marta avtorizatsiya qilinganda to'lov shaklisiz amalga oshiriladi. Bunday holda, Unzer tomonidan taqdim etilgan shaklsiz integratsiyaning uchinchi usuli qo'llaniladi.
Iltimos, diqqat qiling:
Agar siz takroriy to'lovlardan (obuna to'lovlari) foydalansangiz, "3D xavfsiz va takroriy to'lov" bo'limini o'qishni unutmang.
HCO to'lov shaklidan foydalanganda 3D Secure protsedurasi
HCO to'lov shakli allaqachon 3D Secure protsedurasi uchun mo'ljallangan. Jarayonni amalga oshirish uchun siz tomondan qo'shimcha harakatlar talab qilinmaydi. Biroq, siz
3D Secure jarayoni boshlangan taqdirda sizning tizimingiz bizning to'lov tizimimizning tegishli javoblari bilan ishlashiga ishonch hosil qilishingiz kerak. Asenkron javobda
to'lov tizimi sizning serveringizga, operatsiya natijasi uzatiladi va qaytib kelishidan oldin u erda baholanishi kerak URL to'lov tizimiga uzatiladi.
Buning uchun quyidagi parametrlarni baholash kerak.
- Qayta ishlash. Qaytish.KOD = 000.200.000
- PROCESSING.RETURN = Tranzaksiya + kutilmoqda
- Qayta ishlash .Natija = ACK
Tushuntirish: bitimning holati "kutilmoqda", PROCESSING.RESULT parametri
faqat dastlabki natijani anglatadi. 3D Secure jarayoni amalga oshirilguncha, holat
kutishda qoling.
Bitimning yakuniy natijasi keyin ham bo'ladi
- Qayta ishlash. Qaytish.KOD = 000.000.000
- Qayta ishlash .Natija = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 yoki 000.200.000
- Qayta ishlash. Natija = NOK
Birinchi holda tranzaksiya muvaffaqiyatli yakunlandi, ikkinchi holda u umuman muvaffaqiyatsiz tugadi. Ikkinchisi turli xil sabablarga ega bo'lishi mumkin, shu jumladan autentifikatsiya qilishni rad etish. Siz .. qilasiz
"PROCESSING.RETURN" va "PROCESSING.RETURN.CODE" parametrlari bo'yicha batafsil ma'lumot olish.
Ikkala xabar uchun sinov o'tkazishingizni tavsiya qilamiz. Sinovni qanday o'tkazish va qaysi kredit karta tafsilotlarini sinab ko'rish uchun ishlatishingiz mumkinligi haqida qo'shimcha ma'lumot olish uchun quyida ko'rib chiqing.
HP Secure formasini ishlatishda 3D Secure protsedurasi
HPF to'lov shakli allaqachon 3DS protsedurasidan foydalanish uchun mo'ljallangan. Jarayonni amalga oshirish uchun siz tomondan qo'shimcha harakatlar talab qilinmaydi. Ta'riflanganidek
hCO-ni amalga oshirish uchun to'lov tizimidan javob ikki bosqichda amalga oshiriladi, shuning uchun sizning tizimingiz PROCESSING.RETURN.CODE qiymatini tekshirishi kerak
javobni qayta ishlashda parametr.
Buning uchun quyidagi parametrlarni baholash kerak.
- Qayta ishlash. Qaytish.KOD = 000.200.000
- PROCESSING.RETURN = Tranzaksiya + kutilmoqda
- Qayta ishlash .Natija = ACK
Izoh: bitimning holati "kutilmoqda", PROCESSING.RESULT parametri faqat dastlabki natijani anglatadi. 3D Secure jarayoni amalga oshirilguncha, holat
kutishda qoling.
Bitimning yakuniy natijasi keyin ham bo'ladi
- Qayta ishlash. Qaytish.KOD = 000.000.000
- Qayta ishlash .Natija = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 yoki 000.200.000
- Qayta ishlash. Natija = NOK
Birinchi holda tranzaksiya muvaffaqiyatli yakunlandi, ikkinchi holda u umuman muvaffaqiyatsiz tugadi. Ikkinchisi turli xil sabablarga ega bo'lishi mumkin, shu jumladan autentifikatsiya qilishni rad etish. Siz .. qilasiz
"PROCESSING.RETURN" va "PROCESSING.RETURN.CODE" parametrlari bo'yicha batafsil ma'lumot olish.
Ikkala xabar uchun sinov o'tkazishingizni tavsiya qilamiz. Sinovni qanday o'tkazish va qaysi kredit karta tafsilotlarini sinab ko'rish uchun ishlatishingiz mumkinligi haqida qo'shimcha ma'lumot olish uchun quyida ko'rib chiqing.
To'g'ridan-to'g'ri ulanish bilan 3D Secure protsedurasi
Agar siz kredit karta to'lovlarini amalga oshirish uchun Unzer (ilgari heidelpay) tomonidan taqdim etilgan to'lov shaklidan foydalanmasangiz yoki siz shunchaki kartalardan birortasidan foydalangan holda ro'yxatdan o'tkazsangiz va avtorizatsiyani (zahirani) yoki debetni rasmiylashtirsangiz, to'lov tizimi bilan to'g'ridan-to'g'ri aloqa, siz 3D Secure jarayonini amalga oshirishingiz kerak.
Asenkron tranzaksiya oqimi:
Bu sizning serveringiz yo'naltirishni qabul qiladigan asenkron jarayon URL (Yo'naltirish URL) bizning to'lov tizimimizdan. Sizning serveringiz mijozni bunga yo'naltirishi kerak URL u autentifikatsiyani 3D Secure protsedurasi orqali amalga oshirishi uchun. Ushbu 3D Secure autentifikatsiyasi natijasi to'g'ridan-to'g'ri kartani chiqaruvchi bank tomonidan Unzerga xabar qilinadi.
Muvaffaqiyatli autentifikatsiya qilinganidan so'ng, tranzaksiya Unzer tizimida siz allaqachon bilgan usulda qayta ishlanadi, natijada tizimingizga umumiy natijani yuborasiz va siz unga javob berasiz.
yo'naltirish bilan URL. Keyin to'lov tizimi mijozni ushbu yo'naltirish yordamida tizimingizga qaytaradi URL tizimingizdan
Iltimos, diqqat qiling: ushbu ish jarayonida sizning tizimingiz to'lov tizimidan ikkita javob oladi:
- "kutish" maqomiga ega bo'lgan (PROCESSING.RETURN.CODE = 000.200.000 va PROCESSING.RETURN = Transaction + pending) va mijozning kartani chiqaruvchi bankiga yo'naltirish parametrlari.
- debet yoki zahiraning yakuniy natijasi bilan bittasi. Shuningdek, ikkita yo'naltirish mavjud URLUshbu jarayonda aytib o'tilganlar, mijozning tizimiga qayta yo'naltirish uchun oxirgi natijani olganda, mijoz sizning kartangizni chiqaradigan bankda sizning tizimingizdan autentifikatsiya qilish uchun yo'naltirilishi kerak bo'lgan to'lov tizimidan biri.
Oddiy protseduraga quyidagi o'zgarishlar kiritiladi. Iltimos, Paypal kabi boshqa asenkron to'lov usullari amalga oshirilganligi sababli, ulardan ba'zilari
amalga oshirishda allaqachon jarayonlar mavjud bo'lishi mumkin.
- Javob URL
To'lov tizimiga birinchi qo'ng'iroqda (diagrammada №2) "Javob URL"Oldingi guruhda topshirilishi kerak.
Esda tuting: IDENTIFICATION.REFERENCEID parametri faqat ro'yxatdan o'tishga yoki allaqachon mavjud bo'lgan boshqa tranzaktsiyaga murojaat qilganingizda tegishli bo'ladi. - Qayta yo'naltirishni qayta ishlash URL Agar autentifikatsiya talab etilsa, yo'naltirish URL va yo'naltirish guruhidagi boshqa parametrlar to'lov tizimidagi javobda uzatiladi (diagrammada №5).
- Mijozni yo'naltirishga yo'naltirish URL
Agar yo'naltirish guruhi qayta yo'naltirish bilan javob bersa URL, mijozning brauzeri bunga yo'naltirilishi kerak URL (Diagrammada 6 -raqam) autentifikatsiyani bajarish uchun. Qayta yo'naltirish guruhining qo'shimcha parametrlari tashqi parametrlarga o'tkazilishi kerak webPOST parametrlari sifatida sayt.
Iltimos, diqqat qiling: qo'shimcha parametrlar "PROCESSING.REDIRECT.xxx" guruhiga faqat 3D Secure Version 1 bilan qaytariladi (hatto u erda raqam va nomlash o'zgarishi mumkin), 3D Version 2 bilan esa faqat PROCESSING.REDIRECT.URL quyida ko'rsatilganidek qaytarildi: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Bu shuni anglatadiki, parametr turi va sonidan qat'i nazar, mijoz brauzeri PROCESSING.REDIRECT-ga yo'naltirilishi kerak.URL.
Quyida siz oddiy kodni topasizampBunday qayta yo'naltirishni qanday bajarish mumkinligi haqida. The qismi JavaScript -ni qo'llab -quvvatlamaydigan yoki o'chirilgan oxirgi mijozlarga xabar berish uchun mo'ljallangan. Qayta yo'naltirishni mijozning faol brauzer oynasida amalga oshirishni tavsiya qilamiz va ochilgan oynalarni yoki yangi brauzer oynalarini ishlatmaslik kerak.
mijozlarni g'azablantiradi va ularni yo'naltirilgan sahifani yopishga olib keladi.
- Asenkron natijalarni tekshirish
Autentifikatsiya natijasi sizning serveringizga asenkron tarzda yuboriladi. To'lov tizimi amal qilishini kutmoqda URL javob sifatida. (Diagrammada № 12 va 13). Muvaffaqiyatli yoki rad etilganlar uchun
to'lovlar, boshqacha URL sizning tizimingiz bu erda javob berishi mumkin. - Mijozning qaytish yo'li
To'lov tizimi mijozni qayta yo'naltiradi URL autentifikatsiya jarayoni va to'lov operatsiyasi tugagandan so'ng savdogar tizimi tomonidan taqdim etiladi.
Iltimos, e'tibor bering: 4.) va 5.) amaldagi NONE 3D Secure tranzaktsiyalarida allaqachon tanish bo'lganingiz kabi davom eting.
3D xavfsiz va takroriy to'lov
1 yil 2021-yanvardan boshlab 3D Secure elektron tijorat kartalari bo'yicha barcha operatsiyalar uchun majburiy bo'ladi. Biroq, bu takroriy to'lovlar uchun deyarli qo'llanilmaydi, chunki bank
tizimlar buning uchun alohida ish oqimiga ega.
Shu maqsadda banklar bir-biridan ajratib turadi
- CIT = mijoz tomonidan boshlangan operatsiyalar
- MIT = savdogar tomonidan boshlangan operatsiyalar
Savdo hisobvarag'ingizdagi kartaning birinchi operatsiyasi 3 dan boshlab 01.01.2021D Secure orqali tasdiqlanishi kerak. Bunday muvaffaqiyatli autentifikatsiya qilish majburiy talab hisoblanadi
keyinchalik 3D Secure-dan tashqari o'sha kartada boshqa bronlarni yuborish imkoniyatiga ega bo'lish. Shuning uchun mijoz birinchi debet uchun kartani chiqargan bankka yuborilishi kerak
yuqorida tavsiflangan protseduraga muvofiq va u erda o'zini karta egasi sifatida tasdiqlaydi. Agar buyurtma vaqtida debet rejalashtirilmagan bo'lsa, masalanampsinov muddati tufayli, uning o'rniga mijoz ishtirokida 3D Secure yordamida kamida bitta evroga rezervasyon (oldindan avtorizatsiya) qilish kerak. Bu rezervatsiyani yozib olish shart emas.
Ammo mavjud mijozlar uchun 3D Secure autentifikatsiyasini tuzish kerak emas. Agar birinchi muvaffaqiyatli debet 01.01.2021 yilgacha sodir bo'lgan bo'lsa, mijozlar yozuvlari ham qabul qilinishi mumkin
muvaffaqiyatli tasdiqlandi. Boshqa tomondan, 01.01.2021 yil holatiga ko'ra, 3D Secure autentifikatsiyasi birinchi debet yoki bron (oldindan avtorizatsiya) uchun majburiydir.
E'tibor bering: bank tizimi mijozlar ma'lumotlariga emas, balki karta ma'lumotlariga qaraydi. Agar mavjud mijoz 01.01.2021 yildan keyin yangi kartadan foydalansa, masalanample chunki oldingi
birining muddati tugagan yoki u kartani chiqaruvchi bankini o'zgartirgani uchun, bu banklar tomonidan yangi davriy tsikl. view va birinchi rezervasyon uchun 3D Secure bilan tasdiqlangan bo'lishi kerak.
Ushbu dastlabki autentifikatsiya muvaffaqiyatli amalga oshirilgandan so'ng, boshqa barcha tranzaksiyalar 3D Secure-dan foydalanish majburiyatidan ozod qilinadi 3D Secure holda takroriy to'lovni amalga oshirish uchun zarur shartlar quyidagilar:
- 3D Secure yordamida amalga oshirilgan yoki 01.01.2021 yilgacha bo'lgan kamida bitta muvaffaqiyatli debet yoki bron (oldindan avtorizatsiya) mavjud.
- u mavjud bo'lgan ro'yxatga olish va taqdim etilgandan keyin debetga ishora qiladi
To'lov tizimiga bu takroriy to'lov ekanligini bilish uchun RECURRENCE.MODE = REPEATED parametri ham yuborilishi kerak. Bu tizimga signal beradi
takroriy to'lov haqida bank tizimlariga xabar berish kerak.
Iltimos, diqqat qiling: agar yangi karta birinchi marta yuklanganda RECURRENCE.MODE = REPEATED parametri kiritilsa, ushbu parametrga qaramay 3D Secure yo'naltirish amalga oshiriladi.
3D Secure dasturini sinovdan o'tkazish
3D Secure ulanishini istalgan vaqtda bizning to'lov tizimimiz orqali sinab ko'rishingiz mumkin. Buni amalga oshirish uchun, avvalgi rasmda ko'rsatilgandek, "CONNECTOR_TEST" rejimidan foydalaningampyuqorida.
Ushbu test uchun ulanish ma'lumotlari:
| XAVFSIZLIK | 31HA07BC8142C5A171745D00AD63D182 |
| FOYDALANISh.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TARJIMA KANALI | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D versiyasi 2 uchun tuzilgan valyutalar | EUR, USD, SEK |
| 3D versiyasi 1 uchun tuzilgan valyutalar | GBP, CZK, CHF |
Tizim shlyuzining so'nggi nuqtasi ham
SGW shlyuzi:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Lotin-15 kodlangan
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kodlangan
NGW shlyuzi:
- https://test-heidelpay.hpcgw.net/ngw/post
Ushbu test uchun kredit karta ma'lumotlari:
| brendlar | karta raqamlari | CVV | quyidagi sanagacha foydalanilsin | Eslatma |
| MasterCard | 5453010000059543 | 123 | kelajak sana | 3D - parol: maxfiy3 |
| Viza | 4711100000000000 | 123 | kelajak sana | 3. parol: maxfiy! |
Iltimos, diqqat qiling: 3D Secure Version 2 uchun parolni kiritishingiz shart emas, shunchaki havolani bosing ”Autentifikatsiyani yakunlash uchun shu erni bosing.
Xatolarni 3D Secure Version 2 bilan simulyatsiya qilishning yagona usuli bu sahifani havola muddati tugashi bilan ta'minlash (taxminan 18 daqiqa).
Ushbu qo'llanma haqida ko'proq o'qing va PDF formatini yuklab oling:
Hujjatlar / manbalar
 |
Dasturiy ta'minot 3D Secure integratsiya qo'llanma [pdf] Hujjatlar Unzer, integratsiya qo'llanmasi, 3D Secure |
