Proqramlar 3D Secure Integration Guide Documentation
İnteqrasiya Bələdçisi 3D Təhlükəsiz
01.01.2021-ci il tarixindən etibarən bütün e-ticarət kartı ödəmə əməliyyatları üçün məcburi tələb olaraq iki faktorlu identifikasiya tətbiq ediləcəkdir. Bu öhdəliyə riayət etmək üçün
kredit kartı şəbəkələrinin operatorları 3D Secure proseduru deyiləndən istifadə edəcəklər. Bir tacir olaraq sizin üçün müştəriləriniz üçün bu proseduru həyata keçirə bilmək məcburidir
01.01.2021. Aşağıda fərqli inteqrasiya yollarının və onlar üçün 3D Secure prosedurunun necə həyata keçirilməli olduğunu izah edə bilərsiniz.
Xahiş edirəm istifadə etdiyiniz inteqrasiya metodunu seçin
- HCO ödəmə formasını istifadə edirsiniz?
- Hesablama forması hPF istifadə edirsiniz?
- Unzer sistemi tərəfindən verilən formadan istifadə etmədən ödənişləri həyata keçirirsiniz?
Qeyd edək: Debetlərin və ya avtorizasiyaların (qeydlərin) hansı şəkildə aparılması da vacibdir. Kart məlumatlarının qeydiyyatı üçün Unzer GmbH-dan bir ödəmə forması istifadə etsəniz də, 3D Secure prosesi kart məlumatları ilk borc alındıqda və ya ilk dəfə icazə verildikdə, ödəmə forması olmadan həyata keçiriləcəkdir. Bu vəziyyətdə, Unzer tərəfindən verilən bir forma olmadan üçüncü inteqrasiya yolu tətbiq olunur.
Xahiş edirəm unutmayın:
Təkrarlanan ödənişlərdən (abunə ödənişləri) istifadə edirsinizsə, “3D Təhlükəsiz və Təkrar Ödəmə” bölməsini oxuduğunuzdan əmin olun.
HCO ödəmə formasını istifadə edərkən 3D Secure proseduru
HCO ödəmə forması artıq 3D Secure proseduru üçün hazırlanmışdır. Prosedurun həyata keçirilməsi üçün tərəfinizdən əlavə bir hərəkət yoxdur. Ancaq sən
3D Secure prosesi başlandığı təqdirdə sisteminizin ödəmə sistemimizin uyğun cavablarını idarə edə biləcəyinə əmin olmalısınız. Asenkron cavabda
ödəmə sistemi serverinizə göndərilərsə, əməliyyatın nəticəsi ötürülür və geri dönüşdən əvvəl orada qiymətləndirilməlidir URL ödəniş sisteminə ötürülür.
Bunun üçün aşağıdakı parametrlər qiymətləndirilməlidir.
- QAYDALANMA.QAYITMA.KOD = 000.200.000
- PROCESSING.RETURN = Əməliyyat + gözləyir
- QAYDALANMA.NƏTİCƏ = ACK
İzahat: Əməliyyatın vəziyyəti “gözləyir”, PROCESSING.RESULT parametri
yalnız ilkin nəticəni təmsil edir. 3D Secure prosesi həyata keçirildiyi müddətdə vəziyyət
gözləyən qalmaq.
Əməliyyatın son nəticəsi ya bundan sonra olur
- QAYDALANMA.QAYITMA.KOD = 000.000.000
- QAYDALANMA.NƏTİCƏ = ACK
or - QAYDALANMA.QAYITMA.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- QAYDALANMA.NƏTİCƏ = NOK
Birinci halda əməliyyat uğurla başa çatdı, ikinci halda ümumiyyətlə uğursuz oldu. Sonuncunun təsdiqlənməsindən imtina daxil olmaqla müxtəlif səbəbləri ola bilər. Sən ... əcəksən
“PROCESSING.RETURN” və “PROCESSING.RETURN.CODE” parametrlərində daha ətraflı məlumat almaq.
Hər iki mesaj üçün bir test keçirməyinizi məsləhət görürük. Bir testin necə ediləcəyi və test üçün hansı kredit kartı detallarından istifadə edə biləcəyiniz barədə daha çox məlumat üçün xahiş edirəm aşağıya baxın.
HPF ödəmə formasını istifadə edərkən 3D Secure proseduru
HPF ödəmə forması da artıq 3DS prosedurundan istifadə etmək üçün hazırlanmışdır. Prosedurun həyata keçirilməsi üçün tərəfinizdən əlavə bir hərəkət yoxdur. Təsvir edildiyi kimi
hCO tətbiqi üçün ödəniş sistemindən cavab iki mərhələdə baş verir, bu səbəbdən sisteminiz PROCESSING.RETURN.CODE dəyərini yoxlamalıdır.
cavabı işləyərkən parametr.
Bunun üçün aşağıdakı parametrlər qiymətləndirilməlidir.
- QAYDALANMA.QAYITMA.KOD = 000.200.000
- PROCESSING.RETURN = Əməliyyat + gözləyir
- QAYDALANMA.NƏTİCƏ = ACK
İzahat: Əməliyyatın vəziyyəti “gözləyir”, PROCESSING.RESULT parametri yalnız ilkin nəticəni təmsil edir. 3D Secure prosesi həyata keçirildiyi müddətdə vəziyyət
gözləyən qalmaq.
Əməliyyatın son nəticəsi ya bundan sonra olur
- QAYDALANMA.QAYITMA.KOD = 000.000.000
- QAYDALANMA.NƏTİCƏ = ACK
or - QAYDALANMA.QAYITMA.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- QAYDALANMA.NƏTİCƏ = NOK
Birinci halda əməliyyat uğurla başa çatdı, ikinci halda ümumiyyətlə uğursuz oldu. Sonuncunun təsdiqlənməsindən imtina daxil olmaqla müxtəlif səbəbləri ola bilər. Sən ... əcəksən
“PROCESSING.RETURN” və “PROCESSING.RETURN.CODE” parametrlərində daha ətraflı məlumat almaq.
Hər iki mesaj üçün bir test keçirməyinizi məsləhət görürük. Bir testin necə ediləcəyi və test üçün hansı kredit kartı detallarından istifadə edə biləcəyiniz barədə daha çox məlumat üçün xahiş edirəm aşağıya baxın.
Birbaşa əlaqə ilə 3D Secure proseduru
Kredit kartı ödənişlərini həyata keçirmək üçün Unzer (əvvəllər heidelpay) tərəfindən verilən bir ödəmə formasından istifadə etmirsinizsə və ya sadəcə formalardan birini istifadə edərək bir kartı qeydiyyatdan keçirirsinizsə və əvvəlcədən qeydiyyatdan keçmisinizsə (rezervləşdirmə) və ya debetinizi qeydiyyatdan keçmək üçün bir istinad kimi ödəmə sistemi ilə birbaşa ünsiyyət, 3D Secure müddətini tətbiq etməlisiniz.
Asenkron əməliyyat axını:
Bu, serverinizin yönləndirmə aldığı asinxron bir prosesdir URL (Yönləndirmə URL) ödəmə sistemimizdən. Serveriniz müştərini buna yönəltməlidir URL beləliklə 3D Secure proseduru vasitəsilə identifikasiyanı həyata keçirə bilər. Bu 3D Secure identifikasiyasının nəticəsi birbaşa kart verən bank tərəfindən Unzer-ə bildirilir.
Uğurlu kimlik doğrulamasından sonra əməliyyat, sisteminizin sonunda cavab verdiyiniz ümumi bir nəticə göndərərək əvvəlcədən bildiyiniz şəkildə Unzer sistemində daha da işlənir.
yönləndirmə ilə URL. Daha sonra ödəmə sistemi bu yönləndirmədən istifadə edərək müştərini sisteminizə yönləndirəcəkdir URL sisteminizdən
Xahiş edirik unutmayın: Bu iş axınında sisteminiz ödəmə sistemindən iki cavab alır:
- “gözləyir” statusuna (PROCESSING.RETURN.CODE = 000.200.000 və PROCESSING.RETURN = Transaction + bekliyor) və müştərinin kart verən bankına yönləndirmə parametrlərinə sahib biri.
- debet və ya bronun son nəticəsi olan biri. İki yönləndirmə də var URLBu müddətdə qeyd edilənlər, son nəticəni alarkən müştərini yenidən sisteminizə yönləndirmək üçün müştərinin kartı verən bankda və sisteminizdən birini təsdiqləmək üçün müştərinin yönləndirilməli olduğu ödəniş sistemindən biri.
Adi prosedurda aşağıdakı dəyişikliklər ediləcək. Xahiş edirik unutmayın, Paypal kimi digər asinxron ödəmə metodlarının tətbiqi səbəbindən bunlardan bəziləri
proseslər tətbiqinizdə onsuz da mövcud ola bilər.
- Cavab URL
Ödəniş sisteminə edilən ilk zəngdə (diaqramda №2) “Cavab URL”Ön qrupda keçilməlidir.
Qeyd edək: IDENTIFICATION.REFERENCEID parametri yalnız bir qeydiyyata və ya digər mövcud əməliyyata istinad etdiyiniz zaman aiddir. - Yönləndirmə işlənir URL Doğrulama tələb olunursa, yönləndirmə URL və yönləndirmə qrupundakı digər parametrlər ödəniş sistemindən gələn cavabda ötürülür (diaqramda 5 saylı).
- Müştərinin yönləndirməyə yönləndirilməsi URL
Yenidən yönləndirmə qrupu yönləndirmə ilə cavab verirsə URL, müştərinin brauzeri buna yönləndirilməlidir URL (diaqramda № 6) autentifikasiyanı həyata keçirmək üçün. İstiqamətləndirmə qrupundan əlavə parametrlər xaricə ötürülməlidir websaytı POST parametrləri kimi.
Xahiş edirik unutmayın: Əlavə parametrlər “PROCESSING.REDIRECT.xxx” qrupunda yalnız 3D Secure Version 1 ilə qaytarılır (hətta orada say və adlandırma da dəyişə bilər), 3D Versiya 2-də yalnız PROCESSING.REDIRECT.URL aşağıda göstərildiyi kimi qaytarıldı: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Bu, parametrlərin növündən və sayından asılı olmayaraq, müştəri brauzerinin PROCESSING.REDIRECT istiqamətinə yönləndirməsi deməkdir.URL.
Aşağıda sadə bir kod tapa bilərsinizampbelə bir yönləndirmənin necə icra oluna biləcəyini. The hissə sistemləri Javascript-i dəstəkləməyən və ya onu söndürən son müştəriləri məlumatlandırmaq üçün nəzərdə tutulub. İstiqamətləndirmənin müştərinin aktiv brauzer pəncərəsində aparılmasını və pop-up pəncərələrdən və ya yeni brauzer pəncərələrindən istifadə etməməyi tövsiyə edirik, çünki bu,
müştəriləri qıcıqlandırmaq və yönləndirildikləri səhifəni bağlamağa yönəltmək.
- Asinxron nəticə yoxlanışı
Doğrulamanın nəticəsi serverinizə asenkron olaraq göndərilir. Ödəniş sistemi etibarlıdır URL cavab olaraq. (Diaqramda № 12 və 13). Uğurlu və ya rədd edilmiş üçün
ödəmələr, fərqli URL sisteminiz tərəfindən burada cavab verilə bilər. - Müştərinin qayıdış yolu
Ödəniş sistemi müştərini URL identifikasiya prosesi və ödəmə əməliyyatı tamamlandıqdan sonra tacirin sistemi tərəfindən təmin edilir.
Xahiş edirəm unutmayın: 4.) və 5.) mövcud NONE 3D Secure əməliyyatlarında artıq tanış olduğunuz şəkildə tam şəkildə davam edin.
3D Təhlükəsiz və Təkrarlanan Ödəniş
1 yanvar 2021-ci ildən etibarən, 3D Secure bütün elektron ticarət kartı əməliyyatları üçün məcburi olacaqdır. Ancaq bu, təkrarlanan ödəmələr üçün çətin olduğu üçün bank işi
bunun üçün sistemlərin ayrıca bir iş axını var.
Bu məqsədlə banklar arasında fərq qoyur
- CIT = müştərinin başlatdığı əməliyyatlar
- MIT = tacir başlatdığı əməliyyatlar
Ticarət hesabınızdakı bir kartın ilk əməliyyatı 3 tarixindən etibarən 01.01.2021D Secure ilə təsdiqlənməlidir. Belə bir müvəffəqiyyətli bir doğrulama məcburi bir şərtdir
sonradan 3D Secure olmadan eyni kartı əlavə sifariş təqdim edə bilmək üçün. Buna görə müştəri ilk debiti üçün kart verən bankına göndərilməlidir
yuxarıda göstərilən prosedura uyğun olaraq orada kart sahibi kimi özünü təsdiqləməlidir. Sifariş zamanı debet planlaşdırılmırsa, məsələnampsınaq müddəti ilə əlaqədar olaraq, bunun əvəzinə müştərinin iştirakı ilə 3D Secure ilə ən azı bir avro rezervasiya (əvvəlcədən avtorizasiya) edilməlidir. Bu rezervasiyanın tutulması lazım deyil.
Mövcud müştərilər üçün isə heç bir 3D Secure kimlik doğrulamasının edilməsinə ehtiyac yoxdur. İlk uğurlu debet 01.01.2021 tarixindən əvvəl baş vermişsə, müştəri qeydini də qəbul etmək olar
uğurla təsdiq edilmişdir. 01.01.2021 tarixindən etibarən yeni müştərilər üçün, digər tərəfdən, ilk debet və ya sifariş (əvvəlcədən icazə) üçün 3D Secure identifikasiyası məcburidir.
Nəzərə alın: Bu baxımdan bank sistemi müştəri məlumatlarına deyil, kart məlumatlarına baxır. Beləliklə, əgər mövcud müştəri 01.01.2021 tarixindən sonra yeni kartdan istifadə edərsə, məsələnample çünki əvvəlki
birinin müddəti bitibsə və ya kart verən bankını dəyişdiyinə görə, bu, banklar baxımından yeni təkrarlanan dövrdür. view və ilk rezervasiya üçün 3D Secure ilə təsdiqlənməlidir.
Bu ilkin identifikasiya uğurla həyata keçirildikdən sonra, bütün digər əməliyyatlar 3D Secure istifadə etmək öhdəliyindən azaddır 3D Secure olmadan təkrarlanan ödəmə üçün şərtlər bunlardır:
- Ya 3D Secure ilə həyata keçirilmiş və ya 01.01.2021 tarixindən əvvəl reallaşan ən azı bir uğurlu debet və ya bron (əvvəlcədən icazə) mövcuddur.
- mövcud qeydiyyata və təqdim edildikdən sonra borcuna istinad edilir
Ödəniş sisteminə bunun təkrarlanan bir ödəniş olduğunu bildirmək üçün RECURRENCE.MODE = REPEATED parametri də göndərilməlidir. Bu sistemə siqnal verir
təkrarlanan ödəmə bank sistemlərinə bildirilməlidir.
Xahiş edirik unutmayın: Yeni bir kart ilk dəfə yükləndikdə RECURRENCE.MODE = REPEATED parametri daxil edilirsə, bu parametrə baxmayaraq 3D Secure yönləndirmə həyata keçiriləcəkdir.
3D Secure tətbiqetməsinin sınağı
Ödəniş sistemimiz vasitəsilə istənilən vaxt 3D Secure bağlantısını sınaqdan keçirə bilərsiniz. Bunu etmək üçün, keçmişdə göstərildiyi kimi, əməliyyat üçün “CONNECTOR_TEST” rejimindən istifadə edinampyuxarıda.
Bu test üçün əlaqə məlumatları:
| TƏHLÜKƏSİZLİK | 31HA07BC8142C5A171745D00AD63D182 |
| İSTİFADƏÇİ | 31ha07bc8142c5a171744e5aef11ffd3 |
| İstifadəçi.PWD | 93167DE7 |
| ƏMƏLİYYAT.CANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D Versiya 2 üçün konfiqurasiya edilmiş valyutalar | EUR, USD, SEK |
| 3D Versiya 1 üçün konfiqurasiya edilmiş valyutalar | GBP, CZK, CHF |
Sistem Gateway son nöqtəsi ya
SGW qapısı:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latın-15 kodlanmış
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kodlanmış
NGW ağ geçidi:
- https://test-heidelpay.hpcgw.net/ngw/post
Bu test üçün kredit kartı məlumatları:
| brendlər | kart nömrələri | CVV | son istifadə tarixi | qeyd |
| MasterCard | 5453010000059543 | 123 | gələcək tarix | 3D - parol: gizli3 |
| Viza | 4711100000000000 | 123 | gələcək tarix | 3DS - parol: gizli! 33 |
Xahiş edirik unutmayın: 3D Secure Version 2 üçün bir parol daxil etməyiniz lazım deyil, sadəcə keçidi vurun ”Kimlik doğrulamasını tamamlamaq üçün buraya vurun.
3D Secure Version 2 ilə bir xətanı simulyasiya etməyin yeganə yolu, səhifənin keçmə müddəti bitməsidir (təqribən 18 dəqiqə).
Bu Təlimat haqqında ətraflı oxuyun və PDF yükləyin:
Sənədlər / Resurslar
 |
Proqram təminatı 3D Secure İnteqrasiya Bələdçisi [pdf] Sənədlər Unzer, İnteqrasiya Kılavuzu, 3D Secure |
