პროგრამები 3D უსაფრთხო ინტეგრაციის სახელმძღვანელო დოკუმენტაცია
ინტეგრაციის სახელმძღვანელო 3D უსაფრთხო
01.01.2021 წლიდან ორფაქტორიანი ავტორიზაცია ამოქმედდება, როგორც სავალდებულო მოთხოვნა ელექტრონული კომერციული ბარათების გადახდის ოპერაციებისთვის. ამ ვალდებულების შესასრულებლად,
საკრედიტო ბარათების ქსელების ოპერატორები გამოიყენებენ ე.წ. 3D უსაფრთხო პროცედურას. თქვენთვის, როგორც სავაჭრო ობიექტისთვის, სავალდებულოა თქვენი მომხმარებლებისთვის ამ პროცედურის განხორციელება
01.01.2021 წ. შემდეგში ნახავთ ინტეგრაციის სხვადასხვა გზების აღწერას და როგორ უნდა განხორციელდეს 3D Secure პროცედურა მათთვის.
გთხოვთ, აირჩიოთ ინტეგრაციის მეთოდი, რომელსაც იყენებთ
- იყენებთ შეკვეთის ფორმას hCO?
- იყენებთ შეკვეთის ფორმას hPF?
- ამუშავებთ გადახდებს Unzer სისტემის მიერ მოწოდებული ფორმის გამოყენების გარეშე?
გთხოვთ გაითვალისწინოთ: ასევე მნიშვნელოვანია, თუ რა ფორმით ხდება დებეტების ან წინასწარი ავტორიზაციის (ჯავშნების) გაკეთება. მაშინაც კი, თუ ბარათის მონაცემების რეგისტრაციისთვის იყენებთ გადახდის ფორმას Unzer GmbH– დან, 3D Secure პროცესი განხორციელდება შეკვეთის ფორმის გარეშე, როდესაც ბარათის მონაცემები პირველად ჩამოიწერება ან ავტორიზდება. ამ შემთხვევაში მოქმედებს ინტეგრაციის მესამე გზა Unzer- ის მიერ მოწოდებული ფორმის გარეშე.
გთხოვთ გაითვალისწინოთ აგრეთვე:
თუ იყენებთ განმეორებით გადასახადებს (სააბონენტო გადასახადები), დარწმუნდით, რომ წაიკითხეთ განყოფილება ”3D უსაფრთხო და განმეორებადი გადახდა”.
3D უსაფრთხო პროცედურა hCO გადახდების ფორმის გამოყენებისას
HCO შეკვეთის ფორმა უკვე შექმნილია 3D უსაფრთხო პროცედურისთვის. თქვენი მხრიდან არანაირი დამატებითი მოქმედება არ არის საჭირო პროცედურის განსახორციელებლად. ამასთან, შენ
დარწმუნდით, რომ თქვენს სისტემას შეუძლია გაუმკლავდეს ჩვენი გადახდის სისტემის შესაბამის პასუხებს, თუ 3D Secure პროცესი დაიწყება. ასინქრონული რეაგირებისგან
გადახდის სისტემა თქვენს სერვერზე, გარიგების შედეგი გადაეცემა და იქ უნდა შეფასდეს დაბრუნებამდე URL გადაეცემა გადახდის სისტემას.
ამ მიზნით უნდა შეფასდეს შემდეგი პარამეტრები.
- დამუშავება. აღდგენა. კოდი = 000.200.000
- PROCESSING.RETURN = გარიგება + ელოდება
- დამუშავება. შედეგი = ACK
განმარტება: გარიგების სტატუსი "ელოდება", პარამეტრი PROCESSING.RESULT
წარმოადგენს მხოლოდ წინასწარ შედეგს. სანამ 3D უსაფრთხო პროცესი ხორციელდება, სტატუსი
დარჩება მომლოდინე.
გარიგების საბოლოო შედეგი არის ან
- დამუშავება. აღდგენა. კოდი = 000.000.000
- დამუშავება. შედეგი = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- დამუშავება. შედეგი = არა
პირველ შემთხვევაში გარიგება წარმატებით დასრულდა, ხოლო მეორე შემთხვევაში, იგი მთლიანობაში ჩაიშალა. ამ უკანასკნელს შეიძლება ჰქონდეს სხვადასხვა მიზეზი, მათ შორის უარი ავტორიზაციაზე. Შენ იზავ
მიიღეთ უფრო დეტალური ინფორმაცია პარამეტრებში „PROCESSING.RETURN“ და „PROCESSING.RETURN.CODE“.
ჩვენ გირჩევთ ჩაატაროთ ტესტი ორივე შეტყობინებისთვის. დამატებითი ინფორმაციისთვის თუ როგორ უნდა გაიაროთ ტესტი და რომელი საკრედიტო ბარათის დეტალები შეგიძლიათ გამოიყენოთ გამოცდისთვის, იხილეთ ქვემოთ.
3D უსაფრთხო პროცედურა hPF გადახდების ფორმის გამოყენებისას
HPF შეკვეთის ფორმა ასევე შექმნილია 3DS პროცედურის გამოსაყენებლად. თქვენი მხრიდან არანაირი დამატებითი მოქმედება არ არის საჭირო პროცედურის განსახორციელებლად. Როგორც აღწერილია
hCO- ს განხორციელებისთვის, გადახდის სისტემისგან პასუხი ხდება ორ ეტაპად, რის გამოც თქვენსმა სისტემამ უნდა შეამოწმოს PROCESSING- ის მნიშვნელობა.
პარამეტრი პასუხის დამუშავებისას.
ამ მიზნით უნდა შეფასდეს შემდეგი პარამეტრები.
- დამუშავება. აღდგენა. კოდი = 000.200.000
- PROCESSING.RETURN = გარიგება + ელოდება
- დამუშავება. შედეგი = ACK
განმარტება: გარიგების სტატუსი "ელოდება", პარამეტრი PROCESSING.RESULT წარმოადგენს მხოლოდ წინასწარ შედეგს. სანამ 3D უსაფრთხო პროცესი ხორციელდება, სტატუსი
დარჩება მომლოდინე.
გარიგების საბოლოო შედეგი არის ან
- დამუშავება. აღდგენა. კოდი = 000.000.000
- დამუშავება. შედეგი = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- დამუშავება. შედეგი = არა
პირველ შემთხვევაში გარიგება წარმატებით დასრულდა, ხოლო მეორე შემთხვევაში, იგი მთლიანობაში ჩაიშალა. ამ უკანასკნელს შეიძლება ჰქონდეს სხვადასხვა მიზეზი, მათ შორის უარი ავტორიზაციაზე. Შენ იზავ
მიიღეთ უფრო დეტალური ინფორმაცია პარამეტრებში „PROCESSING.RETURN“ და „PROCESSING.RETURN.CODE“.
ჩვენ გირჩევთ ჩაატაროთ ტესტი ორივე შეტყობინებისთვის. დამატებითი ინფორმაციისთვის თუ როგორ უნდა გაიაროთ ტესტი და რომელი საკრედიტო ბარათის დეტალები შეგიძლიათ გამოიყენოთ გამოცდისთვის, იხილეთ ქვემოთ.
3D უსაფრთხო პროცედურა პირდაპირი კავშირით
თუ თქვენ არ იყენებთ გადახდის ფორმას, რომელიც მოწოდებულია Unzer- ის მიერ (ყოფილი ჰეიდელპეი) საკრედიტო ბარათის გადახდების დასამუშავებლად, ან თუ თქვენ უბრალოდ დარეგისტრირდით ბარათს ერთ-ერთი ფორმის გამოყენებით და დაამუშავებთ წინასწარი ავტორიზაციას (დაჯავშნას) ან დებეტს, როგორც მითითებას, როგორც რეგისტრაცია პირდაპირი კომუნიკაცია გადახდის სისტემასთან, თქვენ უნდა განახორციელოთ 3D Secure პროცესი.
ასინქრონული ტრანსაქციის ნაკადი:
ეს არის ასინქრონული პროცესი, როდესაც თქვენი სერვერი იღებს გადამისამართებას URL (გადამისამართება URL) ჩვენი გადახდის სისტემიდან. თქვენმა სერვერმა მომხმარებელი უნდა გადააგზავნოს აქ URL ისე, რომ მას შეუძლია შეასრულოს ავტორიზაცია 3D Secure პროცედურის საშუალებით. ამ 3D უსაფრთხო ავტორიზაციის შედეგების შესახებ უშუალოდ Unzer- ს ეცნობება ბარათის გამცემი ბანკი.
წარმატებული ავტორიზაციის შემდეგ, გარიგება დამუშავდება Unzer სისტემაში ისე, როგორც უკვე იცით, თქვენი სისტემის ბოლოს გაგზავნის შედეგს, რომელსაც უპასუხებთ
გადამისამართებით URL. გადახდის სისტემა შემდეგ მომხმარებელს გადაამისამართებს თქვენს სისტემაში ამ გადამისამართების გამოყენებით URL თქვენი სისტემიდან
გთხოვთ გაითვალისწინოთ: ამ სამუშაო პროცესში თქვენი სისტემა იღებს ორ პასუხს გადახდის სისტემისგან:
- ერთი სტატუსით "ელოდება" (PROCESSING.RETURN.CODE = 000.200.000 და PROCESSING.RETURN = გარიგება + მიმდინარეობს) და მომხმარებლის ბარათის გამცემი ბანკის გადამისამართების პარამეტრები
- ერთი, სადებეტო ან ჯავშნის საბოლოო შედეგით. ასევე არსებობს ორი გადამისამართება URLამ პროცესში ნათქვამია, გადახდის სისტემისგან, რომლითაც მომხმარებელი უნდა გადამისამართდეს მის ბარათზე, რომელიც გასცემს ბანკს და თქვენი სისტემისგან, საბოლოო შედეგის მიღებისას, მომხმარებელი გადააბრუნოს თქვენს სისტემაში.
შემდეგი ცვლილებები შევა რეგულარულ პროცედურაში. გთხოვთ გაითვალისწინოთ, რომ გადახდის სხვა ასინქრონული მეთოდების, როგორიცაა Paypal, დანერგვის გამო, ზოგიერთი მათგანი
პროცესები შეიძლება უკვე არსებობდეს თქვენს განხორციელებაში.
- პასუხი URL
პირველ ზარზე (დიაგრამაზე No2) გადახდის სისტემაში გაიგზავნა პასუხი URL”უნდა გაიაროს ფრონტენდ ჯგუფში.
გთხოვთ გაითვალისწინოთ: პარამეტრი IDENTIFICATION.REFERENCEID მხოლოდ მაშინ არის მნიშვნელოვანი, თუ ეხება რეგისტრაციას ან სხვა უკვე არსებულ ტრანსაქციას. - გადამუშავების გადამისამართება URL თუ ავტორიზაცია საჭიროა, გადამისამართება URL და გადამისამართების ჯგუფში სხვა პარამეტრების გადატანა ხდება გადახდის სისტემის მხრიდან პასუხში (დიაგრამაზე No5).
- მომხმარებლის გადამისამართება URL
თუ გადამისამართების ჯგუფი პასუხობს გადამისამართებით URL, მომხმარებლის ბრაუზერი უნდა გადამისამართდეს ამაზე URL (დიაგრამაში No6) ავტორიზაციის შესასრულებლად. გადამისამართების ჯგუფიდან დამატებითი პარამეტრები უნდა გადავიდეს გარედან webსაიტი როგორც POST პარამეტრები.
გთხოვთ გაითვალისწინოთ: დამატებითი პარამეტრები უბრუნდება ჯგუფს "PROCESSING.REDIRECT.xxx" მხოლოდ 3D უსაფრთხო ვერსია 1-ით (იქაც კი ნომერი და დასახელება შეიძლება განსხვავდებოდეს), ხოლო 3D ვერსია 2-ში მხოლოდ PROCESSING.REDIRECT.URL როგორც ქვემოთ ნაჩვენებია, ბრუნდება: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / გაშვება ეს ნიშნავს, რომ მიუხედავად პარამეტრების ტიპისა და რაოდენობისა, კლიენტის ბრაუზერმა უნდა გადაიტანოს PROCESSING.REDIRECT.URL.
ქვემოთ თქვენ იხილავთ მარტივ კოდს example როგორ შეიძლება განხორციელდეს ასეთი გადამისამართება. ის ნაწილი გამიზნულია საბოლოო მომხმარებლების ინფორმირებისათვის, რომელთა სისტემები არ უჭერენ მხარს Javascript- ს ან გამორთულია. ჩვენ მკაცრად გირჩევთ, რომ გადამისამართება მოხდეს მომხმარებლის აქტიური ბრაუზერის ფანჯარაში და არ გამოიყენოთ ამომხტარი ფანჯრები ან ახალი ბრაუზერის ფანჯრები, რადგან ეს შეიძლება
გააღიზიანონ მომხმარებლები და აიძულონ დახურონ გვერდი, რომელზეც არიან გადამისამართებული.
- ასინქრონული შედეგის შემოწმება
ავთენტიფიკაციის შედეგი ასინქრონულად იგზავნება თქვენს სერვერზე. გადახდის სისტემა მოქმედებს URL როგორც პასუხი. (დიაგრამაზე No12 & 13). წარმატებული ან უარყოფილი
გადასახადები, სხვა URL თქვენი სისტემის მიერ აქ პასუხის გაცემა შეიძლება. - მომხმარებლის დაბრუნების გზა
გადახდის სისტემა მომხმარებელს გადამისამართებს URL მოვაჭრის სისტემის მიერ მოწოდებული ავტორიზაციის პროცესისა და გადახდის ოპერაციის დასრულების შემდეგ.
გთხოვთ გაითვალისწინოთ: ნაბიჯები 4.) და 5.) გააგრძელეთ ზუსტად ისე, როგორც უკვე იცნობთ NONE 3D Secure ოპერაციებში.
3D უსაფრთხო და განმეორებადი გადახდა
1 წლის 2021 იანვრიდან 3D Secure სავალდებულო იქნება ელექტრონული კომერციის ბარათებით განხორციელებული ყველა ოპერაციისთვის. ამასთან, რადგან ეს თითქმის არ გამოიყენება განმეორებითი გადასახადებისთვის, საბანკო საქმე
ამისათვის სისტემებს აქვთ ცალკე სამუშაო ნაკადი.
ამ მიზნით, ბანკები განასხვავებენ ერთმანეთს
- CIT = მომხმარებლის მიერ ინიცირებული გარიგებები
- MIT = ვაჭარმა მოახდინა გარიგების ინიციალიზაცია
თქვენს სავაჭრო ანგარიშზე ბარათის პირველი ტრანსაქცია უნდა დამოწმდეს 3D Secure– ით 01.01.2021 წლიდან. ასეთი წარმატებული ავტორიზაცია სავალდებულო მოთხოვნაა
იმისათვის, რომ შემდგომში იმავე ბარათზე შემდგომი შეკვეთების წარდგენა შეძლოთ 3D უსაფრთხო გარეშე. ამრიგად, მომხმარებელი უნდა გაიგზავნოს ბარათის გამცემი ბანკში პირველი დებეტში
ზემოთ აღწერილი პროცედურის შესაბამისად და იქ ადასტურებს თავის თავს, როგორც ბარათის მფლობელს. თუ დებეტი არ არის დაგეგმილი შეკვეთის დროს, მაგampსაცდელი პერიოდის გამო, მინიმუმ ერთი ევროს დაჯავშნა (წინასწარი ავტორიზაცია) უნდა განხორციელდეს 3D Secure– ით, მომხმარებლის თანდასწრებით. ამ ჯავშნის აღება არ არის აუცილებელი.
ამასთან, არსებული მომხმარებლებისთვის არ არის საჭირო 3D უსაფრთხო ავტორიზაციის შედგენა. თუ პირველი წარმატებული დებეტი მოხდა 01.01.2021 წლამდე, ასევე შეიძლება ვივარაუდოთ მომხმარებლის ჩანაწერი
წარმატებით იქნა დამოწმებული. ახალი მომხმარებლებისთვის, 01.01.2021 წლისთვის, 3D უსაფრთხო ავტორიზაცია სავალდებულოა პირველი დებეტის ან დაჯავშნისთვის (წინასწარი ავტორიზაცია).
გთხოვთ გაითვალისწინოთ: ამ მხრივ, საბანკო სისტემა უყურებს ბარათის მონაცემებს და არა მომხმარებლის მონაცემებს. ასე რომ, თუ არსებული მომხმარებელი იყენებს ახალ ბარათს 01.01.2021 წლის შემდეგ, მაგample რადგან წინა
ერთს ვადა ამოეწურა ან რადგანაც მან შეიცვალა ბარათის გამცემი ბანკი, ეს არის ახალი განმეორებადი ციკლი ბანკების თვალსაზრისით view და უნდა იყოს დამოწმებული 3D Secure– ით პირველი დაჯავშნისთვის.
ამ თავდაპირველი ავტორიზაციის წარმატებით შესრულების შემდეგ, ყველა შემდგომი ოპერაცია თავისუფლდება 3D Secure– ს გამოყენების ვალდებულებისაგან. 3D Secure– ის გარეშე განმეორებითი გადახდის წინაპირობებია:
- არსებობს მინიმუმ ერთი წარმატებული დებეტი ან დათქმა (წინასწარი ავტორიზაცია), რომელიც ან განხორციელდა 3D Secure– ით ან მოხდა 01.01.2021 წლამდე.
- იგი მითითებულია არსებულ რეგისტრაციაზე და დებეტზე წარდგენისთანავე
იმისათვის, რომ გადახდის სისტემას გააცნობიეროს, რომ ეს არის განმეორებითი გადახდა, ასევე უნდა გაიგზავნოს პარამეტრი RECURRENCE.MODE = REPEATED. ეს სიგნალს აძლევს სისტემას, რომ ა
განმეორებითი გადახდის შესახებ უნდა აცნობონ საბანკო სისტემებს.
გთხოვთ გაითვალისწინოთ: თუ პარამეტრი RECURRENCE.MODE = REPEATED შეიყვანეს ახალი ბარათის პირველად ჩატვირთვისას, 3D პარამეტრი გადავა განხორციელდება ამ პარამეტრის მიუხედავად.
3D უსაფრთხო განხორციელების ტესტირება
თქვენ შეგიძლიათ შეამოწმოთ 3D Secure კავშირი ნებისმიერ დროს ჩვენი გადახდის სისტემის საშუალებით. ამისათვის გამოიყენეთ "CONNECTOR_TEST" რეჟიმი გარიგებისათვის, როგორც ეს ნაჩვენებია ყოფილშიampზემოთ.
კავშირის მონაცემები ამ ტესტისთვის:
| უსაფრთხოება. გამგზავნი | 31HA07BC8142C5A171745D00AD63D182 |
| ᲛᲝᲛᲮᲛᲐᲠᲔᲑᲔᲚᲘ | 31ha07bc8142c5a171744e5aef11ffd3 |
| მომხმარებელი. PWD | 93167DE7 |
| გარიგება. CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D ვერსიისთვის კონფიგურირებული ვალუტები | ევრო, აშშ დოლარი, SEK |
| 3D ვერსიისთვის კონფიგურირებული ვალუტები | 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 | მომავალი თარიღი | 3DS - პაროლი: საიდუმლო! |
გთხოვთ გაითვალისწინოთ: 3D უსაფრთხო ვერსიისთვის, თქვენ არ გჭირდებათ პაროლის შეყვანა, არამედ უბრალოდ დააჭირეთ ბმულს ”დააჭირეთ აქ ავტორიზაციის დასასრულებლად.
3D უსაფრთხო ვერსიით 2 შეცდომის სიმულაციის ერთადერთი გზაა გვერდის ბმულის ამოწურვა (დაახლ. 18 წუთი).
წაიკითხეთ მეტი ამ სახელმძღვანელოს შესახებ და ჩამოტვირთეთ PDF:
დოკუმენტები / რესურსები
 |
პროგრამული უზრუნველყოფის 3D უსაფრთხო ინტეგრაციის სახელმძღვანელო [pdf] დოკუმენტაცია Unzer, ინტეგრაციის სახელმძღვანელო, 3D უსაფრთხო |
