Dokumentasyon ng Gabay sa Pagsasama ng Secure na Softwares 3D
Gabay sa Pagsasama 3D Secure
Mula 01.01.2021 sa two-factor authentication ay ipapatupad bilang mandatoryong kinakailangan para sa lahat ng transaksyon sa pagbabayad ng ecommerce card. Upang makasunod sa obligasyong ito, ang
gagamitin ng mga operator ng mga network ng credit card ang tinatawag na 3D Secure na pamamaraan. Para sa iyo bilang isang mangangalakal, ipinag-uutos na maisagawa ang pamamaraang ito para sa iyong mga customer mula sa
01.01.2021. Sa sumusunod ay makikita mo ang isang paglalarawan ng iba't ibang paraan ng pagsasama at kung paano kailangang ipatupad ang pamamaraang 3D Secure para sa kanila.
Mangyaring piliin ang paraan ng pagsasama na iyong ginagamit
- Ginagamit mo ba ang checkout form na hCO?
- Ginagamit mo ba ang checkout form na hPF?
- Pinoproseso mo ba ang mga pagbabayad nang hindi gumagamit ng form na ibinigay ng Unzer system?
Mangyaring tandaan: Mahalaga rin kung paano ginawa ang mga debit o preauthorization (pagpapareserba). Kahit na gumamit ka ng form ng pagbabayad mula sa Unzer GmbH para sa pagpaparehistro ng data ng card, isasagawa ang proseso ng 3D Secure nang walang form ng pag-checkout kapag ang data ng card ay unang na-debit o pinahintulutan sa unang pagkakataon. Sa kasong ito, nalalapat ang ikatlong paraan ng pagsasama nang walang form na ibinigay ng Unzer.
Mangyaring tandaan din:
Kung gumagamit ka ng mga umuulit na pagbabayad (mga pagbabayad sa subscription), tiyaking basahin ang seksyong "3D Secure at Recurring Payment".
3D Secure na pamamaraan kapag ginagamit ang hCO checkout form
Ang hCO checkout form ay idinisenyo na para sa 3D Secure na pamamaraan. Walang karagdagang aksyon mula sa iyong panig na kailangan para sa pagpapatupad ng pamamaraan. Gayunpaman, ikaw
kailangang tiyakin na kaya ng iyong system ang mga kaukulang sagot ng aming sistema ng pagbabayad kung sakaling magsimula ang proseso ng 3D Secure. Sa asynchronous na tugon mula sa
sistema ng pagbabayad sa iyong server, ang resulta ng transaksyon ay ipinadala at dapat suriin doon bago bumalik URL ay ipinadala sa sistema ng pagbabayad.
Para sa layuning ito, dapat suriin ang mga sumusunod na parameter.
- PAGPROSESO.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Transaksyon+pending
- PAGPROSESO.RESULTA = ACK
Paliwanag: Ang status ng transaksyon ay “nakabinbin”, ang parameter na PROCESSING.RESULT
kumakatawan lamang sa isang paunang resulta. Hangga't ang proseso ng 3D Secure ay isinasagawa, ang katayuan
mananatiling nakabinbin.
Ang huling resulta ng transaksyon ay alinman
- PAGPROSESO.RETURN.CODE = 000.000.000
- PAGPROSESO.RESULTA = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PAGPROSESO.RESULTA = NOK
Sa unang kaso ang transaksyon ay matagumpay na nakumpleto, sa pangalawang kaso ito ay nabigo sa pangkalahatan. Ang huli ay maaaring magkaroon ng iba't ibang dahilan, kabilang ang pagtanggi na patotohanan. gagawin mo
makatanggap ng mas detalyadong impormasyon sa mga parameter na "PROCESSING.RETURN" at "PROCESSING.RETURN.CODE".
Inirerekomenda namin na magpatakbo ka ng pagsubok para sa parehong mga mensahe. Para sa higit pang impormasyon kung paano gumawa ng pagsubok at kung aling mga detalye ng credit card ang magagamit mo para sa isang pagsubok, pakitingnan sa ibaba.
3D Secure na pamamaraan kapag ginagamit ang hPF checkout form
Ang form ng pag-checkout ng hPF ay idinisenyo din para gamitin na ang pamamaraang 3DS. Walang karagdagang aksyon mula sa iyong panig na kailangan para sa pagpapatupad ng pamamaraan. Gaya ng inilarawan
para sa pagpapatupad ng hCO ang tugon mula sa sistema ng pagbabayad ay nagaganap sa dalawang hakbang, kaya dapat suriin ng iyong system ang halaga ng PROCESSING.RETURN.CODE
parameter kapag pinoproseso ang tugon.
Para sa layuning ito, dapat suriin ang mga sumusunod na parameter.
- PAGPROSESO.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Transaksyon+pending
- PAGPROSESO.RESULTA = ACK
Paliwanag: Ang status ng transaksyon ay "nakabinbin", ang parameter na PROCESSING.RESULT ay kumakatawan lamang sa isang paunang resulta. Hangga't ang proseso ng 3D Secure ay isinasagawa, ang katayuan
mananatiling nakabinbin.
Ang huling resulta ng transaksyon ay alinman
- PAGPROSESO.RETURN.CODE = 000.000.000
- PAGPROSESO.RESULTA = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PAGPROSESO.RESULTA = NOK
Sa unang kaso ang transaksyon ay matagumpay na nakumpleto, sa pangalawang kaso ito ay nabigo sa pangkalahatan. Ang huli ay maaaring magkaroon ng iba't ibang dahilan, kabilang ang pagtanggi na patotohanan. gagawin mo
makatanggap ng mas detalyadong impormasyon sa mga parameter na "PROCESSING.RETURN" at "PROCESSING.RETURN.CODE".
Inirerekomenda namin na magpatakbo ka ng pagsubok para sa parehong mga mensahe. Para sa higit pang impormasyon kung paano gumawa ng pagsubok at kung aling mga detalye ng credit card ang magagamit mo para sa isang pagsubok, pakitingnan sa ibaba.
3D Secure na pamamaraan na may direktang koneksyon
Kung hindi ka gumagamit ng form ng pagbabayad na ibinigay ng Unzer (dating heidelpay) para iproseso ang mga pagbabayad sa credit card, o kung magrehistro ka lang ng card gamit ang isa sa mga form at iproseso ang preauthorization (reservation) o debit bilang reference sa pagpaparehistro bilang isang direktang komunikasyon sa sistema ng pagbabayad, dapat mong ipatupad ang proseso ng 3D Secure.
Asynchronous na daloy ng transaksyon:
Ito ay isang asynchronous na proseso kung saan ang iyong server ay tumatanggap ng pagpapasa URL (I-redirect URL) mula sa aming sistema ng pagbabayad. Dapat ipasa ng iyong server ang customer dito URL upang maisagawa niya ang pagpapatunay sa pamamagitan ng 3D Secure procedure. Ang resulta ng 3D Secure authentication na ito ay direktang iniuulat sa Unzer ng bangkong nagbigay ng card.
Pagkatapos ng matagumpay na pag-authenticate, ang transaksyon ay ipoproseso pa sa Unzer system sa paraang alam mo na sa pamamagitan ng pagpapadala sa iyong system ng pangkalahatang resulta sa dulo, kung saan ka tumugon
na may redirect URL. Ire-redirect ng system ng pagbabayad ang customer pabalik sa iyong system gamit ang redirect na ito URL mula sa iyong sistema
Pakitandaan: Sa daloy ng trabaho na ito ang iyong system ay tumatanggap ng dalawang sagot mula sa sistema ng pagbabayad:
– Isa na may katayuang “nakabinbin” (PROCESSING.RETURN.CODE=000.200.000 at PROCESSING.RETURN=Transaction+pending) at ang mga parameter ng pag-redirect sa bank-issuing bank ng customer
– Isa na may huling resulta ng debit o reserbasyon. Mayroon ding dalawang pag-redirect URLNabanggit sa prosesong ito, isa mula sa sistema ng pagbabayad kung saan kailangang i-redirect ang customer upang mapatunayan sa kanyang bangkong nagbigay ng card at isa mula sa iyong system, kapag natanggap ang huling resulta, upang i-redirect ang customer pabalik sa iyong system.
Ang mga sumusunod na pagbabago ay gagawin sa regular na pamamaraan. Pakitandaan na dahil sa pagpapatupad ng iba pang asynchronous na paraan ng pagbabayad, gaya ng Paypal, ang ilan sa mga ito
maaaring umiral na ang mga proseso sa iyong pagpapatupad.
- Tugon URL
Sa unang tawag (no.2 sa diagram) sa sistema ng pagbabayad, isang "Tugon URL” dapat ipasa sa frontend group.
Mangyaring tandaan: Ang parameter na IDENTIFICATION.REFERENCEID ay may kaugnayan lamang kung sumangguni ka sa isang pagpaparehistro o iba pang umiiral nang transaksyon - Pinoproseso ang Pag-redirect URL Kung kinakailangan ang pagpapatunay, isang pag-redirect URL at iba pang mga parameter sa pangkat ng pag-redirect ay inilipat sa tugon mula sa sistema ng pagbabayad (No. 5 sa diagram).
- Pagpasa ng customer sa pag-redirect URL
Kung ang redirect group ay tumutugon sa isang redirect URL, dapat na i-redirect dito ang browser ng customer URL (No. 6 sa diagram) para magsagawa ng authentication. Ang mga karagdagang parameter mula sa pangkat ng pag-redirect ay kailangang ilipat sa panlabas website bilang mga parameter ng POST.
Pakitandaan: Ang mga karagdagang parameter ay ibinabalik sa pangkat na "PROCESSING.REDIRECT.xxx" na may 3D Secure na Bersyon 1 (kahit doon ay maaaring mag-iba ang numero at pagpapangalan), samantalang sa 3D na Bersyon 2 ay isang PROCESSING.REDIRECT lang.URL tulad ng ipinapakita sa ibaba ay ibinalik: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF/run Nangangahulugan ito na anuman ang uri at bilang ng mga parameter, ang client browser ay dapat mag-redirect sa PROCESSING.REDIRECT.URL.
Sa ibaba makikita mo ang isang simpleng code examptungkol sa kung paano maipatupad ang naturang pag-redirect. Ang Ang bahagi ay inilaan upang ipaalam sa mga end customer na ang mga system ay hindi sumusuporta sa Javascript o hindi ito pinagana. Lubos naming inirerekomenda na ang pag-redirect ay gawin sa loob ng aktibong browser window ng customer at hindi gumamit ng mga pop up window o bagong browser window, dahil maaari itong
mang-inis sa mga customer at humantong sa kanila na isara ang page kung saan sila na-redirect.
- Asynchronous na pagsusuri sa resulta
Ang resulta ng authentication ay ipinapadala nang asynchronous sa iyong server. Inaasahan ng sistema ng pagbabayad ang isang wastong URL bilang tugon. (No. 12 & 13 sa diagram). Para sa matagumpay o tinanggihan
mga pagbabayad, iba URL maaaring masagot dito ng iyong system. - Pabalik na landas ng customer
Ang sistema ng pagbabayad ay nagre-redirect sa customer sa URL na ibinigay ng sistema ng merchant pagkatapos makumpleto ang proseso ng pagpapatunay at ang transaksyon sa pagbabayad.
Pakitandaan: Mga Hakbang 4.) at 5.) magpatuloy sa eksaktong parehong paraan tulad ng pamilyar ka na sa mga umiiral nang WALA 3D Secure na transaksyon.
3D Secure at Umuulit na Pagbabayad
Mula sa ika-1 ng Enero 2021, ang 3D Secure ay magiging mandatoryo para sa lahat ng mga transaksyon sa e-commerce card. Gayunpaman, dahil halos hindi ito naaangkop para sa mga umuulit na pagbabayad, ang pagbabangko
Ang mga system ay may hiwalay na daloy ng trabaho para dito.
Para sa layuning ito, ang mga bangko ay nakikilala sa pagitan
- CIT = mga transaksyong pinasimulan ng customer
- MIT = mga transaksyong pinasimulan ng merchant
Ang unang transaksyon ng isang card sa iyong merchant account ay dapat ma-authenticate gamit ang 3D Secure mula 01.01.2021. Ang nasabing matagumpay na pagpapatotoo ay isang ipinag-uutos na kinakailangan sa
upang makapagsumite ng karagdagang mga booking sa parehong card nang walang 3D Secure. Samakatuwid, ang customer ay dapat na ipasa sa kanyang card-issuing bank para sa unang debit in
alinsunod sa pamamaraang inilarawan sa itaas at patotohanan ang kanyang sarili doon bilang may hawak ng card. Kung ang isang debit ay hindi binalak sa oras ng order, halimbawaampdahil sa panahon ng pagsubok, ang isang reserbasyon (pre-authorization) ng hindi bababa sa isang euro ay dapat gawin gamit ang 3D Secure sa halip na ang customer. Ang pagkuha ng reserbasyon na ito ay hindi kinakailangan.
Para sa mga kasalukuyang customer, gayunpaman, walang 3D Secure na pagpapatotoo ang kailangang gawin. Kung ang unang matagumpay na pag-debit ay naganap bago ang 01.01.2021, ang rekord ng customer ay maaari ding ipagpalagay na
ay matagumpay na napatotohanan. Para sa mga bagong customer simula 01.01.2021, sa kabilang banda, ang 3D Secure authentication ay mandatory para sa unang debit o reservation (pre-authorization).
Pakitandaan: Sa bagay na ito, tinitingnan ng banking system ang data ng card, hindi ang data ng customer. Kaya kung ang isang umiiral nang customer ay gumagamit ng bagong card pagkatapos ng 01.01.2021, para sa halample dahil ang nakaraan
ang isa ay nag-expire na o dahil pinalitan niya ang kanyang bank-issuing bank, ito ay isang bagong umuulit na cycle mula sa punto ng mga bangko ng view at dapat ma-authenticate sa 3D Secure para sa unang booking.
Sa sandaling matagumpay na naisagawa ang paunang pagpapatunay na ito, ang lahat ng karagdagang transaksyon ay hindi kasama sa obligasyong gumamit ng 3D Secure Ang mga kinakailangan para sa paulit-ulit na pagbabayad nang walang 3D Secure ay samakatuwid ay:
- Mayroong hindi bababa sa isang matagumpay na pag-debit o reservation (pre-authorization) na maaaring isagawa gamit ang 3D Secure o naganap bago ang 01.01.2021.
- ito ay tinutukoy sa isang umiiral na pagpaparehistro at pag-debit sa pagsumite
Upang ipaalam sa sistema ng pagbabayad, na ito ay isang umuulit na pagbabayad, ang parameter na RECURRENCE.MODE=REPEATED ay dapat ding ipadala. Ito ay hudyat sa sistema na a
ang paulit-ulit na pagbabayad ay iuulat sa mga sistema ng pagbabangko.
Pakitandaan: Kung ang parameter na RECURRENCE.MODE=REPEATED ay ipinasok kapag ang isang bagong card ay na-load sa unang pagkakataon, ang 3D Secure na pagpapasa ay isasagawa sa kabila ng parameter na ito.
Pagsubok sa pagpapatupad ng 3D Secure
Maaari mong subukan ang 3D Secure na koneksyon anumang oras sa pamamagitan ng aming sistema ng pagbabayad. Upang gawin ito, gamitin ang mode na "CONNECTOR_TEST" para sa isang transaksyon, tulad ng ipinapakita sa examples sa itaas.
Data ng koneksyon para sa pagsubok na ito:
| SECURITY.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| USER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSACTION.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| Mga pera na na-configure para sa 3D na Bersyon 2 | EUR, USD, SEK |
| Mga pera na na-configure para sa 3D na Bersyon 1 | GBP, CZK, CHF |
Ang endpoint ng gateway ng system ay alinman
SGW gateway:
– https://test-heidelpay.hpcgw.net/sgw/gtw – Latin-15 na naka-encode
– https://test-heidelpay.hpcgw.net/sgw/gtwu – naka-encode ng UTF-8
NGW gateway:
– https://test-heidelpay.hpcgw.net/ngw/post
Data ng credit card para sa pagsubok na ito:
| mga tatak | mga numero ng card | CVV | petsa ng pag-expire | tala |
| MasterCard | 5453010000059543 | 123 | petsa sa hinaharap | 3D – password: sikreto3 |
| Visa | 4711100000000000 | 123 | petsa sa hinaharap | 3DS – password: sikreto!33 |
Pakitandaan: Para sa 3D Secure na Bersyon 2, hindi mo kailangang maglagay ng password, ngunit i-click lamang ang link na ”Mag-click dito upang makumpleto ang pagpapatunay.
Ang tanging paraan upang gayahin ang isang error sa 3D Secure Bersyon 2 ay ang hayaang mag-time out ang page na may link (humigit-kumulang 18 minuto).
Magbasa Nang Higit Pa Tungkol sa Manwal na Ito at Mag-download ng PDF:
Mga Dokumento / Mga Mapagkukunan
 |
Gabay sa Secure Integration ng Softwares 3D [pdf] Dokumentasyon Unzer, Gabay sa Pagsasama, 3D Secure |
