Autentificarea 3D-Secure

Autentificarea 3D-Secure nu este aplicabilă pentru Batch.

Autentificarea 3-Domain Secure™ (3D-Secure sau 3DS) este concepută pentru a proteja achizițiile online împotriva fraudei cu carduri de credit, permițându-vă să autentificați plătitorul înainte de a trimite o tranzacție de tip Authorization sau Pay. Autentificarea 3DS funcționează prin redirecționarea plătitorului către emitentul cardului, unde introduce o parolă înregistrată anterior.

eGenius Platform acceptă autentificarea 3DS prin Mastercard SecureCode™, Verified by Visa™, J/Secure™, American Express SafeKey™ și Diners Club ProtectBuy™.

Unele câmpuri de solicitare/răspuns pentru operațiunile 3DS au fost actualizate în APIversiunea 47. Pentru asistență în vederea integrării în versiunile anterioare (<=46), faceți clic aici.

Cerințe preliminare

  • Trebuie să fiți înregistrat la achizitorul dvs. pentru a utiliza 3DS.
  • Trebuie să aveți activată o schemă 3DS în profilul dvs. de comerciant din eGenius Platform.

Experiența 3DS a plătitorului

Această secțiune descrie un exemplu de proces de validare pentru site-ul magazinului dvs., unde plătitorul este autentificat folosind 3DS.

Proces de autentificare 3D-Secure

Procesul de validare pentru o autentificare cu succes este următorul:

  1. Un plătitor navighează pe site-ul magazinului dvs., selectează unul sau mai multe produse, continuă către pagina de plată și selectează ca metodă de plată un card care acceptă 3DS.
  2. Verificați înscrierea 3DS: Solicitați eGenius Platform să consulte cu schema cardului pentru a afla dacă respectivul card este înscris la 3DS
  3. Autentificare plătitor: După confirmarea înscrierii cardului, redirecționați browserul plătitorului către pagina de autentificare 3DS a emitentului cardului. Plătitorul introduce parola 3DS și trimite informația. Emitentul returnează rezultatul autentificării către dvs.
  4. Process ACS Result: Solicitați eGenius Platform să proceseze rezultatul autentificării. eGenius Platform vă furnizează detaliile răspunsului de autentificare primit de la emitent.
  5. Utilizare rezultat 3DS într-o operațiune de plată: Trimiteți plata pentru procesare.
  6. Afișați pentru plătitor pagina de confirmare a comenzii.

Integrarea pentru utilizarea autentificării 3DS

Această secțiune descrie modul de integrare cu eGenius Platform pentru utilizarea 3DS.

Pasul 1: Verificarea înscrierii la 3DS

Puteți să verificați dacă un card este înscris, furnizând următoarele câmpuri în solicitarea Check 3DS Enrollment:

  • 3DSecureId: identificatorul dvs. unic pentru această autentificare. Va trebui să includeți acest identificator, identic, în toate operațiunile ulterioare.
  • 3DSecure.authenticationRedirect.responseUrl: adresa URL către care doriți să redirecționați plătitorul după finalizarea procesului de autentificare 3DS
  • order.amount: valoarea totală a comenzii
  • order.currency: moneda comenzii
  • sourceOfFunds.provided.card.* sau session.id sau sourceOfFunds.token: detaliile cardului utilizat pentru plată.

    Simbolul din rețea

    Gateway-ul poate procesa simbolurile din rețea în solicitarea Verificare înscriere 3DS. Simbolurile din rețea obținute de la serviciul de creare de simboluri Mastercard Digital Enablement Service (MDES) și furnizorii de servicii de creare de simbol Visa Token Service (VTS) sunt acceptate în prezent.

    Dacă ați obținut un simbol în rețea prin integrarea directă în furnizorul de servicii de creare de simboluri, atunci trebuie să furnizați detaliile simbolului folosind următoarele câmpuri (simboluri MDES acceptate începând cu API v54 și simboluri VTS acceptate începând cu API v55):

    • sourceOfFunds.type=SCHEME_TOKEN: Permite gateway-ului să identifice sursa fondurilor, introdusă în solicitare sub forma unui simbol din rețea.
    • sourceOfFunds.provided.card.number: Simbolul din rețea. Completați valoarea pentru „PAN simbol” în MDES sau „Simbol” în VTS.
    • sourceOfFunds.provided.card.expiry: (opțional) Data expirării simbolului din rețea.

    Dacă furnizorul de servicii de plată vă permite crearea de simboluri în rețea, orice solicitare pentru un simbol de pe gateway trimisă de comerciant către gateway va determina și încercarea de generare a unui simbol corespunzător în rețea. Gateway-ul va încerca, de asemenea, crearea de simboluri în rețea pentru orice carduri aplicabile deja stocate în depozitul de simboluri de pe gateway. Solicitarea Verificare înscriere 3DS va utiliza simbolul din rețea, dacă este disponibil; în caz contrar, va fi utilizat PAN de finanțare (FPAN) stocat în schimbul simbolului de pe gateway (simboluri MDES acceptate începând cu API v55 și simboluri VTS acceptate începând cu API v56).

  • (Opțional) 3DSecure.goodsDescription: puteți furniza o scurtă descriere a bunurilor achiziționate. Dacă opțiunea este acceptată de serverul emitentului de control al accesului (ACS), această descriere va fi afișată pe pagina de autentificare prezentată plătitorului.

Gateway-ul returnează rezultatele verificării înscrierii în răspuns:

  • 3DSecure.xid: un identificator unic al tranzacției, generat de eGenius Platform pentru autentificarea 3DS.
  • 3DSecure.veResEnrolled: indică dacă autentificarea plătitorului este disponibilă pentru numărul de card respectiv.

Gateway-ul returnează, de asemenea, response.gatewayRecommendation, care poate fi utilizat pentru determinarea pasului următor. Această recomandare se bazează pe regulile 3DS de filtrare a tranzacțiilor, configurate de către dvs. sau furnizorul dvs. de servicii de plată.

response.gatewayRecommendation Pasul următor
PROCEED Puteți continua cu autentificarea plătitorului.
DO_NOT_PROCEED Nu se continuă autentificarea 3DS a cardului. Puteți oferi plătitorului opțiunea de a încerca o altă metodă de plată.

Pentru o integrare avansată, puteți determina pasul următor folosind valoarea returnată în câmpul 3DSecure.veResEnrolled. Aceasta este rezumată în tabelul de mai jos. Consultați documentația schemei cardului pentru a interpreta câmpul „enrolled” din mesajul de răspuns la verificarea înscrierii (VERes).

3DSecure.veResEnrolled Pasul următor
Card înscris Cardul este înscris la 3DS. Continuați cu autentificarea plătitorului.
Card neînscris Cardul nu este înscris la 3DS. Continuați cu operațiunea de plată, incluzând 3DSecureId în solicitare.
Cardul nu acceptă 3DS Cardul nu acceptă 3DS și nu puteți continua autentificarea 3DS.
Autentificare indisponibilă A apărut o eroare. Continuați cu operațiunea de plată, incluzând 3DSecureId în solicitare.

Referință API Check 3DS Enrollment [REST] [NVP]

Pasul 2: Autentificarea plătitorului

Dacă, cardul este înscris (de exemplu, 3DSecure.veResEnrolled = Y)), atunci trebuie să redirecționați browserul plătitorului către site-ul web al emitentului cardului pentru autentificare. Aceasta se realizează returnând conținutul furnizat în 3DSecure.authenticationRedirect.simple.htmlBodyContent către browserul plătitorului.

Aceasta este situația implicită. Puteți opta să particularizați formularul.
Pasul 3: Procesare rezultat autentificare

Când procesul de autentificare la site-ul web al emitentului cardului este finalizat, serverul de control al accesului (ACS) al emitentului returnează către dvs. răspunsul de autentificare sub forma unei operațiuni post HTTP către adresa URL de răspuns (3DSecure.authenticationRedirect.responseUrl) specificată de dvs. în solicitarea de verificare a înscrierii 3DS.

Răspunsul de autentificare pentru plată (PARes), care vă este returnat, este furnizat ca valoare codificată base64. Pentru a decodifica această valoare, transferați PARes în câmpul 3DSecure.paRes din operațiunea Process ACS Result și trimiteți operațiunea. Gateway-ul furnizează rezultatele autentificării în răspuns:

  • 3DSecure.veResEnrolled: indică dacă autentificarea plătitorului este disponibilă pentru numărul de card respectiv.
  • 3DSecure.paResStatus: indică rezultatul autentificării plătitorului la emitent. Acest câmp nu este returnat dacă PaRes este nevalid. Consultați documentația relevantă a schemei cardului pentru a determina pasul următor.

Gateway-ul returnează, de asemenea, response.gatewayRecommendation, care poate fi utilizat pentru determinarea pasului următor. Rețineți că această recomandare se bazează numai pe regulile 3DS de filtrare a tranzacțiilor, configurate de către dvs. sau furnizorul dvs. de servicii de plată.

response.gatewayRecommendation Pasul următor
PROCEED Puteți continua cu operațiunea de plată, incluzând 3DSecureId în solicitare.
DO_NOT_PROCEED Nu continuați cu trimiterea unei operațiuni de plată. Puteți oferi plătitorului opțiunea de a încerca o altă metodă de plată.

Pentru o integrare avansată, puteți determina pasul următor folosind valoarea returnată în câmpul 3DSecure.paResStatus. Aceasta este rezumată în tabelul de mai jos. Consultați documentația schemei cardului pentru a interpreta câmpul „status” din mesajul PARes.

3DSecure.paResStatus Pasul următor
Autentificare realizată cu succes Autentificarea plătitorului a avut succes. Continuați cu operațiunea de plată, incluzând 3DSecureId în solicitare.
Autentificare eșuată Autentificarea plătitorului a eșuat. Trebuie să nu continuați cu operațiunea de plată. Este contrar regulilor schemei să continuați.
Autentificare încercată A fost încercată autentificarea plătitorului, dar nu a putut fi finalizată. Continuați cu operațiunea de plată, incluzând 3DSecureId în solicitare.
Autentificare indisponibilă A apărut o eroare. Continuați cu operațiunea de plată, incluzând 3DSecureId în solicitare.

Referință API Process ACS Result [REST] [NVP]

Pasul 4: Utilizare rezultat 3DS într-o operațiune de plată

Dacă rezultatul operațiunii Check 3DS Enrollment sau Process ACS indică faptul că puteți continua plata, puteți să inițiați o operațiune Authorize sau Pay. Includeți în solicitare codul 3DSecureId furnizat în operațiunea Check 3DS Enrollment. Nu este necesar să includeți niciunul dintre parametrii din grupul de parametri 3D-Secure, deoarece gateway-ul va utiliza valoarea 3DSecureId pentru a căuta rezultatele autentificării pe care le-a salvat în momentul în care ați solicitat procesarea rezultatului autentificării. Gateway-ul va transmite achizitorului informațiile solicitate.

Unele rezultate ale autentificării sunt autentificări eșuate, pentru care nu trebuie procesată o plată. În astfel de cazuri, gateway-ul va returna rezultatul result = ERROR în răspunsul pentru operațiunea de plată. Puteți oferi plătitorului opțiunea de a încerca o altă metodă de plată.

Referință API 3DSecureId on Authorize [REST] [NVP]

Referință API 3DSecureId on Pay [REST] [NVP]

Alte opțiuni

Utilizarea conversiei valutare dinamice (DCC) și a 3DS

Înainte de a verifica înscrierea la 3DS, puteți trimite o solicitare de cotație de schimb pentru conversie valutară dinamică (DCC) pentru a afla moneda plătitorului și suma comenzii în acea monedă. Dacă plătitorul acceptă oferta DCC, trebuie să includeți informațiile DCC în solicitarea Check 3DS Enrollment.

Referință API DCC la Check 3DS Enrollment] [NVP]

Particularizarea formularului utilizat pentru redirecționarea plătitorului pentru autentificare

Codul HTML necesar pentru formularul utilizat pentru redirecționarea plătitorului pentru autentificare poate fi generat utilizând una dintre următoarele două metode de generare a paginii:

  1. Simple: eGenius Platform generează formularul HTML. Formularul completat este returnat în cadrul răspunsului Check 3DS Enrollment. Aceasta este opțiunea implicită.
  2. Customized: Vă veți genera propriul formular HTML personalizat, utilizând parametrii furnizați în răspunsul Check 3DS Enrollment.

Răspunsul la operațiunea Check 3DS Enrollment va include informațiile necesare pentru opțiunea selectată.

(Opțional) Particularizarea formularului simplu

Puteți să modificați formularul simplu generat prin setarea 3DSecure.authenticationRedirect.pageGenerationMode = SIMPLE în solicitarea Check 3DS Enrollment, specificând apoi valori pentru unul sau mai mulți parametri:

  • 3DSecure.authenticationRedirect.simple.expectedHtmlEncoding
  • 3DSecure.authenticationRedirect.simple.redirectDisplayBackgroundColor
  • 3DSecure.authenticationRedirect.simple.redirectDisplayContinueButtonText
  • 3DSecure.authenticationRedirect.simple.redirectDisplayTitle

(Opțional) Generați propriul dvs. formular particularizat

Puteți să specificați faptul că veți genera propriul dvs. formular setând 3DSecure.authenticationRedirect.pageGenerationMode = CUSTOMIZED în solicitarea Check 3DS Enrollment. Răspunsul va include următorii parametri:

  • 3DSecure.authenticationRedirect.customized.acsUrl: Adresa URL a serverului de control al accesului (ACS) al emitentului, unde plătitorul poate fi autentificat.
  • 3DSecure.authenticationRedirect.customized.paReq: Mesajul Solicitare autentificare plătitor (PAReq), ce va fi trimis către ACS pentru a iniția autentificarea plătitorului.

Includeți aceste valori în formularul dvs., împreună cu adresa URL la care să fie returnat plătitorul după finalizarea autentificării.

Un exemplu de formular particularizat este prezentat mai jos.

    
  <!-- Populate the form action attribute with the value returned in the 3DSecure.authenticationRedirect.customized.acsUrl response parameter -->
<form name="3dsRedirect" action="[3DSecure.authenticationRedirect.customized.acsUrl]" method="POST" accept-charset="UTF-8">
<!-- Populate the mandatory PaReq parameter with the value returned in the 3DSecure.authenticationRedirect.customized.paReq response parameter. -->
<input type="hidden" name="PaReq" value="[3DSecure.authenticationRedirect.customized.paReq]"/>
<!-- Populate the mandatory TermUrl value with the URL to which you want the payer returned when the authentication process has completed. This should be the same value as supplied in the 3DSecure.authenticationRedirect.responseUrl parameter to the CHECK_ENROLLMENT request. -->
<input type="hidden" name="TermUrl" value="https://merchant.com/3ds/return"/>
<!-- The ACS will echo the contents of the mandatory MD parameter when the payer is returned to the URL specified in the TermUrl parameter. You can use this parameter to establish a link between the ACS request and response. -->
<input type="hidden" name="MD" value="[mdvalue]"/>
<input type="submit" value="Click here to continue" class="button">
</form>

Referință API personalizare formular la Check 3DS Enrollment[REST] [NVP]

Trimiterea unei operațiuni de plată pre-autentificate

Dacă ați utilizat un MPI 3DS extern pentru a autentifica plătitorul, trebuie să furnizați informațiile referitoare la autentificare în grupul de parametri de autentificare pentru operațiunea Pay sau Authorize.

Toate câmpurile sunt opționale, deoarece starea de autentificare a tranzacției indică dacă acestea v-au fost sau nu furnizate de către MPI 3DS extern. Dacă, însă, dispuneți de aceste date, este recomandat să le furnizați.

  • authentication.3ds.acsEci: Indicatorul de comerț electronic care vă poate fi returnat în mesajul de răspuns de autentificare.
  • authentication.3ds.authenticationToken: Valoarea codificată base64 generată de emitentul cardului care vă poate fi returnată în mesajul de răspuns de autentificare.
  • authentication.3ds.transactionId: Un identificator unic al tranzacției, generat de gateway pentru autentificarea 3DS. Acest câmp corespunde XID, care este un identificator generat de gateway în numele comerciantului. Un XID trimis în acest câmp trebuie să aibă formatul base64.
  • authentication.3ds1.paResStatus: Indică rezultatul autentificării plătitorului la emitent.
  • authentication.3ds1.veResEnrolled: Indică dacă autentificarea plătitorului este disponibilă sau nu pentru numărul de card furnizat.
Mastercard/Visa solicită ca, dacă utilizați Mastercard SecureCode/Verified by Visa și dacă a fost inițiată o încercare de autentificare, să furnizați authentication.3ds.authenticationToken.

Referință API 3DS pre-autentificat la autorizare [REST] [NVP]

Referință API 3DS pre-autentificat la plată [REST] [NVP]

Recuperarea rezultatelor autentificării 3DS

Dacă doriți să recuperați rezultatele autentificării, în orice moment, utilizați operațiunea Retrieve 3DS Result.

Referință API Retrieve 3DS Result [REST] [NVP]

Întrebări frecvente

Cum pot determina starea de înscriere și starea de autentificare?

Gateway-ul furnizează starea de înscriere și starea de autentificare în câmpul 3DSecure.veResEnrolled, respectiv câmpul 3DSecure.paResStatus.

VERes este mesajul returnat de schema cardului către gateway ca răspuns la o solicitare de verificare a înscrierii la 3DS. PARes este mesajul de răspuns returnat către gateway ca răspuns la o solicitare de autentificare a plătitorului.

Consultați documentația schemei cardului pentru a interpreta valorile returnate în câmpurile 3DSecure.veResEnrolled și 3DSecure.paResStatus.

Cum pot vizualiza detaliile de autentificare în cadrul portalului Administrare cont comerciant?

Dacă ați trimis detaliile 3DS pentru o tranzacție, căutați comanda sau tranzacția în cadrul portalului Administrare cont comerciant. Vizualizați detaliile comenzii, apoi selectați legătura pentru a vizualiza detaliile de autentificare.

Dacă doriți să vizualizați detaliile pentru o autentificare pentru care nu ați continuat plata (de exemplu, o autentificare eșuată), atunci utilizați opțiunea de căutare a autentificărilor din cadrul portalului Administrare cont comerciant.

Pot oferi 3DS plătitorului în mod condiționat?

Da, puteți evita autentificarea 3DS pentru plătitori atunci când asiguratorul extern al riscului consideră că plata are un nivel scăzut de risc. Pentru mai multe informații, consultați Dynamic 3DS.

Testarea integrării

Vă puteți testa integrarea pentru realizarea autentificării 3DS prin intermediul eGenius Platform, utilizând emulatorul ACS. Acesta vă permite să selectați un anumit rezultat de autentificare 3DS (returnat în răspunsul la tranzacție în câmpul 3DSecure.paResStatus).

Copyright © 2021 UniCredit Bank