Crearea de simboluri de rețea
Un simbol din rețea (cunoscut și sub denumirea de simbol de schemă card) este un simbol generat de furnizorii de servicii de creare de simboluri în rețea precum Mastercard Digital Enablement Service (MDES), în schimbul numărului de cont principal (PAN) al plătitorului.
Dumneavoastră sau your payment service provider puteți solicita furnizorului de servicii de creare de simboluri de rețea să creeze simboluri pentru PAN-urile contului existent din fișier și să înlocuiască fiecare PAN cu un simbol de rețea unic.
Acest aspect depinde de participarea emitentului la serviciul de creare a simbolurilor în rețea și de intervalele de conturi de carduri activate. Puteți folosi aceste simboluri pentru comerțul electronic și tranzacții în aplicație, cum ar fi PAN-urile de cont.
Metode și operații acceptate
Aceste simboluri sunt acceptate în următorul scop.
| Metode de integrare | Metode de plată | Operațiuni |
|---|---|---|
În Hosted Checkout, nici plătitorul, nici comerciantul nu pot trimite direct un simbol de rețea. Cu toate acestea, comerciantul poate crea un simbol de gateway pentru un card obținut prin Hosted Checkout, ceea ce poate duce la generarea unui simbol de rețea de către gateway.
|
|
În cazul plăților cu simboluri de rețea:
|
Beneficiile creării simbolurilor de rețea
Crearea simbolurilor de rețea oferă următoarele beneficii.
- Oferă o securitate superioară a informațiilor de plată, folosind criptograme dinamice.
- Vă permite să mențineți informațiile cardurilor actualizate.
- Oferă rate de aprobare mai mari.
- Oferă o experiență îmbunătățită a utilizatorului.
Furnizori de servicii de creare de simboluri de rețea acceptați
În prezent, eGenius Platform acceptă numai procesarea simbolurilor din rețea obținute de la următorii furnizori de servicii de creare de simboluri în rețea:
- Mastercard Digital Enablement Service (MDES)
- Visa Token Service (VTS)
Comercianții din SUA nu pot procesa simboluri VTS pentru tranzacțiile cu card de debit sau preplătite, rutate către rețelele de debit naționale.
- American Express Token Service (AETS)
Sunt acceptate momentan doar plățile cu simboluri de rețea.
Pentru a vedea exemple de solicitări și răspunsuri API utilizate în crearea de simboluri de rețea, descărcați colecția Postman.
Integrarea creării de simboluri de rețea
Puteți folosi simboluri de rețea în eGenius Platform în următoarele moduri:
- Plăți cu simboluri de rețea: Vă integrați direct cu furnizorul de servicii de creare de simboluri de rețea, solicitați noi simboluri pentru plătitorii dvs. de la furnizor și trimiteți detaliile simbolului într-o solicitare de tranzacție către gateway.
- Crearea de simboluri de rețea pentru simbolurile de gateway: Gateway-ul se integrează cu furnizorul de servicii de creare de simboluri de rețea în numele dvs. Acesta solicită automat simboluri de rețea pentru a se potrivi cu toate simbolurile de gateway pe care le creați și folosește simbolul de rețea acolo unde este disponibil pentru a procesa tranzacția.
- Crearea de simboluri de rețea pentru Hosted Checkout: Crearea de simboluri de rețea reprezintă crearea de simboluri prin scheme de rețea de plată, servind ca înlocuitori securizați pentru informațiile sensibile de plată. Hosted Checkout, ca parte a setului său robust de caracteristici, extinde suportul pentru integrarea și utilizarea acestor simboluri de rețea, asigurând securitate îmbunătățită și procese de tranzacție fără întreruperi atât pentru utilizatori, cât și pentru comercianți.
Plăți cu simboluri de rețea
Atunci când vă integrați direct cu furnizorul de servicii de simboluri din rețea, trebuie să obțineți detaliile simbolului de la furnizor și să le transmiteți către gateway în oricare dintre următoarele solicitări de procesare a plăților:
Câmpurile solicitării tranzacției de plată cu simbol de rețea
În plus față de câmpurile standard, completați următoarele câmpuri în solicitarea de procesare a plăților utilizând simboluri din rețea emise de furnizorii de servicii de creare de simboluri în rețea.
| Nume câmp | Valori valide | Descriere |
|---|---|---|
| sourceOfFunds.type | SCHEME_TOKEN
Simbolurile schemei, cum ar fi MDES, VTS și AETS, sunt acceptate începând cu API v51, v53 și v57. |
Metoda de plată utilizată pentru această plată. Permite gateway-ului să identifice sursa fondurilor, introdusă în solicitare sub forma unui simbol de rețea. |
| sourceOfFunds.provided.card.number | Furnizați oricare dintre următoarele valori:
|
Simbol de rețea
Dacă furnizați un simbol de rețea în care acreditările, adică simbolul de rețea sau FPAN-ul corespunzător, au fost salvate în timpul unei plăți anterioare, setați sourceOfFunds.provided.card.storedOnFile = STORED în solicitare. În caz contrar, setați valoarea la TO_BE_STORED. Pentru mai multe informații, consultați Tranzacțiile cu acreditări salvate.
|
| sourceOfFunds.provided.card.expiry | - | Expirarea simbolurilor de rețea |
| sourceOfFunds.provided.card.devicePayment.onlinePaymentCryptogram | Furnizați criptograma MDES UCAF (de48se43Data) sau criptograma VTS TAVV. | Criptograma folosită pentru autentificarea tranzacției. Utilizați direct valoarea din acreditările decriptate ale tranzacției. |
| sourceOfFunds.provided.card.devicePayment.eciIndicator | - | Indicatorul de comerț electronic (ECI), emis de către serviciul de creare de simboluri. Acest câmp este obligatoriu pentru simbolurile din rețea obținute din VTS. |
| sourceOfFunds.provided.card.securityCode | Furnizați oricare dintre următoarele valori:
|
Codul de verificare a simbolului, dacă a fost emis de către serviciul de creare de simboluri. |
| transaction.source | Pentru o tranzacție inițiată de titularul cardului, setați acest câmp la oricare dintre următoarele valori:
|
Câmpurile răspunsului tranzacției de plată cu simbol de rețea
Când este furnizat un simbol de rețea, de exemplu, solicitarea AUTHORIZE/PAY, răspunsul RETRIEVE TRANSACTION returnează următoarele câmpuri:
| Nume câmp | Descriere |
|---|---|
| sourceOfFunds.type = SCHEME_TOKEN | Simbol de rețea utilizat în tranzacție. |
Dacă achizitorul returnează un FPAN, răspunsul RETRIEVE TRANSACTION returnează următoarele câmpuri:
| Nume câmp | Descriere |
|---|---|
| sourceOfFunds.provided.card.number | FPAN ascuns sau PAN de finanțare. |
| sourceOfFunds.provided.card.expiry | Expirarea FPAN. |
| sourceOfFunds.provided.card.deviceSpecificNumber | Simbolul de rețea de la MDES (PAN simbol), VTS (Simbol) sau AETS (Simbol). |
| sourceOfFunds.provided.card.deviceSpecificExpiry | Expirarea simbolurilor de rețea. |
Dacă achizitorul nu returnează un FPAN, răspunsul RETRIEVE TRANSACTION returnează următoarele câmpuri:
| Nume câmp | Descriere |
|---|---|
| sourceOfFunds.provided.card.number | Valoare complet ascunsă. |
| sourceOfFunds.provided.card.deviceSpecificNumber | Simbolul de rețea de la MDES (PAN simbol), VTS (Simbol) sau AETS (Simbol). |
| sourceOfFunds.provided.card.deviceSpecificExpiry | Expirarea simbolurilor de rețea. |
Crearea de simboluri de rețea pentru simbolurile de gateway
Gateway-ul oferă suportul necesar pentru a acționa pe post de solicitant de simbol în numele dvs. Dacă profilul dvs. de comerciant este activat pentru crearea de simboluri de gateway, your payment service provider poate activa și configura, de asemenea, crearea de simboluri de rețea în profilul dvs. de comerciant
Atunci când această opțiune este activată, orice solicitare pentru un simbol de pe gateway va încerca să genereze un simbol corespunzător în rețea pentru schemele activate, dacă acestea sunt acceptate de emitentul cardului.
Solicitarea de creare a simbolurilor pentru un simbol de gateway returnează un simbol de gateway, iar în fundal, furnizorul de servicii de creare de simboluri generează un simbol de rețea, în mod asincron, pentru numărul FPAN pe care îl trimiteți în timp ce creați un simbol de gateway.
Gateway-ul stochează intern FPAN-ul și simbolul de rețea, ambele fiind asociate cu simbolul de gateway pe care gateway-ul îl returnează comerciantului.
În acest model, comerciantul furnizează întotdeauna un simbol de gateway și, în funcție de situație, gateway-ul fie folosește simbolul de rețea, fie, dacă nu este disponibil, Funding PAN (FPAN) stocat pe acel simbol de gateway.
Gateway-ul încearcă, de asemenea, crearea de simboluri de rețea pentru orice card aplicabil deja stocat în depozitul de simboluri de gateway. Aceasta se referă la o situație în care,
- Your payment service provider activează simbolurile de gateway
- Simbolurile de gateway sunt generate pentru mai mulți plătitori
- Your payment service provider permite utilizarea simbolurilor de rețea pentru dvs
Gateway-ul generează apoi automat simboluri de rețea pentru toate simbolurile de gateway existente.
Când ștergeți un simbol de gateway, simbolul de rețea corespunzător este șters automat din gateway și de la furnizorul de servicii de simbol de rețea.
Simbolul furnizat în solicitare este marcat ca neutilizabil. Detaliile cardului memorate pe baza simbolului trebuie actualizate înainte de a putea fi utilizate, deoarece gateway-ul a fost notificat că detaliile cardului nu mai sunt valide.
Pentru a menține evidențele la zi, puteți prelua detaliile FPAN-ului ascuns pentru FPAN-ul actualizat din răspunsul la tranzacție anterior, în care simbolul din rețea a fost folosit la plată.
Câmpurile de răspuns Retrieve Transaction
Când este utilizat un simbol de rețea, de exemplu într-o solicitare AUTHORIZE sau PAY, răspunsul RETRIEVE TRANSACTION returnează următoarele câmpuri:
| Câmp | Descriere |
|---|---|
| sourceOfFunds.provided.card.number | FPAN ascuns, dacă a fost returnat de achizitor. |
| sourceOfFunds.provided.card.expiry | Expirarea FPAN |
| sourceOfFunds.provided.card.deviceSpecificNumber | Simbol de rețea de la MDES (PAN simbol) sau VTS (simbol) |
| sourceOfFunds.provided.card.deviceSpecificExpiry | Expirarea simbolurilor de rețea |
| sourceOfFunds.type = SCHEME_TOKEN | Dacă în tranzacție a fost folosit un simbol de rețea. |
| sourceOfFunds.provided.card.paymentAccountReference | Identificatorul unic care face legătura cu un FPAN pentru un card cu toate simbolurile din rețea emise pentru card. |
- Suportul pentru autentificarea 3D Secure este disponibil începând cu API v54.
- Informațiile specifice complete despre simbol, respectiv PAN simbol sourceOfFunds.provided.card.deviceSpecificNumber, expirare simbol sourceOfFunds.provided.card.deviceSpecificExpiry și sourceOfFunds.type sunt disponibile în răspunsul la tranzacție începând cu API v54.
- Informațiile specifice parțiale ale simbolului din răspunsul tranzacției sunt disponibile în versiunile mai vechi:
- PAN simbol, adică valoarea din câmpul sourceOfFunds.provided.card.deviceSpecificNumber începând cu API v39 și expirarea simbolului începând cu API v43.
- API v38 și versiunile mai vechi nu vor returna nicio informație specifică simbolului.
Crearea de simboluri de rețea nu este aplicabilă pentru plățile de pe dispozitive care folosesc DPAN sau FPAN.
Testați detaliile integrării simbolurilor de rețea
Pentru detalii generale despre testarea integrării dvs., consultați instrucțiunile de testare din fiecare metodă de integrare aplicabilă. Pentru a testa în mod specific crearea de simboluri de rețea, utilizați profilul de comerciant de testare și un simbol de rețea de testare.
| Furnizor simbol | Simbol | Expirarea simbolului | Criptogramă | Indicator ECI |
|---|---|---|---|---|
| MDES | 5204 **** 5000 1497 | 11/22 | <any> | - |
| VTS | 4111 **** 1111 **11 | 06/29 | <any> | 05 |
| AETS | 3456 **** **** 564 | 05/21 | <any> | - |
Crearea de simboluri de rețea pentru Hosted Checkout
Cerințe preliminare
- Asigurați-vă că profilul dvs. de comerciant este activat pentru plăți găzduite. Asigurați-vă că sunt activate atât Hosted Checkout, cât și Pay with Token și serviciul de creare de simboluri relevant. Dacă plățile găzduite și funcțiile sale nu sunt activate în prezent, contactați your payment service provider pentru asistență. Pentru a activa plățile găzduite și orice caracteristici asociate pentru profilul dvs. de comerciant, consultați portalul Merchant Manager și Ghidul utilizatorului Merchant Manager pentru instrucțiuni detaliate.
- Pentru a utiliza crearea de simboluri de rețea pentru simbolul Gateway, asigurați-vă că ambele sunt activate.
- Asigurați-vă că Secure Remote Commerce (Click to Pay) nu este activat.
- Vă rugăm să vă asigurați că urmați și utilizați integrarea acreditărilor salvate. Puteți găsi instrucțiuni detaliate pentru implementarea acestei integrări aici:
- În prezent,
interaction.operation=AUTHORIZEeste acceptat pentru această funcționalitate. În curând, va fi disponibil suportul suplimentar pentruinteraction.operation=PURCHASE. - Trebuie utilizat API-ul WS v74 sau o versiune ulterioară.
- În prezent,
Întrebări frecvente
Simbolurile de rețea sunt acceptate în solicitările de autentificare 3-D Secure?
Gateway-ul poate procesa simbolurile din rețea în solicitarea INITIATE AUTHENTICATION. Pentru mai multe informații, consultați Initiate Authentication.
Dacă ați autentificat plătitorul extern folosind un simbol de rețea, puteți transmite informații despre autentificare în obiectul de autentificare – de exemplu, operațiunea PAY sau AUTHORIZE. Pentru mai multe informații, consultați Cum trimit o solicitare de plată pre-autentificată?
Pot utiliza simboluri din rețea în tranzacțiile inițiate de comerciant?
Gateway-ul vă permite să utilizați simbolurile din rețea stocate pentru efectuarea tranzacțiilor inițiate de posesorul cardului și a celor inițiate de comerciant.
Pot vizualiza detaliile simbolului din rețea pentru o tranzacție în Merchant Administration?
Pentru o comandă sau o tranzacție în care a fost utilizat un simbol din rețea, câmpul Furnizor extern de simboluri este afișat pe pagina Detalii comenzi și tranzacții din portalul Merchant Administration. Acest câmp afișează fie Mastercard (MDES), fie Visa (VTS). Sistemul nu acceptă crearea de simboluri de gateway pentru simbolurile AETS.