Asiguratorul de riscuri NuDetect

Efectuați o operațiune Create Session pentru a obține un ID de sesiune. După ce creați o sesiune, o puteți actualiza apoi cu câmpurile de solicitare și valorile pe care doriți să le stocați în cadrul sesiunii.

Referință API Create Session[REST][NVP]

Pe pagină de plată, realizați referința API-ului JS de risc (risk.js) de pe serverele gateway-ului. Această acțiune va plasa obiectul risk în fereastră/spațiul de nume global.

https://egenius.unicredit.ro/static/risk-core/1.0.0/risk.min.js

Referința rik.js[JavaScript]

Inserarea elementului de intrare ascuns din formular

Rețineți că, după finalizarea configurării prin metoda Risk.configure( ), SDK-ul JS de risc creează următorul element de intrare ascuns în elementul <form> de pe pagina de plată, care încorporează de obicei detaliile cardului. SDK-ul JS de risc generează datele de amprentă în elementul de intrare ascuns atunci când plătitorul începe să interacționeze cu pagina de plată, de exemplu, când apasă pe taste, mișcă sau face clic cu mouse-ul etc.

<input name="nds-pmd" type="hidden">

Dacă pagina de plată nu are un element <form>, trebuie să introduceți manual elementul de intrare ascuns, de exemplu, prin metoda <input name="nds-pmd" type="hidden"> înainte de executare Risk.configure( ).

Solicitarea de inițializare JS de risc

Odată ce ați creat o sesiune, inițializați API-ul prin metoda Risk.configure( ). Această metodă trebuie apelată în timpul încărcării paginii sau când DOM se află în starea pregătită. Aceasta trebuie apelată o singură dată pentru o încărcare de pagină. După apelarea acestei metode, JS de risc va furniza valorile de configurare sub formă de variabile-membru.

Completați următoarele câmpuri obligatorii ca argumente pentru obiectul riskConfig:

• merchantId: Identificatorul dvs. de comerciant pe gateway.
• sessionId: ID-ul de sesiune creat prin apelul Create Session.
• apiVersion: (Opțional) Versiunea API a solicitării. Dacă nu furnizați o valoare, apiVersion va avea valoarea implicită 56.
• riskProvider: (Opțional) Identificatorul asiguratorului de risc pe gateway. În prezent, doar asiguratorul de risc NUDETECT este acceptat prin API-ul JS de risc. Dacă nu furnizați un asigurator de risc, API-ul JS de risc va trimite o solicitare Payment Options Inquiry pentru a identifica asiguratorul de riscuri acceptat.

Funcția callback

Puteți furniza o funcție callback opțională în metoda Risk.configure(), care va fi invocată împreună cu obiectul response ca argument după finalizarea metodei. Obiectul response va conține proprietățile message și status pentru a indica succesul configurării sau eșecul acesteia din cauza unei erori.

În cazul configurării cu succes:

{ status: "SUCCESS", message: "Risk SDK is configured successfully."}

În cazul configurării nereușite:

{ status: "ERROR", message: "Error message"}

Risk.configure({
        merchantId: "TESTMERCHANT",
        sessionId: "SESSION0002899787259G30902270H6",
        apiVersion: 56,
        riskProvider: "NUDETECT"
    },
    function(response) {
        // Handle Risk.configure() response */

        console.log(response.message)
        // Configuration message: 'Risk SDK is configured successfully.'

        console.log(response.status)
        // Configuration status: 'SUCCESS' or 'ERROR'
    }
);

Puteți adăuga sau actualiza câmpurile din sesiunea creată la Pasul 1 folosind apelul Update Session. Acesta permite adăugarea datelor plăților și plătitorilor într-o sesiune care poate deveni ulterior o intrare pentru o operațiune Verify, Authorize sau Pay, pentru determinarea riscului asociat cu plătitorul. Executați operațiunea Update Session atunci când plătitorul face clic pe butonul „Plătiți acum”.

Câmpuri obligatorii

• device.fingerprint: Furnizați valoarea elementului de intrare ascuns, conform descrierii de la pasul 2. Elementul de intrare ascuns conține datele de amprentă ale plătitorului, capturate de SDK-ul JS de risc.
• sourceOfFunds.provided.card.*: Detaliile cardului utilizat pentru plată.
• order.amount
• order.currency: Moneda comenzii.
• transaction.id: Un identificator unic pentru autentificarea plății.
• order.id: Identificatorul unic al comenzii.

Rețineți că nu puteți să ștergeți câmpuri dintr-o sesiune, dar puteți suprascrie valorile câmpurilor existente.

Referință API Update Session[REST][NVP]

Dacă operațiunea Update Session a fost finalizată cu succes, sesiunea returnată va conține detaliile de plată ale plătitorului din interacțiune. Utilizați sesiunea returnată pentru a prezenta o pagină de confirmare a comenzii sau a trimite o plată către gateway. Consultați Efectuarea unei operațiuni cu ajutorul sesiunii