Integration Types
Alte caracteristici
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Această pagină furnizează detalii despre modul în care puteți configura autentificarea plătitorului folosind 3-D Secure atunci când utilizați Hosted Checkout. Hosted Checkout poate fi configurat pentru a utiliza fie 3DS1 veche, fie funcționalitatea API de autentificare.
Prin urmare, dacă utilizați în prezent numai 3DS1 și doriți să începeți să utilizați 3DS2, poate fi necesar să configurați integrarea Hosted Checkout pentru a utiliza funcționalitatea API-ului de autentificare.
În funcție de configurația Hosted Checkout pentru funcționalitatea de autentificare a plătitorului (numită „configurație” pe scurt), următoarele pot varia:
Acest lucru înseamnă că schimbarea configurației dvs. vă poate afecta integrarea cu gateway-ul și poate fi necesar să faceți modificări înainte de a putea schimba această configurație (și să utilizați funcționalitatea nouă). Pentru a facilita tranziția, puteți actualiza mai întâi configurația numai pentru profilul dvs. de TESTARE comerciant. Acest lucru nu va afecta tranzacțiile procesate cu profilul dvs. de comerciant de producție.
După ce ați actualizat integrarea și ați testat-o cu succes folosind profilul de TESTARE comerciant, puteți actualiza și configurația profilului dvs. de comerciant de producție.
Următoarele secțiuni furnizează detalii privind modificările pe care le veți observa la schimbarea configurației de la 3DS1 vechi la funcționalitatea API-ului de autentificare.
Utilizați următoarele carduri de testare pentru a testa integrarea
Tip de card | Stare autentificare | Card de testare |
---|---|---|
Mastercard | 3DS2 - Testare | 5123450000000008 |
Mastercard | 3DS1 – Neînscris la 3DS2, ceea ce are ca rezultat utilizarea 3DS1 ca soluție de rezervă | 5506900140100305 |
Visa | 3DS2 - Testare | 4440000009900010 |
Visa | 3DS1 – Neînscris la 3DS2, ceea ce are ca rezultat utilizarea 3DS1 ca soluție de rezervă | 4508750015741019 |
API-ul de autentificare înregistrează detaliile de autentificare a plătitorului folosind 3DS1 sau 3DS2 ca tranzacție AUTHENTICATION separată în cadrul comenzii.
Pentru detalii privind tranzacțiile AUTHENTICATION, consultați lista de parametri de răspuns pentru operațiunea Authenticate Payer.
Acest lucru înseamnă că, atunci când
Când utilizați funcționalitatea API-ului de autentificare, puteți:
În funcție de configurația Hosted Checkout pentru autentificarea plătitorului, comportamentul poate varia pentru următoarele funcționalități.
Configurația Hosted Checkout | Parametrii răspunsului |
---|---|
3DS1 vechi | Parametrii de răspuns 3DS1 sunt returnați în grupul de parametri 3DSecure. |
API de autentificare | Parametrii comuni pentru 3DS1 și 3DS2 sunt returnați în grupul de parametri authentication.3ds. Parametrii specifici pentru 3DS1 sunt returnați în grupul de parametri authentication.3ds1. Parametrii specifici pentru 3DS2 sunt returnați în grupul de parametri authentication.3ds2. |
Puteți configura funcționalitatea de autentificare a plătitorului folosită de Hosted Checkout în Administrare cont comerciant. Navigați la Administrare > Setări integrare > Hosted Checkout.
Rețineți că, pentru a accesa această paginăm trebuie să aveți alocat dreptul „Poate configura Setări de integrare”. Contactați administratorul pentru a solicita acest privilegiu.
Acest tabel descrie valorile din câmpurile Payer Authentication.
Valoarea pentru câmpul Autentificare plătitor | Descriere |
---|---|
Selectați... | În prezent, puteți avea configurată funcționalitatea 3DS1 veche sau funcționalitatea API de autentificare. Dacă nu știți sigur care este versiunea configurată pentru dvs., contactați furnizorul de servicii de plată. |
3DS1 vechi | Hosted Checkout utilizează funcționalitatea 3DS1 veche pentru a efectua autentificarea plătitorului. Dacă profilul dvs. de comerciant este configurat pentru 3DS1 pentru schema respectivă, Hosted Checkout va încerca să autentifice plătitorul folosind 3DS1. |
API de autentificare | Hosted Checkout utilizează funcționalitatea API-ului de autentificare veche pentru a efectua autentificarea plătitorului. Dacă profilul dvs. de comerciant este configurat pentru 3DS2 pentru schema respectivă, Hosted Checkout va încerca să autentifice plătitorul folosind 3DS2, putând reveni la 3DS1. Pentru detalii, consultați Autentificarea 3-D Secure. Rețineți că, dacă vă modificați profilul de comerciant de TESTARE/producție, modificările se vor aplica numai interacțiunilor Hosted Checkout cu profilul de comerciant de TESTARE/producție. Comportamentul profilului dvs. de comerciant de producție/TESTARE va rămâne același. |
Tabelul de mai jos indică principalele diferențe de comportament al gateway-ului în privința câmpurilor comune, a căutării detaliilor de autentificare pe portal și a apelării stării 3DS în timpul utilizării 3DS1 vechi și a API-ului de autentificare.
3DS1 vechi | API de autentificare |
---|---|
3DSecure.acsEci | authentication.3ds.acsEci |
3DSecure.authenticationToken | authentication.3ds.authenticationToken |
3DSecure.paResStatus | authentication.3ds1.paResStatus |
3DSecure.veResEnrolled | authentication.3ds1.veResEnrolled |
3DSecure.xid | authentication.3ds.transactionId Rețineți că, pentru 3DS2, acest câmp corespunde cu identificatorul alocat de serverul de directoare al schemei |
Căutarea detaliilor autentificărilor pe portaluri | |
Căutare autentificări pentru plată | Căutare Comenzi și Tranzacții |
Apelarea rezultatelor 3DS folosind API-uri | |
Retrieve 3DS Result (RETRIEVE_3DS_RESULT) | Retrieve Order (RETRIEVE_ORDER) sau Retrieve Transaction (RETRIEVE_TRANSACTION) Rețineți că gateway-ul creează o tranzacție separată cu tipul de tranzacție „Autentificare” pentru autentificările procesate prin noile API-uri de autentificare |