Softրագրեր 3D Անվտանգ ինտեգրման ուղեցույցի փաստաթղթավորում

Ինտեգրման ուղեցույց 3D անվտանգ

01.01.2021-ից երկու գործոն նույնականացումը կիրականացվի որպես էլեկտրոնային առևտրի քարտերով վճարման բոլոր գործարքների պարտադիր պահանջ: Այս պարտավորությունը կատարելու համար `ՀՀ
Վարկային քարտերի ցանցերի օպերատորները կօգտագործեն այսպես կոչված 3D Secure կարգը: Ձեզ համար, որպես վաճառականի, պարտադիր է, որ կարողանաք իրականացնել այս ընթացակարգը ձեր հաճախորդների համար
01.01.2021 թ. Հաջորդում դուք կգտնեք ինտեգրման տարբեր ձևերի նկարագրությունը և թե ինչպես է դրանց համար իրականացվում 3D Secure ընթացակարգը:

Խնդրում ենք ընտրել ձեր օգտագործած ինտեգրման մեթոդը

• Օգտագործու՞մ եք դրամարկղային ձևաթուղթը hCO:
• Օգտագործո՞ւմ եք դրամարկղ hPF ձևը:
• Դուք մշակում եք վճարումները ՝ առանց օգտագործելով Unzer համակարգի տրամադրած ձև:

Խնդրում ենք նկատի ունենալ. Կարևոր է նաև, թե որ եղանակով են կատարվում դեբետները կամ նախաօրինականացումները (վերապահումները): Նույնիսկ եթե քարտի տվյալների գրանցման համար օգտագործում եք Unzer GmbH ընկերության վճարման ձև, 3D Secure գործընթացն իրականացվելու է առանց դրամարկղային ձևի, երբ քարտի տվյալներն առաջին անգամ գանձվում կամ թույլատրվում են առաջին անգամ: Այս դեպքում գործում է առանց Unzer- ի տրամադրած ձևի ինտեգրման երրորդ ճանապարհը:

Խնդրում ենք նկատի ունենալ նաև.
Եթե ​​օգտագործում եք պարբերական վճարներ (բաժանորդային վճարներ), համոզվեք, որ կարդացեք «3D անվտանգ և պարբերական վճարներ» բաժինը:

3D անվտանգ ընթացակարգ hCO- ի դրամարկղային ձևն օգտագործելիս

HCO դրամարկղային ձևն արդեն մշակված է 3D Secure կարգի համար: Ընթացակարգի իրականացման համար ձեր կողմից լրացուցիչ գործողություն չկա: Այնուամենայնիվ, դուք
պետք է համոզվեն, որ 3D Secure գործընթացը սկսելու դեպքում ձեր համակարգը կարող է կարգավորել մեր վճարային համակարգի համապատասխան պատասխանները: Ասինխրոն պատասխանից
վճարման համակարգը ձեր սերվերին, գործարքի արդյունքը փոխանցվում է և պետք է գնահատվի այնտեղ մինչ վերադարձը URL փոխանցվում է վճարային համակարգին:

Այդ նպատակով պետք է գնահատվեն հետևյալ պարամետրերը.

• ՎԵՐԱՄՇԱԿՈՒՄ. Վերադարձ. Կոդ = 000.200.000
• PROCESSING.RETURN = Գործարքը + առկախ է
• ՄՇԱԿՈՒՄ. ՌԵՍՈՒԼՏ = ACK

Բացատրություն. Գործարքի կարգավիճակը «առկախ է», PROCESSING.RESULT պարամետրը
ներկայացնում է միայն նախնական արդյունք: Քանի դեռ իրականացվում է 3D Secure գործընթացը, կարգավիճակը
մնում են առկախ:

Գործարքի վերջնական արդյունքը կամ այն ​​է

•  ՎԵՐԱՄՇԱԿՈՒՄ. Վերադարձ. Կոդ = 000.000.000
• ՄՇԱԿՈՒՄ. ՌԵՍՈՒԼՏ = ACK
  or
• ՎԵՐԱՄՇԱԿՈՒՄ. Վերադարձ. Կոդ = irgendein Wert ungleich 000.000.000 oder 000.200.000
• ՄՇԱԿՈՒՄ. ՌԵՍՈՒԼՏ = ՆՈԿ

Առաջին դեպքում գործարքը հաջողությամբ ավարտվել է, երկրորդ դեպքում `ընդհանուր առմամբ ձախողվել: Վերջինս կարող է ունենալ տարբեր պատճառներ, այդ թվում `նույնականացման մերժումը: Դու պետք է
ավելի մանրամասն տեղեկատվություն ստանալ «ՄՇԱԿՈՒՄ. ԱՆՇԱՐ» և «ՄՇԱԿՈՒՄ.
Խորհուրդ ենք տալիս փորձարկում կատարել երկու հաղորդագրությունների համար: Թեստ կատարելու վերաբերյալ լրացուցիչ տեղեկությունների համար, և թե որ վարկային քարտի տվյալները կարող եք օգտագործել թեստի համար, տե՛ս ստորև:

3D անվտանգ ընթացակարգ hPF դրամարկղային ձևաթուղթը օգտագործելիս

HPF դրամարկղային ձևը նախատեսված է նաև արդեն օգտագործելու 3DS ընթացակարգը: Ընթացակարգի իրականացման համար ձեր կողմից լրացուցիչ գործողություն չկա: Ինչպես նկարագրված է
hCO- ի իրականացման համար վճարային համակարգից ստացված պատասխանը տեղի է ունենում երկու քայլով, այդ իսկ պատճառով ձեր համակարգը պետք է ստուգի ՄՇԱԿՄԱՆ արժեքը:
պատասխանը մշակելիս պարամետր:

Այդ նպատակով պետք է գնահատվեն հետևյալ պարամետրերը.

• ՎԵՐԱՄՇԱԿՈՒՄ. Վերադարձ. Կոդ = 000.200.000
• PROCESSING.RETURN = Գործարքը + առկախ է
• ՄՇԱԿՈՒՄ. ՌԵՍՈՒԼՏ = ACK

Բացատրություն. Գործարքի կարգավիճակը «առկախ է», PROCESSING պարամետրը: RESULT- ը ներկայացնում է միայն նախնական արդյունք: Քանի դեռ իրականացվում է 3D Secure գործընթացը, կարգավիճակը
մնում են առկախ:

Գործարքի վերջնական արդյունքը կամ այն ​​է

• ՎԵՐԱՄՇԱԿՈՒՄ. Վերադարձ. Կոդ = 000.000.000
• ՄՇԱԿՈՒՄ. ՌԵՍՈՒԼՏ = ACK
  or
• ՎԵՐԱՄՇԱԿՈՒՄ. Վերադարձ. Կոդ = irgendein Wert ungleich 000.000.000 oder 000.200.000
• ՄՇԱԿՈՒՄ. ՌԵՍՈՒԼՏ = ՆՈԿ

Առաջին դեպքում գործարքը հաջողությամբ ավարտվել է, երկրորդ դեպքում `ընդհանուր առմամբ ձախողվել: Վերջինս կարող է ունենալ տարբեր պատճառներ, այդ թվում `նույնականացման մերժումը: Դու պետք է
ավելի մանրամասն տեղեկատվություն ստանալ «ՄՇԱԿՈՒՄ. ԱՆՇԱՐ» և «ՄՇԱԿՈՒՄ.
Խորհուրդ ենք տալիս փորձարկում կատարել երկու հաղորդագրությունների համար: Թեստ կատարելու վերաբերյալ լրացուցիչ տեղեկությունների համար, և թե որ վարկային քարտի տվյալները կարող եք օգտագործել թեստի համար, տե՛ս ստորև:

3D անվտանգ ընթացակարգ ուղղակի կապով

Եթե ​​դուք չեք օգտագործում վճարման ձևաթուղթ, որը տրամադրել է Unzer- ը (նախկինում heidelpay) վարկային քարտի վճարումները մշակելու համար, կամ եթե դուք պարզապես գրանցում եք քարտ `օգտագործելով ձևերից որևէ մեկը և մշակում եք նախաորակագրումը (ամրագրումը) կամ դեբետը` որպես գրանցում որպես գրանցում ուղղակի հաղորդակցություն վճարային համակարգի հետ, դուք պետք է իրականացնեք 3D Secure գործընթացը:

Գործարքի ասինխրոն հոսք.

Սա ասինխրոն գործընթաց է, որի ընթացքում ձեր սերվերը վերահասցեավորում է ստանում URL (Վերահղում URL) մեր վճարային համակարգից: Ձեր սերվերը պետք է հաճախորդին փոխանցի սրան URL որպեսզի նա կարողանա նույնականացումն իրականացնել 3D Secure ընթացակարգի միջոցով: Այս 3D Անվավեր վավերացման արդյունքի մասին քարտը թողարկող բանկը հաղորդում է անմիջապես Unzer- ին:

Հաջող նույնականացումից հետո գործարքը հետագայում մշակվում է Unzer համակարգում այնպես, ինչպես դուք արդեն գիտեք ՝ ձեր համակարգին վերջում ուղարկելով ընդհանուր արդյունք, որին կպատասխանեք
վերահղումով URL, Վճարային համակարգը այնուհետև հաճախորդին կուղղորդի ձեր համակարգ ՝ օգտագործելով այս վերահղումը URL ձեր համակարգից

Խնդրում ենք նկատի ունենալ. Այս աշխատանքային հոսքի ընթացքում ձեր համակարգը ստանում է երկու պատասխան վճարային համակարգից.

- մեկը «առկախ» կարգավիճակով (PROCESSING.RETURN.CODE = 000.200.000 և PROCESSING.RETURN = Գործարք + սպասում է) և վերահղման պարամետրերը դեպի հաճախորդի քարտ թողարկող բանկ:
- Մեկը դեբետի կամ վերապահման վերջնական արդյունքով: Կա նաև երկու վերահղում URLԱյս գործընթացում նշված է `վճարային համակարգից մեկը, որին հաճախորդը պետք է վերահասցեագրվի` իր քարտը թողարկող բանկ հաստատելու և ձեր համակարգից մեկը, վերջնական արդյունքը ստանալիս `հաճախորդին վերափոխելու ձեր համակարգ:

Հերթական ընթացակարգում կատարվելու են հետևյալ փոփոխությունները. Խնդրում ենք նկատի ունենալ, որ վճարման այլ ասինքրոն մեթոդների, օրինակ ՝ Paypal- ի ներդրման շնորհիվ, դրանցից մի քանիսը
գործընթացները կարող են արդեն գոյություն ունենալ ձեր իրականացման ընթացքում:

1. Արձագանք URL
   Առաջին զանգում (գծապատկերում առկա է գծապատկերում թիվ 2) վճարային համակարգին ուղղված «Պատասխան URL»-Ը պետք է փոխանցվի առաջնային խմբում:
   
   Խնդրում ենք նկատի ունենալ. IDENTIFICATION.REFERENCEID պարամետրը կարևոր է միայն այն դեպքում, եթե դուք վերաբերում եք գրանցման կամ արդեն գոյություն ունեցող այլ գործարքի:
2. Վերամշակման վերամշակում URL Եթե ​​նույնականացումը պահանջվում է, վերահղեք URL և վերահղման խմբում գտնվող այլ պարամետրերը փոխանցվում են վճարման համակարգից ստացված պատասխանում (գծապատկերում թիվ 5):
   
   
3. Հաճախորդի վերահասցեավորում վերահասցեավորում URL
   Եթե ​​վերահղման խումբը պատասխանում է վերահղումով URL, հաճախորդի զննարկիչը պետք է վերահղվի սրան URL (Դիագրամում թիվ 6) վավերացում կատարելու համար: Վերահղման խմբից լրացուցիչ պարամետրերը պետք է փոխանցվեն արտաքին webկայքը որպես POST պարամետրեր:
   Խնդրում ենք նկատի ունենալ. Լրացուցիչ պարամետրերը վերադարձվում են «PROCESSING.REDIRECT.xxx» խմբում միայն 3D անվտանգ տարբերակով 1 (նույնիսկ այնտեղ համարը և անվանումները կարող են տարբեր լինել), մինչդեռ 3D տարբերակի դեպքում միայն PROCESSING.URL ինչպես ցույց է տրված ստորև, վերադարձվում է ՝ https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
   CCF / run Սա նշանակում է, որ անկախ պարամետրերի տեսակից և քանակից, հաճախորդի զննարկիչը պետք է վերահասցեավորվի PROCESSING.REDIRECT:URL.
   Ստորև դուք կգտնեք մի պարզ ծածկագիր, օրինակampթե ինչպես կարող է իրականացվել նման վերահղումը: Այն մասը նախատեսված է վերջնական հաճախորդներին տեղեկացնելու համար, որոնց համակարգերը չեն աջակցում Javascript-ին կամ ունեն այն անջատված: Մենք խստորեն խորհուրդ ենք տալիս, որ վերահղումը կատարվի հաճախորդի ակտիվ դիտարկիչի պատուհանում և չօգտագործել թռուցիկ պատուհաններ կամ դիտարկիչի նոր պատուհաններ, քանի որ դա կարող է լինել:
   նյարդայնացնում է հաճախորդներին և ստիպում է նրանց փակել այն էջը, որով նրանք վերահղված են:
   
4. Արդյունքի ասինխրոն ստուգում
   Վավերացման արդյունքն ասինքրոն կերպով ուղարկվում է ձեր սերվերին: Վճարային համակարգը ակնկալում է վավեր URL որպես պատասխան: (Գծապատկերում թիվ 12 & 13): Հաջող կամ մերժվածի համար
   վճարումները ՝ ուրիշ URL ձեր համակարգը կարող է պատասխանել այստեղ:
5. Հաճախորդի վերադարձի ուղին
   Վճարային համակարգը հաճախորդին վերահղում է դեպի URL տրամադրվում է վաճառականի համակարգի կողմից նույնականացման գործընթացից և վճարային գործարքի ավարտից հետո:
   Խնդրում ենք նկատի ունենալ. Քայլեր 4.) և 5.) անցեք ճիշտ այնպես, ինչպես դուք արդեն ծանոթ եք գոյություն ունեցող ՈՉ ՄԵԿ 3D Անվտանգ գործարքների:

3D անվտանգ և պարբերական վճար

1 թվականի հունվարի 2021-ից 3D Secure- ը պարտադիր կլինի էլեկտրոնային առևտրի քարտերով գործարքների համար: Այնուամենայնիվ, քանի որ դա դժվար թե կիրառելի լինի պարբերական վճարումների համար, բանկային գործունեությունը
սրա համար համակարգերն ունեն առանձին աշխատանքային հոսք:

Այդ նպատակով բանկերը տարբերակում են

• CIT = հաճախորդի կողմից նախանշված գործարքներ
• MIT = վաճառականը նախաստորագրել է գործարքները

Քարտի առաջին գործարքը ձեր առևտրային հաշվում պետք է վավերացվի 3D Secure- ով 01.01.2021-ից: Նման հաջող վավերացումը պարտադիր պահանջ է
որպեսզի հետագայում հնարավոր լինի նույն քարտի հետագա ամրագրումները ներկայացնել առանց 3D Secure- ի: Ուստի հաճախորդը պետք է փոխանցվի իր քարտ թողարկող բանկ `առաջին դեբետը կատարելու համար
վերը նկարագրված ընթացակարգին համապատասխան և ինքնությունը հաստատվի այնտեղ որպես քարտատեր: Եթե ​​պատվերի ժամանակ դեբետ չի նախատեսվում, օրինակampՓորձաշրջանի պատճառով առնվազն մեկ եվրոյի ամրագրում (նախնական թույլտվություն) պետք է կատարվի 3D Secure-ով հաճախորդի ներկայությամբ: Այս ամրագրումը գրավելը պարտադիր չէ:

Գոյություն ունեցող հաճախորդների համար, սակայն, անհրաժեշտ չէ որևէ 3D Անվավեր վավերացում կազմել: Եթե ​​առաջին հաջող դեբետը տեղի է ունեցել մինչ 01.01.2021 թ., Ապա կարելի է ենթադրել նաև հաճախորդի գրառումը
հաջողությամբ վավերացվել են: Մյուս կողմից, նոր հաճախորդների համար 01.01.2021 թ. Դրությամբ 3D Secure վավերացումը պարտադիր է առաջին դեբետի կամ վերապահման (նախաորակավորում) համար:

Խնդրում ենք նկատի ունենալ. այս առումով բանկային համակարգը դիտարկում է ոչ թե հաճախորդի, այլ քարտի տվյալները: Այսպիսով, եթե գործող հաճախորդը 01.01.2021-ից հետո օգտագործում է նոր քարտ, օրինակample քանի որ նախորդ
մեկի ժամկետը լրացել է կամ քանի որ նա փոխել է իր քարտը թողարկող բանկը, սա նոր կրկնվող ցիկլ է բանկերի կողմից: view և պետք է վավերացվի 3D Secure-ով առաջին ամրագրման համար:

Այս նախնական նույնականացումը հաջողությամբ իրականացնելուց հետո բոլոր հետագա գործարքները ազատվում են 3D Secure- ի օգտագործման պարտավորությունից: Առանց 3D Secure- ի պարբերական վճարման նախադրյալներն են.

• Գոյություն ունի առնվազն մեկ հաջող դեբետ կամ վերապահում (նախնական թույլտվություն), որը կամ իրականացվել է 3D Secure համակարգով կամ տեղի է ունեցել մինչ 01.01.2021 թ.
• այն հղվում է առկա գրանցմանը և դեբետին ներկայացնելուց հետո

Վճարային համակարգին տեղյակ պահելու համար, որ սա պարբերական վճար է, պետք է ուղարկվի նաև RECURRENCE.MODE = REPEATED պարամետրը: Սա ազդանշան է տալիս համակարգին, որ ա
պարբերական վճարման մասին հաշվետվություն է տրվում բանկային համակարգերին:

Խնդրում ենք նկատի ունենալ. Եթե RECURRENCE.MODE = REPEATED պարամետրը մուտքագրվում է, երբ առաջին անգամ նոր քարտ է բեռնվում, 3D Secure փոխանցում կիրականացվի ՝ չնայած այս պարամետրին:

3D անվտանգ իրականացման փորձարկում

Դուք ցանկացած պահի կարող եք ստուգել 3D Secure կապը մեր վճարային համակարգի միջոցով: Դա անելու համար օգտագործեք «CONNECTOR_TEST» ռեժիմը գործարքի համար, ինչպես ցույց է տրված նախկինումamples վերևում:
Այս թեստի միացման տվյալները.

ԱՆՎՏԱՆԳՈՒԹՅՈՒՆ. ԱՌԱՔԻՉ	31HA07BC8142C5A171745D00AD63D182
ՕԳՏԱԳՈՐԾ.ՄՈՒՏՔ	31ha07bc8142c5a171744e5aef11ffd3
USER.PWD	93167DE7
Գործարքներ. ԱԼԻՔ	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 - գաղտնաբառ ՝ գաղտնի! 33

Խնդրում ենք նկատի ունենալ. 3D անվտանգ տարբերակի 2-ի համար անհրաժեշտ չէ գաղտնաբառ մուտքագրել, այլ պարզապես կտտացրեք հղմանը »: Սեղմեք այստեղ ՝ իսկությունը հաստատելու համար:
3D Secure Version 2-ի հետ սխալի նմանակման միակ միջոցը հղումն ունեցող էջին թողնելն ավարտված է (մոտավորապես 18 րոպե):

 

Կարդացեք ավելին այս ձեռնարկի մասին և ներբեռնեք PDF.

Փաստաթղթեր / ռեսուրսներ

Ծրագրային ապահովման 3D անվտանգ ինտեգրման ուղեցույց [pdfՓաստաթղթեր Unzer, ինտեգրման ուղեցույց, 3D Secure

Հղումներ

• Օգտագործողի ձեռնարկ