Softwares 3D Secure Integration Guide Баримтжуулалт
Интеграцийн гарын авлага 3D Secure
01.01.2021-ээс эхлэн хоёр хүчин зүйлийн баталгаажуулалтыг цахим картын төлбөрийн бүх гүйлгээнд заавал оруулах шаардлага болгон хэрэгжүүлнэ. Энэхүү үүргээ биелүүлэхийн тулд
зээлийн картын сүлжээний операторууд 3D Secure процедурыг ашиглах болно. Худалдаачин таны хувьд үйлчлүүлэгчдэдээ зориулж энэхүү журмыг хэрэгжүүлэх шаардлагатай
01.01.2021. Дараахь зүйлээс та нэгтгэх янз бүрийн арга зам, тэдгээрийн талаар 3D Secure процедурыг хэрхэн хэрэгжүүлэх талаар тайлбарыг олж авах болно.
Өөрийн ашигладаг интеграцийн аргыг сонгоно уу
- Та hCO маягтыг ашиглаж байна уу?
- Та hPF төлбөрийн маягтыг ашиглаж байна уу?
- Та Unzer системээс өгсөн маягтыг ашиглахгүйгээр төлбөр тооцоогоо хийдэг үү?
Анхаарна уу: Дебет эсвэл урьдчилсан мэдүүлэг (захиалга) хийх арга зам нь бас чухал юм. Картын өгөгдлийг бүртгүүлэхдээ Unzer GmbH компанийн төлбөрийн хуудсыг ашиглаж байсан ч гэсэн картын өгөгдлийг анх удаа дебетлэх эсвэл зөвшөөрөх үед 3D Secure процессыг төлбөр тооцооны хуудасгүйгээр хийх болно. Энэ тохиолдолд Унзерын өгсөн маягтгүйгээр нэгтгэх гурав дахь арга зам хамаарна.
Анхаарна уу:
Хэрэв та давтамжтай төлбөрийг (захиалгын төлбөр) ашигладаг бол “3D аюулгүй, тогтмол төлбөр” хэсгийг заавал уншаарай.
HCO төлбөрийн хуудсыг ашиглахдаа 3D Secure процедур
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
- БОЛОВСРУУЛАЛТЫН ҮР ДҮН = NOK
Эхний тохиолдолд гүйлгээ амжилттай дууссан бол хоёр дахь тохиолдолд ерөнхийдөө бүтэлгүйтэв. Сүүлийнх нь баталгаажуулахаас татгалзах зэрэг янз бүрийн шалтгаантай байж болно. Та хийх болно
"БОЛОВСРУУЛАХ. БУЦАХ", "БОЛОВСРУУЛАХ. БУЦААЛАХ.КОД" параметрүүдээс илүү дэлгэрэнгүй мэдээллийг авах.
Хоёр мессежийг туршиж үзэхийг зөвлөж байна. Шалгалт хэрхэн хийх, зээлийн картын дэлгэрэнгүй мэдээллийг тестэд ашиглаж болох талаар дэлгэрэнгүй мэдээллийг доороос үзнэ үү.
HPF төлбөрийн хуудсыг ашиглахдаа 3D Secure процедур
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
- БОЛОВСРУУЛАЛТЫН ҮР ДҮН = NOK
Эхний тохиолдолд гүйлгээ амжилттай дууссан бол хоёр дахь тохиолдолд ерөнхийдөө бүтэлгүйтэв. Сүүлийнх нь баталгаажуулахаас татгалзах зэрэг янз бүрийн шалтгаантай байж болно. Та хийх болно
"БОЛОВСРУУЛАХ. БУЦАХ", "БОЛОВСРУУЛАХ. БУЦААЛАХ.КОД" параметрүүдээс илүү дэлгэрэнгүй мэдээллийг авах.
Хоёр мессежийг туршиж үзэхийг зөвлөж байна. Шалгалт хэрхэн хийх, зээлийн картын дэлгэрэнгүй мэдээллийг тестэд ашиглаж болох талаар дэлгэрэнгүй мэдээллийг доороос үзнэ үү.
Шууд холболттой 3D Secure процедур
Хэрэв та зээлийн картны төлбөр тооцоог хийхдээ Unzer-ээс (хуучнаар heidelpay) өгсөн төлбөрийн хуудсыг ашигладаггүй бол эсвэл аль нэг хуудсыг ашиглан картаа бүртгүүлээд урьдчилсан захиалга (захиалга) эсвэл дебетийг боловсруулж бүртгэлийн лавлагаа болгон боловсруулдаг. төлбөрийн системтэй шууд харилцах, та 3D Secure процессыг хэрэгжүүлэх ёстой.
Асинхрон гүйлгээний урсгал:
Энэ нь таны сервер дамжуулалтыг хүлээн авах асинхрон процесс юм URL (Дахин чиглүүлэх URL) манай төлбөрийн системээс. Таны сервер үйлчлүүлэгчийг үүнд дамжуулах ёстой URL Ингэснээр тэрээр 3D Secure процедураар дамжуулан нэвтрэлт танилт хийх боломжтой болно. Энэхүү 3D Secure баталгаажуулалтын үр дүнг карт гаргагч банк шууд Unzer-д мэдээлдэг.
Амжилттай нэвтрэлт танилт хийсний дараа гүйлгээг Unzer системд таны урьд өмнө мэдэж байсан аргаар боловсруулж, эцэст нь таны системд хариу өгөх ерөнхий үр дүнг илгээнэ.
дахин чиглүүлэлттэй URL. Дараа нь төлбөрийн систем нь энэ чиглүүлэлтийг ашиглан үйлчлүүлэгчийг танай систем рүү буцааж чиглүүлэх болно URL таны системээс
Анхаарна уу: Энэ ажлын урсгалд таны систем төлбөрийн системээс хоёр хариултыг хүлээн авна.
- "Хүлээгдэж буй" статустай (PROCESSING.RETURN.CODE = 000.200.000 ба PROCESSING.RETURN = Гүйлгээ + хүлээгдэж буй) статустай ба үйлчлүүлэгчийн карт гаргагч банк руу чиглүүлэх параметрүүдтэй.
- Дебит эсвэл захиалгын эцсийн үр дүнтэй нэг. Мөн хоёр чиглүүлэгч байдаг URLЭнэ процесст дурьдсанчлан, үйлчлүүлэгчийг өөрийн системд буцааж шилжүүлэхийн тулд эцсийн үр дүнг хүлээн авахдаа хэрэглэгчийн картыг гаргаж буй банкинд танай системээс баталгаажуулахын тулд дахин чиглүүлэх шаардлагатай төлбөрийн систем.
Ердийн журамд дараахь өөрчлөлтийг оруулна. Paypal зэрэг бусад асинхрон төлбөрийн аргуудыг хэрэгжүүлсний улмаас эдгээрийн заримыг анхаарч үзээрэй
таны хэрэгжүүлэлтэд аль хэдийн процессууд байж магадгүй юм.
- Хариулт URL
Төлбөрийн систем рүү хийсэн анхны дуудлагад (диаграмм дахь №2) “Хариу URL”Гэж урд талын бүлэгт дамжуулсан байх ёстой.
Анхаарна уу: IDENTIFICATION.REFERENCEID параметр нь зөвхөн бүртгэл эсвэл аль хэдийн хийгдсэн гүйлгээтэй холбоотой тохиолдолд хамаарна. - Дахин чиглүүлэлтийг боловсруулж байна URL Хэрэв таних шаардлагатай бол дахин чиглүүлэлт хийх хэрэгтэй URL болон чиглүүлэлтийн бүлэгт багтсан бусад параметрүүдийг төлбөрийн системээс ирсэн хариунд шилжүүлдэг (диаграмм дахь № 5).
- Үйлчлүүлэгчийг дахин чиглүүлэх чиглэлд шилжүүлэх URL
Хэрэв дахин чиглүүлэлтийн бүлэг дахин чиглүүлэлтээр хариу өгч байгаа бол URL, хэрэглэгчийн хөтөчийг үүнд дахин чиглүүлэх ёстой URL (Диаграм дахь No 6) баталгаажуулалтыг гүйцэтгэх. Дахин чиглүүлэх бүлгийн нэмэлт параметрүүдийг гадаад руу шилжүүлэх шаардлагатай болно webPOST параметр болгон сайт.
Анхаарна уу: Нэмэлт параметрүүдийг "PROCESSING.REDIRECT.xxx" бүлэгт зөвхөн 3D Secure Version 1-т буцааж өгдөг (тэнд тоо, нэр нь өөр байж болно), харин 3D хувилбар 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-р сарын 3-ээс эхлэн XNUMXD 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" горимыг ашиглана ууampДээрх зүйлс.
Энэ тестийн холболтын өгөгдөл:
| АЮУЛГҮЙ БАЙДАЛ | 31HA07BC8142C5A171745D00AD63D182 |
| ХЭРЭГЛЭГЧ НЭВТРЭХ | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| Гүйлгээ. Суваг | 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 - нууц үг: нууц3 |
| Виз | 4711100000000000 | 123 | ирээдүйн огноо | 3. 33DS - нууц үг: нууц! |
Анхаарна уу: 3D Secure Version 2-ийн хувьд та нууц үг оруулах шаардлагагүй бөгөөд холбоос дээр дарна уу. ”Баталгаажуулалтыг гүйцээхийн тулд энд дарна уу.
3D Secure Version 2-т алдаа гаргахыг дууриах цорын ганц арга бол холбоосын хугацаа дууссан хуудсыг зөвшөөрөх явдал юм (ойролцоогоор 18 минут).
Энэ гарын авлагын талаар дэлгэрэнгүй уншиж, PDF татаж авах:
Баримт бичиг / нөөц
 |
Програм хангамжийн 3D Secure Integration Guide [pdf] Баримт бичиг Unzer, Интеграцийн гарын авлага, 3D Secure |
