Decizia nr. 340/2025

Anexa SPECIFICAȚII TEHNICE

privind redirectarea în Sistemul național electronic de plată -

SNEP pentru plată fără autentificare cu date precompletate

Introducere Utilizatorul din aplicația unui TERȚ va alege să plătească o taxă. Utilizatorul va fi redirectat în SNEP unde va efectua plata. Opțional se pot trimite prin POST și datele personale ale utilizatorului către SNEP, acestea fiind precompletate în formularul de plată.

1.

Definiția termenilor și abrevierilor SNEP - Sistemul național electronic de plată disponibil la adresa ghiseul.ro

ADR - Autoritatea pentru Digitalizarea României

TERȚ - terță parte (aplicația din afara SNEP care redirecționează către ghiseul.ro)

CNP - cod numeric personal

CUI - cod unic de identificare (persoană juridică sau persoană fizică autorizată)

HTTP - HyperText Transfer Protocol - protocol standard pentru transmiterea datelor pe web

GET - metodă HTTP de trimitere a datelor prin URL

POST - metodă HTTP de trimitere a datelor în corpul cererii

JSON - JavaScript Object Notation - format de schimb de date textuale structurate

HMAC - Hash-based Message Authentication Code – algoritm criptografic pentru verificarea integrității mesajelor

SHA256 - Secure Hash Algorithm 256-bit - algoritm de hashing criptografic

checksum - valoare de control utilizată pentru verificarea integrității datelor transmise

base64 - sistem de codificare a datelor binare în format text (caractere ASCII) pentru transmitere sigură

2.

Redirectare către plată fără autentificare în SNEP cu tip venit preselectat Din aplicația TERȚ se poate face redirectare în SNEP prin GET pentru plata pentru un anumit tip de venit, pentru o instituție.

Parametrii ce trebuie trimiși prin get vor fi:

–

idinst - id-ul instituției din SNEP;

–

tippers - tipul persoanei. Va avea valoarea 1 pentru persoana fizică și 2 pentru persoana juridică;

–

codvenit - codul tipului de venit intern de la instituție.

3.

Trimiterea datelor personale și a sumei de plată către SNEP Din aplicația TERȚ se pot trimite și datele personale către SNEP pentru a putea fi precompletate în formularul de plată. Metoda HTTPS POST*) va fi folosită pentru a trimite parametrii JSON către SNEP. Ultimul parametru din cerere va fi un checksum pentru verificarea integrității mesajului. Parametrul check se va calcula utilizând HMAC SHA256 folosind cheia instituției (primită de la ADR/SNEP). *) Schema aferentă este reprodusă în facsimil.

Datele trimise prin POST vor fi parametrii params și check.

În cazul în care parametrii nu sunt validați, utilizatorului i se va afișa formularul de plată fără datele precompletate.

Request • Parametrul params va conține următoarele date în format JSON, encodate apoi base64:

• cui - CNP/CUI-ul persoanei pentru care se face plata (CUI pentru persoana fizică autorizată sau persoana juridică), obligatoriu; numeric (13)

• cuiplatitor - CNP/CUI-ul persoanei care face plata, obligatoriu, numeric (13)

• nume - numele și prenumele persoanei (denumirea pentru persoane juridice) pentru care se face plata, string (50)

• adresa - adresa poștală a persoanei pentru care se face plata (obligatoriu), string (100)

• email - e-mailul persoanei unde se va trimite dovada de plată (obligatoriu), string (50)

• suma - suma care se plătește, formatat cu 2 zecimale cu punct (exemplu: 45.00)

• check - parametrul pentru validarea integrității mesajului. Se va folosi cheia generată și primită de la SNEP pentru instituția pentru care se face requestul.

-----