Softwares 3D Secure Integration Guide -dokumentaatio
Integrointiopas 3D Secure
01.01.2021 alkaen kaksivaiheinen todennus otetaan käyttöön pakollisena vaatimuksena kaikissa verkkokaupan korttimaksutapahtumissa. Tämän velvoitteen täyttämiseksi
luottokorttiverkkojen operaattorit käyttävät ns. 3D Secure -menettelyä. Sinulle kauppiaalle on pakollista pystyä suorittamaan tämä toimenpide asiakkaillesi alkaen
01.01.2021 Seuraavasta löydät kuvauksen eri integrointitavoista ja siitä, kuinka 3D Secure -menettely tulee toteuttaa niille.
Valitse käyttämäsi integrointimenetelmä
- Käytätkö kassalomaketta hCO?
- Käytätkö kassalomaketta hPF?
- Käsitteletkö maksuja käyttämättä Unzer-järjestelmän tarjoamaa lomaketta?
Huomaa: Tärkeää on myös se, millä tavalla veloitukset tai ennakkovaraukset (varaukset) tehdään. Vaikka käyttäisit Unzer GmbH:n maksulomaketta korttitietojen rekisteröintiin, 3D Secure -prosessi suoritetaan ilman kassalomaketta, kun korttitietoja veloitetaan tai valtuutetaan ensimmäisen kerran. Tässä tapauksessa sovelletaan kolmatta tapaa integroida ilman Unzerin toimittamaa lomaketta.
Huomaa myös:
Jos käytät toistuvia maksuja (tilausmaksuja), muista lukea kohta "3D Secure and Recurring Payment".
3D Secure -menettely käytettäessä hCO:n kassalomaketta
hCO-maksulomake on jo suunniteltu 3D Secure -menettelyä varten. Toimenpiteen toteuttaminen ei vaadi sinun puoleltasi lisätoimenpiteitä. Kuitenkin sinä
on varmistettava, että järjestelmäsi pystyy käsittelemään maksujärjestelmämme vastaavat vastaukset, jos 3D Secure -prosessi käynnistyy. Vuonna asynkroninen vastaus
maksujärjestelmä palvelimellesi, tapahtuman tulos välitetään ja se on arvioitava siellä ennen palautusta URL välitetään maksujärjestelmään.
Tätä tarkoitusta varten seuraavat parametrit on arvioitava.
- KÄSITTELY.PALAUTUSKOODI = 000.200.000
- PROCESSING.RETURN = Tapahtuma+odottaa
- PROCESSING.RESULT = ACK
Selitys: Tapahtuman tila on "odottaa", parametri PROCESSING.RESULT
edustaa vain alustavaa tulosta. Niin kauan kuin 3D Secure -prosessi on suoritettu, tila
jää odottamaan.
Kaupan lopputulos on sitten joko
- KÄSITTELY.PALAUTUSKOODI = 000.000.000
- PROCESSING.RESULT = ACK
or - KÄSITTELY.PALAUTUSKOODI = irgendein Wert ungleich 000.000.000 tai 000.200.000
- PROCESSING.RESULT = NOK
Ensimmäisessä tapauksessa tapahtuma on suoritettu onnistuneesti, toisessa tapauksessa se on epäonnistunut kokonaisuudessaan. Jälkimmäinen voi johtua useista syistä, mukaan lukien todentamisesta kieltäytyminen. Tulet
saat tarkempia tietoja parametreista “PROCESSING.RETURN” ja “PROCESSING.RETURN.CODE”.
Suosittelemme, että suoritat testin molemmille viesteille. Lisätietoja testin tekemisestä ja siitä, mitä luottokorttitietoja voit käyttää testissä, on alla.
3D Secure -menettely käytettäessä hPF:n kassalomaketta
hPF-maksulomake on myös suunniteltu käyttämään jo 3DS-menettelyä. Toimenpiteen toteuttaminen ei vaadi sinun puoleltasi lisätoimenpiteitä. Kuten on kuvattu
hCO-toteutuksessa vastaus maksujärjestelmästä tapahtuu kahdessa vaiheessa, minkä vuoksi järjestelmäsi tulee tarkistaa PROCESSING.RETURN.CODE-arvon arvo.
parametri, kun käsitellään vastausta.
Tätä tarkoitusta varten seuraavat parametrit on arvioitava.
- KÄSITTELY.PALAUTUSKOODI = 000.200.000
- PROCESSING.RETURN = Tapahtuma+odottaa
- PROCESSING.RESULT = ACK
Selitys: Tapahtuman tila on "odottaa", parametri PROCESSING.RESULT edustaa vain alustavaa tulosta. Niin kauan kuin 3D Secure -prosessi on suoritettu, tila
jää odottamaan.
Kaupan lopputulos on sitten joko
- KÄSITTELY.PALAUTUSKOODI = 000.000.000
- PROCESSING.RESULT = ACK
or - KÄSITTELY.PALAUTUSKOODI = irgendein Wert ungleich 000.000.000 tai 000.200.000
- PROCESSING.RESULT = NOK
Ensimmäisessä tapauksessa tapahtuma on suoritettu onnistuneesti, toisessa tapauksessa se on epäonnistunut kokonaisuudessaan. Jälkimmäinen voi johtua useista syistä, mukaan lukien todentamisesta kieltäytyminen. Tulet
saat tarkempia tietoja parametreista “PROCESSING.RETURN” ja “PROCESSING.RETURN.CODE”.
Suosittelemme, että suoritat testin molemmille viesteille. Lisätietoja testin tekemisestä ja siitä, mitä luottokorttitietoja voit käyttää testissä, on alla.
3D Secure -menettely suoralla yhteydellä
Jos et käytä Unzerin (entinen heidelpay) tarjoamaa maksulomaketta luottokorttimaksujen käsittelyyn tai jos yksinkertaisesti rekisteröit kortin jollakin lomakkeista ja käsittelet ennakkovaltuutuksen (varauksen) tai veloituksen viittauksena rekisteröintiin Suoraan yhteydenpitoon maksujärjestelmän kanssa, sinun on otettava käyttöön 3D Secure -prosessi.
Asynkroninen tapahtumakulku:
Tämä on asynkroninen prosessi, jossa palvelimesi vastaanottaa edelleenlähetyksen URL (Uudelleenohjaus URL) maksujärjestelmästämme. Palvelimesi on välitettävä asiakas tähän URL jotta hän voi suorittaa todennuksen 3D Secure -menettelyn avulla. Kortin myöntänyt pankki raportoi tämän 3D Secure -todennuksen tuloksen suoraan Unzerille.
Onnistuneen todennuksen jälkeen tapahtuma käsitellään edelleen Unzer-järjestelmässä tietämälläsi tavalla lähettämällä järjestelmällesi lopussa kokonaistulos, johon vastaat
uudelleenohjauksen kanssa URL. Maksujärjestelmä ohjaa sitten asiakkaan takaisin järjestelmääsi käyttämällä tätä uudelleenohjausta URL järjestelmästäsi
Huomaa: Tässä työnkulussa järjestelmäsi saa kaksi vastausta maksujärjestelmältä:
– Yksi, jonka tila on "odottaa" (PROCESSING.RETURN.CODE=000.200.000 ja PROCESSING.RETURN=Tapahtuma+odottaa) ja uudelleenohjausparametrit asiakkaan kortin myöntäneeseen pankkiin
– Yksi, jossa on veloituksen tai varauksen lopputulos. Uudelleenohjausta on myös kaksi URLTässä prosessissa mainittuja, yksi maksujärjestelmästä, johon asiakas on uudelleenohjattava tunnistautumaan korttinsa myöntävään pankkiinsa, ja toinen järjestelmästäsi lopputuloksen saatuaan, joka ohjaa asiakkaan takaisin järjestelmääsi.
Seuraavat muutokset tehdään normaaliin menettelyyn. Huomaa, että muiden asynkronisten maksutapojen, kuten Paypalin, käyttöönoton vuoksi jotkut näistä
prosessit saattavat jo olla toteutuksessasi.
- Vastaus URL
Ensimmäisessä puhelussa (nro 2 kaaviossa) maksujärjestelmään tulee ”Vastaus URL” on läpäistävä käyttöliittymäryhmässä.
Huomaa: Parametri IDENTIFICATION.REFERENCEID on merkityksellinen vain, jos viittaat rekisteröintiin tai muuhun jo olemassa olevaan tapahtumaan - Käsitellään uudelleenohjausta URL Jos todennus vaaditaan, uudelleenohjaus URL ja muut uudelleenohjausryhmän parametrit siirretään vastauksessa maksujärjestelmästä (kaaviossa nro 5).
- Asiakkaan välittäminen uudelleenohjaukseen URL
Jos uudelleenohjausryhmä vastaa uudelleenohjauksella URL, asiakkaan selain on ohjattava tähän URL (nro 6 kaaviossa) todennuksen suorittamiseksi. Uudelleenohjausryhmän lisäparametrit on siirrettävä ulkoiseen websivusto POST-parametreina.
Huomaa: "PROCESSING.REDIRECT.xxx"-ryhmässä palautetaan lisäparametreja vain 3D Securen versiossa 1 (jopa sielläkin numero ja nimeäminen voivat vaihdella), kun taas 3D-versiossa 2 vain PROCESSING.REDIRECT.URL alla näkyvällä tavalla palautetaan: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF/run Tämä tarkoittaa, että riippumatta parametrien tyypistä ja lukumäärästä asiakasselaimen on ohjattava uudelleen PROCESSING.REDIRECT-tiedostoon.URL.
Alta löydät yksinkertaisen koodin esimampmiten tällainen uudelleenohjaus voidaan suorittaa. The osa on tarkoitettu informoimaan loppuasiakkaita, joiden järjestelmät eivät tue Javascriptiä tai ovat poistaneet sen käytöstä. Suosittelemme vahvasti, että uudelleenohjaus tehdään asiakkaan aktiivisessa selainikkunassa eikä ponnahdusikkunoita tai uusia selainikkunoita, koska tämä saattaa
ärsyttää asiakkaita ja saada heidät sulkemaan sivu, jolle heidät ohjataan.
- Asynkroninen tulosten tarkistus
Todennuksen tulos lähetetään asynkronisesti palvelimellesi. Maksujärjestelmä odottaa kelvollista URL vastauksena. (Nro 12 ja 13 kaaviossa). Onnistuneille tai hylätyille
maksut, eri URL järjestelmäsi voi vastata tähän. - Asiakkaan paluupolku
Maksujärjestelmä ohjaa asiakkaan osoitteeseen URL kauppiaan järjestelmä tarjoaa sen jälkeen, kun todennusprosessi ja maksutapahtuma on suoritettu.
Huomaa: Vaiheet 4.) ja 5.) jatkavat täsmälleen samalla tavalla kuin olet jo perehtynyt olemassa oleviin NONE 3D Secure -tapahtumiin.
3D-suojattu ja toistuva maksu
1 alkaen 2021D Secure on pakollinen kaikissa verkkokaupan korttitapahtumissa. Koska tämä tuskin pätee toistuviin maksuihin, pankki
järjestelmissä on tätä varten erillinen työnkulku.
Tätä tarkoitusta varten pankit erottavat toisistaan
- CIT = asiakkaan alustamat tapahtumat
- MIT = kauppiaan alustamat tapahtumat
Kauppiastilisi ensimmäinen korttitapahtuma tulee todentaa 3D Securella 01.01.2021 alkaen. Tällainen onnistunut todennus on pakollinen vaatimus
voidakseen tehdä myöhemmin lisää varauksia samalla kortilla ilman 3D Securea. Asiakas on siksi ohjattava korttinsa myöntäneeseen pankkiin ensimmäistä veloitusta varten
edellä kuvatun menettelyn mukaisesti ja todistaa itsensä siellä kortinhaltijaksi. Jos veloitusta ei ole suunniteltu tilaushetkellä, esimampKoeajan vuoksi vähintään yhden euron varaus (ennakkovaraus) tulee tehdä 3D Securella asiakkaan läsnä ollessa. Tämän varauksen tallentaminen ei ole välttämätöntä.
Nykyisille asiakkaille ei kuitenkaan tarvitse tehdä 3D Secure -todennusta. Jos ensimmäinen onnistunut veloitus tapahtui ennen 01.01.2021, asiakastietueen voidaan olettaa myös olevan
on todennettu onnistuneesti. Sen sijaan uusille asiakkaille 01.01.2021 alkaen 3D Secure -todennus on pakollinen ensimmäisellä veloituksella tai varauksella (ennakkovarmennus).
Huomaa: Pankkijärjestelmä katsoo tässä suhteessa korttitietoja, ei asiakastietoja. Eli jos olemassa oleva asiakas käyttää uutta korttia 01.01.2021 jälkeen, esimample koska edellinen
yksi on vanhentunut tai koska hän on vaihtanut korttinsa myöntävää pankkia, tämä on uusi toistuva sykli pankkien näkökulmasta view ja se on todennettu 3D Securella ensimmäistä varausta varten.
Kun tämä ensimmäinen todennus on suoritettu onnistuneesti, kaikki muut tapahtumat vapautetaan 3D Securen käyttövelvollisuudesta. Edellytykset toistuvalle maksulle ilman 3D Securea ovat siis:
- On olemassa vähintään yksi onnistunut veloitus tai varaus (ennakkovaraus), joka on joko suoritettu 3D Securella tai tehty ennen 01.01.2021.
- se viittaa olemassa olevaan rekisteröintiin ja veloitukseen lähetyksen yhteydessä
Jotta maksujärjestelmä tietää, että kyseessä on toistuva maksu, on myös lähetettävä parametri RECURRENCE.MODE=REPEATED. Tämä osoittaa järjestelmälle, että a
toistuvista maksuista on ilmoitettava pankkijärjestelmille.
Huomaa: Jos parametri RECURRENCE.MODE=REPEATED syötetään, kun uusi kortti ladataan ensimmäisen kerran, 3D Secure -välitys suoritetaan tästä parametrista huolimatta.
Testataan 3D Securen toteutusta
Voit testata 3D Secure -yhteyttä milloin tahansa maksujärjestelmämme kautta. Käytä tätä varten "CONNECTOR_TEST" -tilaa tapahtumalle, kuten esimamples edellä.
Tämän testin yhteystiedot:
| TURVALLISUUS.LÄHETTÄJÄ | 31HA07BC8142C5A171745D00AD63D182 |
| KÄYTTÄJÄ.KIRJAUDU | 31ha07bc8142c5a171744e5aef11ffd3 |
| KÄYTTÄJÄ.PWD | 93167DE7 |
| TRANSACTION.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D-versiota 2 varten määritetyt valuutat | EUR, USD, SEK |
| 3D-versiota 1 varten määritetyt valuutat | GBP, CZK, CHF |
Järjestelmän yhdyskäytävän päätepiste on joko
SGW-yhdyskäytävä:
– https://test-heidelpay.hpcgw.net/sgw/gtw – Latin-15-koodattu
– https://test-heidelpay.hpcgw.net/sgw/gtwu – UTF-8-koodattu
NGW-yhdyskäytävä:
– https://test-heidelpay.hpcgw.net/ngw/post
Tämän testin luottokorttitiedot:
| tuotemerkit | korttien numerot | CVV | viimeinen käyttöpäivä | huomautus |
| MasterCard | 5453010000059543 | 123 | tulevaisuuden päivämäärä | 3D – salasana: secret3 |
| Visa | 4711100000000000 | 123 | tulevaisuuden päivämäärä | 3DS – salasana: salainen!33 |
Huomaa: 3D Secure -versiossa 2 sinun ei tarvitse syöttää salasanaa, vaan klikkaa linkkiä ”Suorita todennus loppuun napsauttamalla tätä.
Ainoa tapa simuloida virhettä 3D Secure -versiolla 2 on antaa linkin sisältävän sivun aikakatkaisu (noin 18 minuuttia).
Lue lisää tästä oppaasta ja lataa PDF:
Asiakirjat / Resurssit
 |
Ohjelmistojen 3D Secure Integration Guide [pdfDokumentaatio Unzer, integrointiopas, 3D Secure |
