API Plat Ion Line Ver 3.01

Confidential – Plationline.ro versiunea 3.0. Acest document nu poate fi distribuit fara acordul scris al C Solution S.R.L.

PlatiOnline.ro

Specificatiile interfetei de procesare tranzactii electronice

Versiunea 3.0

Toate drepturile rezervate C Solution SRL


1. Despre acest document

1.1 Informatii despre document

Titlul documentului Specificatiile interfetei PlatiOnline.ro a versiunii 3.0 pentru

managementul tranzactiilor electronice

Tipul documentului Specificatii tehnice

Numarul documentului 3.0

Autorii documentului Diana Neagu, Bogdan Honciuc,

Catalin Maftei, Dan Rimniceanu

Nivelul de

confidentialitate Confidential

Cuvinte cheie Plationline.ro, PO3D, MTE, card bancar, 3D Secure

Data documentului 22.Mai.2008


Cuprins

1. Introducere

2. Glosar (termeni utilizati in industria e-commerce)

3. Modelul comerciantilor PlatiOnline.ro

4. Cum se fac cererile de tranzactionare catre serverul PlatiOnline

5. Cheile de securitate

a. Cum se obtin

i. Conectarea la portal

ii. Sectiunea « Setari », optiunea « Raspunsul secret »

iii. Sectiunea « Setari », optiunea « Chei de securitate »

b. Cum se utilizeaza

6. Operatiile e-commerce

a. Autorizarea

i. Pagina de informatii despre client, comanda si livrare

ii. Trimiterea datelor despre client, comanda si livrare direct serverului

PO

iii. Setarea modului de primire a raspunsului tranzactiilor de autorizare

iv. Raspunsul la operatia de autorizare

v. Utilizarea elementelor grafice in pagina de raspuns

b. Incasarea

i. Trimiterea datelor pentru incasare direct la serverul PO

ii. Raspunsul la operatia de incasare

c. Anularea

i. Trimiterea datelor pentru anulare direct la serverul PO

ii. Raspunsul la operatia de anulare

d. Creditarea

i. Trimiterea datelor pentru creditare direct la serverul PO

ii. Raspunsul la operatia de creditare

e. Interogare

i. Trimiterea datelor pentru interogare direct la serverul PO


ii. Raspunsul la operatia de interogare

7. Testarea contului de comerciant

8. Analiza PO si activarea contului

Anexe

A – Cum se formeaza campul F_Message

B – Cum se formeaza strctura XML pentru campul F_Order_String

C – Lista codurilor tarilor

D – Lista codurilor statelor corespondente tarilor

E – Gestionarea erorilor

F – Operatiile e-commerce, valorile campului F_Action


Introducere

PlatiOnline.ro este un sistem de gestiune a tranzactiilor electronice efectuate

prin carduri bancare emise sub sigla Visa si Mastercard. Oferim

comerciantilor o solutie de tranzactionare rapida, solida si sigura prin utilizarea

certificatelor de securitate SSL (Secure Socket Layer).

Sistemul PO permite gestionarea tranzactiilor prin operatii financiare specifice

cardurilor bancare si efectuarea de operatii de gestiune a comenzilor specifice

magazinelor online.

Plationline.ro foloseste standardele 3D : Verified By Visa si MasterCard

SecureCode ce impiedica si limiteaza tranzactiile neautorizate prin Internet.

Aceste standarde reprezinta rezultatul eforturilor organizatiilor internationale

Visa/Mastercard de a minimaliza frauda online, protejand atat detinatorii de card cat

si comerciantii care accepta la plata online cardurile bancare.

Acest document ghideaza comerciantii noi in procesul de implementare a

modulelor sistemul PO. Documentul ofera instructiuni de implementare pas cu pas

asociate cu exemple de cod. Anexele documentului contin informatii utile cum ar fi

tabele cu definitii ale termenilor utilizati des in industria cardurilor, codurile de

eroare, codurile de judet si tara, alte informatii.


Glosar

(termeni utilizati in industria cardurilor bancare)

Adresa: informatiile legate de adresa de corespondenta si/sau cea de livrare, (strada si numarul) furnizate odata cu initierea unei tranzactii. Adresa e-mail: adresa de corespondenta prezenta sau furnizata de client intr-o tranzactie poate contine acest tip de informatie. Formatul acesteia trebuie sa contina simbolul “@” Cod de autorizare: codul returnat in urma procesului de tranzactionare pentru fiecare tranzactie autorizata. Codul CVV2/CVC2 (cod de securitate): consta in ultimele 3 sau 4 cifre plasate pe versoul cardului. Reprezinta o masura suplimentara de siguranta pentru a impiedica tranzactiile frauduloase. Cod de identificare al unei tranzactii (ID): fiecarei tranzactii intr-un sistem i se asociaza un cod unic de identificare pentru o gestiune eficienta si rapida. Cod postal: aceasta informatie compusa din 5 cifre (uneori in combinatie cu litere) poate fi prezenta in adresa de livrare pentru o mai buna localizare a zonei de livrare. Companie: numele companiei asociate sau prezente in adresa de corespondenta sau livrare, furnizata in momentul initierii unei tranzactii. Data expirarii: informatie prezenta pe card, ea determina perioada de valabilitate pentru acel card. Odata expirat, un card nu mai este considerat valid, iar tranzactiile initiate cu el vor fi refuzate. Data si ora incasarii: sunt coordonatele temporale pentru identificarea exacta a momentului in care o tranzactie a fost incasata. Descrierea produsului: reprezinta informatii legate de tipul sau natura produsului/serviciului achizitionat sau ce se doreste a fi achizitionat de catre un client sub forma unei tranzactii. Incasata: starea unei tranzactii ce indica faptul ca din contul unui client s-a debitat suma de plata aferenta produsului/serviciului achizitionat. Moneda: tipul de moneda specific asociat cu suma unei tranzactii. (eg, RON, USD, EUR)


Nume: parte integranta si esentiala din adresa de corespondenta sau livrare furnizata in procesul de tranzactionare ce identifica clientul-initiator de tranzactie. Numar card: numarul cardului prezent pe fata cardului este folosit pentru derularea tranzactiilor. Din motive de securitate, in documente specifice (eg. extrase de cont, chitante etc) numarul cardului poate fi afisat intr-un format ascuns (eg. XXXXXX561). Nume client: numele clientului asa cum este prezent in adresa de corespondenta sau livrare, furnizata in momentul initierii unei tranzactii. Numar de factura: informatie suplimentara ce identifica o tranzactie intr-un sistem si poate avea un format alfanumeric. Numar de telefon: aceasta informatie poate fi prezenta in adresa de corespondenta intr-o tranzactie, din dorinta unei mai bune comunicari intre client si celelalte parti angajate in procesul de tranzactionare. Oras: orasul ca parte din adresa de corespondenta sau livrare, furnizata in momentul initierii unei tranzactii. Refuzate: tranzactiile refuzate de banca emitenta sau datorita unei erori de procesare vor avea aceasta stare. Uneori este asociata cu o mica sintagma-explicatie ce poate ajuta la identificarea motivului pentru care o tranzactie este refuzata. Starea unei tranzactii: pentru fiecare tranzactie intr-un sistem exista o stare unica, asociata cu stadiul de procesare pe care o tranzactie il poate avea. De exemplu, tranzactiile acceptate vor avea starea “Autorizata”, cele refuzate “Refuzata”, iar cele pentru care sumele de bani au fost incasate – “Incasata”. Suma de plata: reprezinta suma intr-o moneda (RON, USD, EUR) dintr-o tranzactie inaintata spre autorizare. Tara: tara asociata sau prezenta in adresa de corespondenta sau livrare, furnizata in momentul initierii unei tranzactii. Tip de card: indica tipul de card folosit in cadrul unei tranzactii (V- Visa, M- Mastercard, D – Discover).


Modelul comerciantilor PlatiOnline.ro

Comerciantii PlatiOnline.ro primesc cate un cont pentru fiecare site e-commerce

inregistrat in sistem. Aceste conturi au cate un identificator unic « ID Comerciant »,

doua chei de securitate si un cont de utilizator.

Aceste chei de identificare leaga tranzactiile de contul comerciantului.

ID Comerciant

Cheia 1 Securitate

Cheia 2 Comerciant PlatiOnline.ro

cont e-commerce Contul de utilizator

(https://comercianti.plationline.ro)

Aceste informatii le primiti automat pe adresa de e-mail specificata in

formularele de contact indata ce inrolare site-ului a fost facuta cu succes. Recomandam

ca indata ce primiti informatiile pe e-mail sa va conectati la interfata comerciantilor si

sa schimbati parola.


Cum se fac cererile de tranzactionare

(operatiile e-commerce)

Toate cererile de tranzactionare sunt trimise sistemului PlatiOnline.ro de procesare-

tranzactionare in formatul « URL-encoded ».

Cererile sunt construite in felul urmator:

1. Fiecare camp utilizat de plationline are un nume de forma f_nume_camp. De

exemplu <input type=text name=f_accountid value=0123456789>

<input type=text name=f_message value=9999996789>

Restul campurilor pe care le trimiteti doar tranziteaza sistemul si ajung inapoi la

pagina de raspuns.

2. La valoarea campului toate textele se incapsuleaza intre ghilimele sau apostrof.

De exemplu un camp ce contine mesajul de final tranzactie va fi definit:

<input type=text name=frm_mesaj value=’Va multumim pentru achizitie’>

3. Numele campurilor este “case insesitive”.

In formular stabiliti metoda GET sau POST utilizata la trimiterea datelor iar la

parametrul action puneti adresa URL pe care o primiti in momentul in care va inrolati.

De exemplu:

<form name=frm_po method=post action=https://secure2.plationline.ro/trans30.asp>


Cheile de securitate

Cum se obtin cheile de securitate

Pentru a va conecta la portal deschideti Internet Explorer si in Address bar

tastati : https://comercianti.plationline.ro. Tastati datele de access si apasati butonul

Login.

Fig. 1

Dupa conectare veti avea acces la toate serviciile oferite comerciantilor de sistemul

PlatiOnline.


Sectiunea « Setari », optiunea « Raspunsul secret »

Fig. 2

Sectiunea permite introducerea si schimbarea intrebarii si raspunsului secret. Daca

aceste date se introduc pentru prima oara, se lasa gol campul “Raspuns vechi”.

Se alege intrebarea secreta si se furnizeaza raspunsul in campul “Raspuns nou”.

ATENTIE: Comerciantul trebuie sa memoreze corect noul raspuns.

Sectiunea « Setari », optiunea « Chei de securitate »

In cadrul sectiunii « Setari » se selecteaza optiunea « Cheile de securitate ». Se

introduce raspunsul secret la intrebarea selectata si apoi sunt afisatate cheile de

securitate. Se vor folosi ambele chei in criptarea datelor (vezi fisierul rsalib.asp/.php,

de asemenea disponibil pentru descarcare).

Algoritmii de criptare utilizati de sistemul PO sunt RSA si HMAC_SHA1.

Cheile de securitate sunt folosite la criptarea datelor sensibile ale tranzactiei.


Comunicarea cu serverul plationline este securizata folosind certificatul SSL ceea

ce asigura faptul ca datele transmise intre client si server nu sunt citite si alterate de

terte persoane. Aceste chei intaresc securitatea sistemului si garanteaza ca cererile de

tranzactionare vin de la comerciantul respectiv si ca raspunsul este de la serverul

plationline.

Aplicarea algoritmilor de securitate este simpla si nu presupune multe operatii.

Cum se utilizeaza cheile de securitate

Comerciantii cu sisteme dezvoltate in PHP

Copiati fisierele clspo.php si rsalib.php in folderul PlatiOnlineRo din radacina site-

ului in care instalati modulul. Editati in fisierul rsalib.php cheile de securitate cu cele

preluate din interfata.

Fisierul clspo.php contine clasa PO. Clasa contine metoda InsertHash care are

ca parametri accountID, KeyENC, KeyMOD, Amount, Currency,

Numar_Comenda, Tip_Actiune. ATENTIE valorile parametrilor trebuie sa fie

IDENTICE cu cele din campurile asociate care se trimit in clar.

Metoda InsertHash introduce automat in formularul HTML 2 obiecte

“Type=HIDDEN” care contin mesajul in clar si codul incriptat cu cheile de securitate.

<input type=hidden name=”F_MESSAGE” value=”…”>

<input type=hidden name=”F_CRYPT_MESSAGE” value=”…”>

Aceste obiecte HTML identifica in mod unic tipul tranzactiei, suma, moneda si

comerciantul in numele caruia se face tranzactia. Daca valoarea lor este modificata in

codul HTML server-ul PlatiOnline nu va mai recunoaste tranzactia si tentativa de frauda

va fi oprita.


6. Operatiile e-commerce

Autorizarea

Exista un anumit risc specific acceptarii platii prin card atunci cand cardul nu

este prezent. In autorizarea unui card, informatia tranzactiei este trimisa procesorului

de card, care la randul lui trimite informatia catre institutia financiara emitenta a

detinatorului cardului.

Autorizarea nu este o garantie a platii.

Aceasta operatie doar confirma existenta cardului si faptul ca acel capital

(F_Amount) este disponibil la momentul respectiv pentru a acoperi suma tranzactiei.

Fondurile nu sunt creditate in acest moment in contul comerciantului dar autorizarea

reduce limita creditului disponibil pentru acel card, astfel incat fondurile sunt

"rezervate" pentru tranzactie.

Fiecare solicitare de autorizatie de card are o limita de timp impusa de furnizorul

cardului.

De obicei, limita este intre 3 si 21 de zile, dar ar trebui verificata politica

furnizorului de card. Daca o autorizare de card expira inainte de cererea de incasare,

operatia de incasare ar putea fi respinsa daca este atinsa limita creditului detinatorului

de card, sau comerciantul ar putea fi taxat mai mult pentru tranzactie, asa cum a fost

hotarat prin regulile companiei de card.

Visa ar putea de altfel sa va taxeze cu un comision mai mare daca o cerere de

tranzactie este primita mai tarziu de 7 zile de la cererea de autorizatie.

In cele mai multe cazuri, este precaut sa presupunem ca autorizatia va ramane

valida pentru o perioada de 7 zile.

Multi comercianti incearca sa limiteze timpul dintre autorizatie si tranzactie la 7

zile, pentru a minimiza problemele tranzactiei.

Chiar daca este o politica buna, aceasta nu e o regula definitiva. Politicile si intretinerile

variaza intre carduri si institutiile financiare, iar aceasta informatie nu este inclusa in

raspunsul autorizatiei. Depinde de dvs sa fiti atenti la posibilele consecinte si sa decideti

modalitatea de rezolvare a acestora.


Pagina de informatii despre client, comanda si livrare

Comerciantii pot alege ca pagina in care se introduc datele despre client,

comanda si livrare sa fie pe serverul PlatiOnline sau sa fie pe propriul server.

Daca selectati sa utilizati pagina de pe serverul PlatiOnline atunci configurati sectiunea

« Produse e-commerce » si « Setari » din interfata de comercianti. (vezi PO_v3.pdf)

Daca selectati sa tineti pagina pe propriul site atunci configurati sectiunea

« Setari » din interfata de comercianti. (vezi PO_v3.pdf)


Trimiterea datelor despre client, comanda si livrare direct serverului PO

Formularul HTML poate contine urmatorii parametri:

Parametru Autorizare

Optional/ Obligatoriu

Tipul de data Descriere

F_Show_Form Optional Int Valoare=1 Afiseaza pagina de colectare a informatiei: adresa de corespondenta/ adresa de livrare

F_Login Obligatoriu Varchar(50)

ID-ul Comerciantului in numele caruia se face cererea de autorizare. Este oferit de PO dupa parcurgerea procesului de inrolare.

F_Action Obligatoriu Int Identifica tipul operatiei. Vezi Anexa F.

F_Message Obligatoriu Varchar(1500)

Secventa de valori concatenate cu caracterul ^ (accent circumflex): - numar random 3 cifre; - Login_ID (=F_login); - Stamp (=Data si ora server web); - Amount (=F_Amount); - Currency (=F_Currency); - Order Number (=F_Order_Number); - Action (=F_Action). ATENTIE: Valorile concatenate trebuie sa fie identice cu valorile din

campuri corespondente. Vezi Anexa A.

F_Crypt_Message Obligatoriu Varchar(1500) Rezultatul criptarii campului F_Message.

F_Lang Obligatoriu Varchar(2) Valori accepate “ro” sau “en”. Sistemul PO este multilingv, iar acest parametru stabileste limba utilizata.

F_Language Optional Varchar(2) Nu se mai utilizeaza de la versiunea 3.0

F_Amount Obligatoriu Numeric Suma autorizata. 8 cifre cu punct ca delimitator si 2 zecimale dupa delimitator

F_Currency Obligatoriu Char(3) Moneda in care se face tranzactia: valori acceptate: RON sau USD sau EUR

F_Order_Number Obligatoriu numeric

Numarul comenzii din sistemul comerciantului. Actest parametru face legatura dintre comanda din sistemul comerciantului si sistemul PO.

F_Order_String Obligatoriu XML Vezi Anexa B.

F_First_Name Obligatoriu Varchar(50) Prenumele clientului

F_Last_Name Obligatoriu Varchar(50) Numele clientului

F_Middle_Name Optional Varchar(50) Al doilea nume al clientului

F_Country Obligatoriu Char(2) Tara de resedinta a clientului Vezi Anexa C.


F_Address Obligatoriu Varchar(50) Strada si numarul adresei clientului

F_City Obligatoriu Varchar(50) Orasul clientului

F_Zip Obligatoriu Varchar(50) Codul postal al adresei clientului

F_State Obligatoriu Varchar(50) Judetul/Statul/Provincia clientului Vezi Anexa D.

F_Phone Obligatoriu Varchar(20) Numarul de telefon al clientului

F_Email Obligatoriu Varchar(50) Adresa de e-mail a clientului

F_Company Optional Varchar(50)

Compania client care achizitioneaza bunurile/produsele. Cardul utilizat este emis pe persoana juridica.

F_CUI Optional Varchar(50) Codul unic de inregistrare al companiei client.

F_Reg_Com Optional Varchar(50) Nr. de inregistrare la Registrul Comertului al companiei client.

F_Bank

Optional Varchar(50) Banca clientului.

F_Bank_Account

Optional Varchar(50) Contul clientului

F_CNP Optional Varchar(50) Codul numetic personal al clientului.

F_Ship_To_Company Optional Varchar(50) Compania la care se face livrarea.

F_Ship_To_First_Name Optional Varchar(50) Prenumele persoanei la care se face livrarea.

F_Ship_To_Last_Name Optional Varchar(50) Numele persoanei la care se face livrarea.

F_Ship_To_Address Optional Varchar(50) Strada si numarul la care se face livrarea.

F_Ship_To_State Optional Varchar(50) Judetul/Statul/Provincia la care se face livrarea. Vezi Anexa D.

F_Ship_To_Zipcode Optional Varchar(50) Codul postal al adresei la care se face livrarea.

F_Ship_To_Country Optional Varchar(50) Tara in care se face livrarea. Vezi Anexa C.

F_Ship_To_Phone Optional Varchar(50) Numarul de telefon al destinatarului.

F_Test_Request Optional int Valoare = 1 tranzactia este de test si nu poate va fi incasata.

Orice alt parametru Optional * Orice alt parametru pe care doriti sa il includeti in tranzactie. Acesti parametri se vor intoarce in mesajul raspuns.

Setarea modului de primire a raspunsului tranzactiilor

Ofera posibilitatea comerciantului sa specifice un URL sau o adresa web catre care sistemul PlatiOnline va trimite raspunsul tranzactiei de autorizare. In interfata https://comercianti.plationline.ro parcurgeti urmatorii pasi:


1. Selectati link-ul “Setari”. 2. Selectati link-ul “Raspunsul tranzactiei” 3. Faceti click in interiorul casutei URL-ului 4. Introduceti URL-ul sau adresa de web pentru raspuns. 5. Apasati butonul “Salveaza modificarile”

Fig. 3

Raspunsul la tranzactia de autorizare

Dupa ce banca emitenta aproba sau refuza autorizarea tranzactiei PlatiOnline va trimite raspunsul in urmatorul format:

Parametru Authorizare Tipul de data

Descriere

X_RESPONSE_CODE Int

Valoare=2 – tranzactia a fost autorizata Valoare=8 – tranzactia a fost refuzata Valoare=10 – eroare in procesul de autorizare Valoare=13 – tranzactia a fost autorizata insa necesita verificari suplimentare (asteptati maxim 24 de ore lucratoare pentru raspunsul final; recomandam sa nu faceti expedierea bunului/prestarea serviciului pana cand verificarile de frauda nu se finalizeaza).

X_RESPONSE_REASON_CODE Varchar(50) Valoarea reprezinta codul mesajului primit. Vezi Anexa E.

X_RESPONSE_REASON_TEXT Varchar(500) Mesajul explica valoarea parametrului X_RESPONSE_CODE.

X_TRAN_ID Numeric

Reprezinta ID – ul tranzactiei in sistemul plationline. Acest ID identifica in mod unic tranzactia in cadrul sistemului plationline, si este utilizat de fiecare data cand se modifica starile tranzactiei prin operatii specifice.

X_AUTH_CODE Varchar(20) Codul de autorizare primit de la banca emiteta a cardului.


X_ACTION_CODE Char(2) Codul actiunii reprezinta o recomandare a actiunii ce trebuie intreprinsa.

F_MESSAGE_RELAY Varchar(500)

Secventa de valori concatenate cu caracterul ^ (accent circumflex): - numar random 3 cifre; - Login_ID (=F_login); - Stamp (=Data si ora server web); - Amount (=F_Amount); - Currency (=F_Currency); - RESPONSE CODE (=X_RESPONSE_CODE); - Order Number (=F_Order_Number); - ID Tranzactie (=X_TRAN_ID); - Codul de autorizare (=X_AUTH_CODE) - Action (=F_Action). ATENTIE: Valorile concatenate trebuie sa fie

identice cu valorile din campuri corespondente. Vezi Anexa A.

F_Crypt_Message_Relay Varchar(500) Rezultatul criptarii campului F_Message_Relay.

Orice alt parametru * Orice alt parametru trimis in mesajul de autorizare. Acesti parametri se intorc in mesajul raspuns.

Utilizarea elementelor grafice in pagina de raspuns

Atunci cand selectati ca mesajul de raspuns sa fie trimis prin metoda POST

serverul PO va face POST la URL-ul specificat, va prelua raspunsul HTML de la serverul

comerciantului si il va trimite catre browserul clientului. In acest mod daca in HTML

sunt elemente grafice cu URL relativ ele nu vor functiona, si de aceea trebuie sa folositi

adrese absolute.

Mai mult, daca adresa absoluta este de forma http:// si nu https://, in functie de

browserul utilizat de client, o alerta este posibil sa ii apara pe ecran daca vrea sa

incarce si elementele nesecurziate din pagina.


Incasarea

Dupa ce comanda autorizata a fost livrata sau serviciul prestat, tranzactia poate

fi trimisa spre incasare, operatie suportata de serviciul plationline.ro. Incasarea incheie

ciclul financiar, suma autorizata este transferata de banca emitenta a cardului din

contul clientului in contul comerciantlui si face update la extrasul de card al clientului.

Sistemul e-commerce presupune incasarea sumelor dupa expedierea produselor

sau prestarea serviciilor. Din acest motiv tranzactiile se executa in doi pasi Autorizarea

si apoi Incasarea. Aceste operatii specifice comertului online sunt separate deoarece

dureaza pregatirea, impachetarea si etichetarea comenzilor pana la expediere.

Incasarea tranzactiilor se face doar pentru tranzactiile autorizate. Suma este

exact cea de la tranzactia autorizata original. Asupra unei tranzactii autorizate sa poate

face o singura data operatia de Incasare.

Spre deosebire de autorizare, operatia de incasare nu se executa imediat. Zilnic

in anumite momente tranzactiile trimise spre incasare se grupeaza si sunt trimise mai

departe bancilor emitente.

Trimiterea datelor pentru incasare direct la serverul


Parametru Incasare



F_Login Obligatoriu Varchar(50) ID-ul Comerciantului in numele caruia se face cererea de autorizare. Este oferit de PO dupa parcurgerea procesului de inrolare.


Secventa de valori concatenate cu caracterul ^ (accent circumflex): - numar random 3 cifre; - Login_ID (=F_login); - Stamp (=Data si ora server web); - PO Transaction ID (=X_Trans_ID); - Order Number (=F_Order_Number); - AWB (=F_AWB); - Transpotator (=F_Shipping_Company) - Action (=F_Action). ATENTIE: Valorile concatenate

trebuie sa fie identice cu valorile din campuri corespondente.

Vezi Anexa A.



X_Trans_ID Obligatoriu Char(3)

PO Transaction ID. Este parametrul intors de sistemul PO atunci cand se executa operatia de autorizare. Fiecare tranzactie din sistemul PO este identificata in mod unic prin acest identificator.

F_Order_Number Obligatoriu Numeric

Numarul comenzii din sistemul comerciantului. Acest parametru face legatura dintre comanda din sistemul comerciantului si sistemul PO.

F_Shipping_Company Obligatoriu Varchar(50)

Numele companiei care face livrarea comenzii. ATENTIE : Daca comanda nu

presupune livrare puneti caracterul

minus -. Vezi Anexa G.

F_AWB Obligatoriu Varchar(25)

Numarul documentului de transport de la compania care face livrarea. ATENTIE : Daca comanda nu

presupune livrare puneti caraterul minus -.

F_XML Optional Int 0 – raspunsul este in format URL Encoded; 1 – raspunsul este in format XML.

F_Action Obligatoriu Int Codul actiunii. Pentru Incasare valoare=3

Raspunsul la operatia de incasare

Dupa ce sistemul proceseaza cererea de incasare a tranzactiei PlatiOnline va trimite raspunsul in urmatorul format:

Parametru

Incasare

Tipul de

data Descriere

X_RESPONSE_CODE Int

Valoare=3 – cererea a fost inregistrata cu success Valoare=10 – o eroare a intervenit si tranzactia nu a putut fi trimisa spre incasare Valoare=13 – tranzactia este autorizata insa necesita verificari suplimentare (asteptati maxim 24 de ore lucratoare pentru raspunsul final; recomandam sa nu faceti expedierea bunului/prestarea serviciului pana cand verificarile de frauda nu se finalizeaza).



X_TRANS_ID Numeric




Cand operatia are success, un e-mail cu confirmarea expedierii produselor va fi

trimis catre adresa de e-mail a clientului (inregistrata in sistem la operatia de

autorizare) astfel incat clientul sa poata urmari online parcursul coletului.

Atentie: Nu se trimite e-mail daca campurile F_Shipping_Company si F_AWB au la valoare semnul minus -.

Anularea

Cand o comanda autorizata nu poate fi livrata sau serviciul nu poate fi prestat,

autorizarea trebuie anulata. Operatia de anulare este suportata de serviciul

plationline.ro. Anularea presupune ca banca emitenta a cardului sa deblocheze suma

autorizata in contul clientului, astfel incat acesta sa ii poata utiliza din nou asa cum

doreste.

Anularea tranzactiilor se face doar pentru tranzactiile autorizate. Suma este

exact cea de la tranzactia autorizata original. Asupra unei tranzactii autorizate sa poate

face o singura data operatia de anulare.

Spre deosebire de autorizare, operatia de anulare nu se executa imediat. Zilnic

in anumite momente tranzactiile trimise spre anulare se grupeaza si sunt trimise mai


Trimiterea datelor pentru anulare direct la serverul PO


Parametru

Anulare

Optional/

Obligatoriu Tipul de data Descriere



Secventa de valori concatenate cu caracterul ^ (accent circumflex): - numar random 3 cifre; - Login_ID (=F_login); - Stamp (=Data si ora server web);


- PO Transaction ID (=X_Trans_ID); - Order Number (=F_Order_Number); - Action (=F_Action). ATENTIE: Valorile concatenate

trebuie sa fie identice cu valorile din






Numarul comenzii din sistemul comerciantului. Acest parametru face legatura dintre comanda din sistemul comerciantului si sistemul PO.

F_Action Obligatoriu Int Codul actiunii. Pentru Anulare valoare=7


Raspunsul la operatia de anulare

Dupa ce sistemul proceseaza cererea de anulare a tranzactiei, PlatiOnline va trimite raspunsul in urmatorul format:

Parametru Anulare

Tipul de data

Descriere

X_RESPONSE_CODE Int

Valoare= 7 – cererea a fost inregistrata cu success Valoare= 10 – o eroare a intervenit si tranzactia nu a putut fi trimisa spre anulare. Valoare= 13 – cererea a fost respinsa deoarece starea tranzactiei nu permite anularea.



X_TRAN_ID Numeric



Cand operatia are success, un e-mail cu confirmarea anularii tranzactiei va fi



autorizare) astfel incat clientul sa stie ca suma se va debloca pe card in cel mai scurt

timp.

Creditarea

Atunci cand este necesara inapoierea sumei incasate de pe cardul clientului,

ultilizati operatia de creditare. Operatia de creditare este suportata de serviciul

plationline.ro.

Creditarea presupune ca banca acceptatoare sa vireze inapoi in contul asociat

cardului clientului din banca emitenta o suma mai mica sau egala cu cea incasata.

ATENTIE: Din motive de licentiere sistemul plationline nu permite efectuarea mai

multor operatii de creditare pentru o tranzactie incasata.

Creditarea tranzactiilor se face doar pentru cele incasate. Suma poate fi mai

mica sau egala cu cea de la tranzactia autorizata original.

Spre deosebire de autorizare, operatia de creditare nu se executa imediat. Zilnic

in anumite momente tranzactiile trimise spre creditare se grupeaza si sunt trimise mai


ATENTIE: Operatia de creditare se poate face doar dupa incasarea efectiva a banilor.

Trimiterea datelor pentru creditare direct la serverul PO


Parametru

Creditare

Optional/

Obligatoriu Tipul de data Descriere



Secventa de valori concatenate cu caracterul ^ (accent circumflex): - numar random 3 cifre; - Login_ID (=F_login);


- Stamp (=Data si ora server web); - PO Transaction ID (=X_Trans_ID); - Order Number (=F_Order_Number); - Amount (=F_Amount); - Action (=F_Action). ATENTIE: Valorile concatenate trebuie sa fie identice cu valorile din







F_Amount Obligatoriu Numeric

Suma creditata. 8 cifre cu punct ca delimitator si 2 zecimale dupa delimitator. Suma creditata nu poate fi mai mare decat cea incasata.

F_Action Obligatoriu Int Codul actiunii. Pentru Creditare valoare=1


Raspunsul la operatia de creditare

Dupa ce sistemul proceseaza cererea de creditare a tranzactiei PlatiOnline va trimite raspunsul in urmatorul format:

Parametru

Creditare

Tipul de

data Descriere

X_RESPONSE_CODE Int

Valoare=1 – cererea a fost inregistrata cu success ; Valoare=10 – o eroare a intervenit si tranzactia nu a putut fi trimisa spre creditare ; Valoare= 13 – cererea a fost respinsa deoarece starea tranzactie nu permite creditarea.



X_TRAN_ID Numeric




Cand operatia are success, un e-mail cu confirmarea creditarii tranzactiei va fi


autorizare) astfel incat clientul sa stie ca suma va deveni disponibila pe card in cel mai

scurt timp.

Interogarea

Cand executati operatii de incasare, anulare sau creditare este posibil ca din

diverse motive conexiunea la Internet sa nu functioneze si sa nu primiti raspunsul de la

serverul PO. Cum unele operatii se pot executa doar o singura data am implementat

operatia de Interogare care va permite sa vizualizati diversele stari ale tranzactiei la

momentul respectiv. Operatie de interogare este suportata de serviciul plationline.ro.

Trimiterea datelor pentru interogare direct la serverul PO


Parametru Interogare





Secventa de valori concatenate cu caracterul ^ (accent circumflex): - numar random 3 cifre; - Login_ID (=F_login); - Stamp (=Data si ora server web); - PO Transaction ID (=X_Trans_ID); - Order Number (=F_Order_Number); - Action (=F_Action). ATENTIE: Valorile concatenate

trebuie sa fie identice cu valorile din campuri corespondente.

Vezi Anexa A.



PO Transaction ID. Este parametrul intors de sistemul PO atunci cand se executa operatia de autorizare. Fiecare tranzactie din sistemul PO este


identificata in mod unic prin acest identificator.



F_Action Obligatoriu Int Codul actiunii. Pentru Creditare valoare=0

Raspunsul la operatia de interogare

Dupa ce sistemul proceseaza cererea de interogare a tranzactiei, PlatiOnline va trimite raspunsul in urmatorul format:

Parametru

Interogare

Tipul de

data Descriere

X_RESPONSE_CODE Int Valoare= 0 – cererea a fost inregistrata cu success Valoare= 10 – o eroare a intervenit si tranzactia nu a putut fi trimisa spre interogare.



X_TRAN_ID Numeric



X_STARE_FIN1 Int Codul starii financiare 1. Vezi Anexa F.

X_STARE_FIN2 Int Codul starii financiare 2. Vezi Anexa F.

X_STARE_CC Int Codul starii de completare a comenzii. Vezi Anexa F.

X_STARE_SECURITATE Int Codul starii de securitate. Vezi Anexa F.

X_STARE_SC Int Codul starii comenzii din punct de vedere al serviciului clienti. Vezi Anexa F.

F_Shipping_Company Varchar(50) Numele companiei care face livrarea comenzii.

F_AWB Varchar(50) Numarul documentului de transport de la compania care face livrarea.

7. Testarea contului de comerciant

Pentru testarea contulului de comerciant trebuie parcursi urmatorii pasi:

1. Se acceseaza interfata proprie de comerciant https://comercianti.plationline.ro;


2. In meniul “setari” (settings), se selecteaza ‘modul test’ (test mode) din josul paginii;

3. Asigurarea ca modul test este pornit. Sau in pagina formularului de plata se va introduce campul F_TEST_REQUEST=1. Pentru derularea testelor se vor folosi urmatoarele date: Pentru a testa folosind card Visa/MasterCard: URL https://secure2.plationline.ro/trans30ta.asp Numar card pentru card Mastercasrd 5121212121212124 Numar card pentru card VISA 4111111111111111 Data expirarii cardului Orice data ulterioara Numarul CVV 999 Suma maxima in RON 1.35 Autorizare cu success – puneti la parametrul F_Amount o valoare mai mica decat

1.00

Autorizare cu success insa necesita verificari ulterioare – puneti la parametrul F_Amount valoarea

1.01

Eroare la autorizare - puneti la parametrul F_Amount valoarea

1.05

Tranzactie refuzata - puneti la parametrul F_Amount mai mare decat

1.35


8. Analiza PO si activarea contului

Dupa integrarea sistemului specialistii PO vor face o analiza si vor testa modul in

care se executa operatiile e-commerce pentru a preintampina eventualele probleme de

desfasurare a operatiunilor si de securitate.

Dupa analiza, contul este activat si testat in « productie » de specialistii PO.


Anexa A

Cum se formeaza campul

F_Message/F_Message_Relay

In functie de operatia pe care urmeaza sa o efectuati trebuie sa creati campul

F_Message. El este prezent in toate operatiile efectuate prin trimiterea datelor direct la

serverul PO.

Campul F_message este o concatenare a mai multor campuri separate de

caracterul ^ (accent circumflex). La fiecare operatie aveti in documetatie lista

campurilor utilizate la crearea campului F_Message.

Prin structura lui campul F_Message este unic pentru fiecare operatie in parte.

Exemple de formare a campului F_Message in PHP sau VBScript pentru diverse operatii gasiti in sectiunea download din interfata dedicata comerciantilor.

La operatia Autorizare in raspuns apare campul F_Message_Relay.

Campul F_Message_Relay este format prin concatenarea mai multor campuri

separate de caracterul ^ (accent circumflex).

Prin structura lui campul F_Message_Relay este unic pentru fiecare operatie in

parte.

In pagina in care faceti preluarea raspunsului de la serverul PO trebuie sa

verificati sa se potriveasca valorile ce compun F_Message_Relay cu cele din

campurile respective. Daca verificarea este corecta atunci incriptati valoarea campului

F_Message_Relay prin RSA si apoi valoarea obtinuta cu HMAC si comparati cu

valoarea campului F_Crypt_Message_Relay.

ATENTIE:

Numai dupa succesul acestor verificari puteti sa prelucati raspunsul primit de la server.


Anexa B

Cum se formeaza strctura XML pentru campul

F_Order_String

In campul F_Order_String se trimit datele despre bunurile sau serviciile

comandate. Structura XML permite preluarea datelor din “cos” astfel incat produsele si datele de livrare sa fie disponibile in sistemul PO. <start_string> <item> <ProdID></ProdID> <qty></qty> <itemprice></itemprice> <name></name> <period></period> <rec_id></rec_id> <description></description> <pimg></pimg> <rec_price></rec_price> <vat></vat> <lang_id></lang_id> <stamp></stamp> <on_stoc></on_stoc> <prodtype_id></prodtype_id> <categ_id></categ_id> <merchLoginID></merchLoginID> </item> <coupon> <key></key> <value></value> <percent></percent> <workingname></workingname> <type></type> <scop></scop> <vat></vat> </coupon> <shipping> <type></type> <price></price>

<vat></vat> <pimg></pimg> </shipping> </start_string>


Fiecare tag <item> defineste un produs din cos; astfel cate produse are cosul atatea taguri consecutive <item> vor fi in structura XML.

Parametru

F_Order_String

Optional/

Obligatoriu

Tipul de

data Descriere

ProdID Obligatoriu Int Identifica unic produsul in magazinul virtual

Qty Obligatoriu Numeric Cantitatea pe produs

Itemprice Obligatoriu numeric Pretul produsului pe unitate

Name Obligatoriu Varchar(150) Nume produs

Period Obligatoriu Varchar(50) Perioada de repetare a platii. OPTIUNEA NU ESTE IMPLEMENTATA Valoare= string vid

Rec_id Obligatoriu Int ID-ul perioadei de repetare OPTIUNEA NU ESTE IMPLEMENTATA Valoare= string vid

Description Obligatoriu Varchar(150) Descriere produs

Pimg Obligatoriu Varchar(150) Linkul catre poza produsului OPTIUNEA NU ESTE IMPLEMENTATA Valoare= string vid

Rec_price Obligatoriu Numeric Suma de incasat la urmatoarea plata automata. OPTIUNEA NU ESTE IMPLEMENTATA Valoare= string vid

Vat Obligatoriu Numeric Suma reprezentand valoare T.V.A. Se calculeaza qty*itemprice*(procent T.V.A.)

Lang_id Obligatoriu Char(2) Valori acceptate ro sau en. Limba utilizata la selectarea produsului.

Stamp Obligatoriu Datetime Data si ora la care clientul a adaugat produsul in cos.

On_stoc Obligatoriu Int Valoare=1 daca produsul este in stoc. Valoare=0 daca produsul nu este in stoc.

Prodtype_id Obligatoriu Int Valoare=1 daca produsul este tangibil. Valoare=0 daca produsul este digital.

Categ_id Obligatoriu Int Categoria produsului. OPTIUNEA NU ESTE IMPLEMENTATA Valoare= string vid.

merchLoginID Obligatoriu Int Identificatorul comerciantului. OPTIUNEA NU ESTE IMPLEMENTATA Valoare= string vid


Tagul <coupon> defineste cuponul utilizat de client sau reducerea acordata de comerciant.

Parametru F_Order_String


Tipul de data

Descriere

Key Obligatoriu Varchar(10) Cheia reducerii utilizata in magazinul virtual

Value Obligatoriu Numeric Valoarea reducerii.

Percent Obligatoriu Int Valoare=1 – valoarea se aplica procentual. Valoare=0 – valoarea se aplica ca atare.

Workingname Obligatoriu Varchar(50) Numele promotiei.

Type Obligatoriu Int Valoare=0 – cupon de reducere. Valoare=1 – reducere (sale).

Scop Obligatoriu Int

Valoare=1 – reducerea se aplica doar la valoarea comenzii fara valoarea transportului. Valoare=0 – reducerea se aplica la intreaga valoare a comenzii.

Vat Obligatoriu Numeric Suma reprezentand valoarea T.V.A. Se calculeaza (valoare reducere)*(procent T.V.A.)

Tagul <shipping> contine informatiile de livrare a comenzii selectate de client.

Parametru

F_Order_String

Optional/

Obligatoriu

Tipul de

data Descriere

Type Obligatoriu Int Valoare=0 – livrare standard. Valoare=1 – livrare rapida.

Price Obligatoriu Numeric Pretul transportului.

Vat Obligatoriu Numeric Suma reprezentand valoarea T.V.A. Se calculeaza (valoare reducere)*(procent T.V.A.)

Pimg Obligatoriu Varchar(150) Adresa de Internet catre logo-ul companiei de transport.


Anexa C

Lista codurilor tarilor

Tara Cod tara

Austria AT Belgium BE Canada CA Czech Republic CZ Fiji FJ Finland FI France FR Germany DE Greece GR Israel IL Italy IT Japan JP Luxembourg LU New Zealand NZ Northern Mariana Islands MP Russian Federation RU Spain ES Sweden SE Switzerland CH The Netherlands NL United Arab Emirates AE United States US Virgin Islands (British) VG Afghanistan AF Åland Islands AX Albania AL Algeria DZ American Samoa AS Andorra AD Angola AO Anguilla AI Antarctica AQ Antigua and Barbuda AG Argentina AR Armenia AM Aruba AW Australia AU Azerbaijan AZ Bahamas BS Bahrain BH Bangladesh BD Barbados BB Belarus BY Belize BZ

Benin BJ Bermuda BM Bhutan BT Bolivia BO Bosnia and Herzegovina BA Botswana BW Bouvet Island BV Brazil BR British Indian Ocean Territory IO Brunei Darussalam BN Bulgaria BG Burkina Faso BF Burundi BI Cambodia KH Cameroon CM Cape Verde CV Cayman Islands KY Central African Republic CF Chad TD Chile CL China CN Christmas Island CX Cocos (Keeling) Islands CC Colombia CO Comoros KM Congo CG Congo, Democratic Republic of CD Cook Islands CK Costa Rica CR Côte Divoire CI Croatia HR Cuba CU Cyprus CY Denmark DK Djibouti DJ Dominica DM Dominican Republic DO Ecuador EC Egypt EG El Salvador SV Equatorial Guinea GQ Eritrea ER Estonia EE Ethiopia ET Falkland Islands FK


Faroe Islands FO French Guiana GF French Polynesia PF French Southern Territories TF Gabon GA Gambia GM Georgia GE Ghana GH Gibraltar GI Greenland GL Grenada GD Guadeloupe GP Guam GU Guatemala GT Guernsey GG Guinea GN Guinea-Bissau GW Guyana GY Haiti HT Heard and McDonald Islands HM Honduras HN Hong Kong HK Hungary HU Iceland IS India IN Indonesia ID Iran (Islamic Republic of) IR Iraq IQ Ireland IE Isle of Man IM Jamaica JM Jersey JE Jordan JO Kazakhstan KZ Kenya KE Kiribati KI Korea, Democratic Peoples Republic

KP

Korea, Republic of KR Kuwait KW Kyrgyzstan KG Lao Peoples Democratic Republic LA Latvia LV Lebanon LB Lesotho LS Liberia LR Libyan Arab Jamahiriya LY Liechtenstein LI Lithuania LT Macau MO Macedonia MK Madagascar MG Malawi MW

Malaysia MY Maldives MV Mali ML Malta MT Marshall Islands MH Martinique MQ Mauritania MR Mauritius MU Mayotte YT Metropolitan France FX Mexico MX Monaco MC Mongolia MN Montenegro ME Montserrat MS Morocco MA Mozambique MZ Myanmar MM Namibia NA Nauru NR Nepal NP Netherlands Antilles AN New Caledonia NC Nicaragua NI Niger NE Nigeria NG Niue NU Norfolk Island NF Norway NO Oman OM Pakistan PK Palau PW Papua New Guinea PG Paraguay PY Peru PE Philippines PH Pitcairn PN Poland PL Portugal PT Puerto Rico PR Qatar QA Reunion RE Romania RO Rwanda RW Saint Helena SH Saint Kitts and Nevis KN Saint Lucia LC Saint Vincent and the Grenadines VC Samoa WS San Marino SM Sao Tome and Principe ST Saudi Arabia SA Senegal SN


Serbia RS Seychelles SC Sierra Leone SL Singapore SG Slovakia (Slovak Republic) SK Slovenia SI Solomon Islands SB Somalia SO South Africa ZA South Georgia and the South Sandwich Islands

GS

Sri Lanka LK St. Helena SH St. Pierre and Miquelon PM Sudan SD Suriname SR Svalbard and Jan Mayen Islands SJ Swaziland SZ Syrian Arab Republic SY Taiwan TW Thailand TH Timor-Leste TL Togo TG Tokelau TK Tonga TO Trinidad and Tobago TT

Tunisia TN Turkey TR Turkmenistan TM Turks and Caicos Islands TC Tuvalu TV Uganda UG Ukraine UA United Kingdom GB United States Minor Outlying Islands

UM

Uruguay UY Uzbekistan UZ Vanuatu VU Vatican City State (Holy See) VA Venezuela VE Vietnam VN Virgin Islands (U.S.) VI Wallis and Futuna Islands WF Western Sahara EH Yemen YE Zambia ZM Zimbabwe ZW


Anexa D

Lista codurilor statelor corespondente tarilor

Stat/Judet/

Provincie

Cod

stat

Cod

tara

Alabama AL US Alaska AK US American Samoa AS US Arizona AZ US Arkansas AR US Armed Forces Americas AA US Armed Forces Europe AE US Armed Forces Pacific AP US California CA US Canada CN US Colorado CO US Connecticut CT US Delaware DE US District of Columbia DC US Florida FL US Georgia GA US Guam GU US Hawaii HI US Idaho ID US Illinois IL US Indiana IN US International IT US Iowa IA US Kansas KS US Kentucky KY US Louisiana LA US Maine ME US Maryland MD US Massachusetts MA US Michigan MI US Minnesota MN US Mississippi MS US Missouri MO US Montana MT US Nebraska NE US Nevada NV US New Hampshire NH US New Jersey NJ US New Mexico NM US New York NY US North Carolina NC US North Dakota ND US Northern Mariana Is. MP US Ohio OH US Oklahoma OK US

Oregon OR US Palau PW US Pennsylvania PA US Puerto Rico PR US Rhode Island RI US South Carolina SC US South Dakota SD US Tennessee TN US Texas TX US U.S. Virgin Islands VI US United States Federal US US Utah UT US Vermont VT US Virginia VA US Washington WA US West Virginia WV US Wisconsin WI US Wyoming WY US Trentino-Alto Adige/Südtirol TRE IT Abruzzo ABR IT Aosta Valley AO IT Apulia PUG IT Basilicata BAS IT Calabria CAL IT Campania CAM IT Emilia-Romagna EMI IT Friuli-Venezia Giulia FRI IT Lazio LAZ IT Liguria LIG IT Lombardy LOM IT Marches MAR IT Molise MOL IT Piedmont PIE IT Sardinia SAR IT Sicily SIC IT Tuscany TOS IT Umbria UMB IT Veneto VEN IT East Anglia EA GB East Midlands EM GB North N GB North East NE GB North West NW GB South East SE GB South West SW GB West Midlands WM GB Alsace AL FR


Aquitaine AQ FR Auvergne AU FR Basse-Normandie BA FR Bourgogne BO FR Bretagne BR FR Centre CE FR Champagne-Ardenne CH FR Corsica CO FR Franche-Comté FR FR Haute-Normandie HA FR Île-de-France IL FR Languedoc-Roussillon LA FR Limousin LI FR Lorraine LO FR Midi-Pyrénées MT FR Nord-Pas de Calais NO FR Pays de la Loire PA FR Picardie PI FR Poitou-Charentes PO FR Provence-Alpes-Côte d'Azur PR FR Rhône-Alpes RH FR Andalucia AN ES Aragon AR ES Asturias AS ES Balearic Islands IB ES Basque Country BC ES Canary Islands CI ES Cantabria CAN ES Castilla y Leon CL ES Castilla-La Mancha CM ES Catalonia CAT ES Extremadura EX ES Galicia GA ES La Rioja LR ES Madrid MA ES Murcia MU ES Navarra NA ES Valencian Community VA ES

Baden-Württemberg BW DE Berlin BE DE Brandenburg BB DE Freie Hansestadt Bremen HB DE Freie und Hansestadt Hamburg

HH DE

Freistaat Bayern BY DE Freistaat Sachsen SL DE Freistaat Thüringen TH DE Hessen HE DE Mecklenburg-Vorpommern MV DE Niedersachsen NI DE Nordrhein-Westfalen NW DE Rheinland-Pfalz RP DE Saarland SL DE Sachsen-Anhalt ST DE Schleswig-Holstein SH DE Alberta AB CA British Columbia BC CA Manitoba MB CA New Brunswick NB CA Newfoundland NL CA Northwest Territories NT CA Nova Scotia NS CA Nunavut NU CA Ontario ON CA Prince Edward Island PE CA Quebec QC CA Saskatchewan SK CA Yukon YT CA New South Wales NSW AU Queensland QLD AU South Australia SA AU Tasmania TAS AU Victoria VIC AU Western Australia WA AU


Anexa E

Gestionarea codurilor de raspuns

Tipuri de mesaje

Exista 4 tipuri de mesaje ce pot apare in utilizarea sistemului PlatiOnline.ro:

1 - Mesaje de aprobare la banca emitenta ;

2 - Mesaje de refuz la banca emitenta ;

3 - Mesaje din sistemul de plata ;

4 - Mesaje de le banca acceptatoare.

Mesajele contin Starea operatiei, codul mesajului, textul asociat si actiunea

recomandata. Acesti parametri sunt trimisi in aplicatia comerciatului ca raspuns la

operatiile efectuate.

Cand trimiteti cereri de efectuare operatii, primiti un mesaj de raspuns de la serverul PO cu urmatoarele campuri:

Parametrul Tipul de data

Descriere

X_RESPONSE_CODE Int Indica starea operatiei

X_RESPONSE_REASON_CODE Varchar(50) Valoarea reprezinta codul mesajului primit.

X_RESPONSE_REASON_TEXT Varchar(500) Mesajul explica valoarea parametrului X_RESPONSE_CODE

F_ACTION_CODE Char(2) Codul actiunii reprezinta o recomandare a actiunii ce trebuie intreprinsa.


Cod Actiune

Pentru a ajuta comerciantii sa implementeze cat mai bine sistemul Plationline.ro in aplicatia lor, am grupat codurile de raspuns dupa actiunea ce trebuie intreprinsa.

Cod

actiune Descriere

AR

Autentificare/Autorizare refuzata. Cardul nu poate fi autentificat/autorizat. ACTUNIE: Cereti utilizatorului sa verifice datele de pe card introduse in pagina de plata, iar daca mesajul revine de mai multe ori recomandati:

- sa contacteze banca emitenta si sa verifice de ce nu poate folosi cardul pentru tranzactii online in MEDIUL 3D (Verified by Visa si Mastercard 3D Secure) ;

- sa utilizeze alt card.

CI Client information. Clientul a oferit informatii incorecte. ACTIUNE :

Cereti utilizatorului sa introduca corect informatiile de pe card.

IE Eroare Interna. O eroare a intervenit in timpul operatiei. ACTIUNE : Va rugam sa raportati problema la : [email protected]. Utilizati operatia de Interogare ca sa aflati starea tranzactiei.

MI Merchant information. Aplicatia comerciantului a trimis informatii incorecte la serverul PO. ACTIUNE:

Verificati lista parametrilor in functie de opratie si tipul de data asociat.

NA Nici o actiune. Tranzactia a fost aprobata. Felicitati clientul ☺.

Lista mesajelor raspuns intoarse de sistemul platinonline.ro Cod mesaj

Mesaj Descriere Cod

Actiune Tip cod

60002 Campul [F_MESSAGE] este obligatoriu.

In mesajul trimis la server lipseste parametrul F_MESSAGE

MI 3

60003 Campul [F_CRYPT MESSAGE] este obligatoriu.

In mesajul trimis la server lipseste parametrul F_CRYPT_MESSAGE.

MI 3

60004 Campurile [F_MESSAGE] si [F_CRYPT_MESSAGE] nu se potrivesc.

Valoarea parametrului F_CRYPT_MESSAGE decriptata nu coincide cu cea a parametrului F_MESSAGE

MI 3

60005 Campul [F_Amount] este obligatoriu.

In mesajul trimis la server lipseste parametrul F_AMOUNT MI 3

60006 Valoarea introdusa in campul [F_Amount] are un format gresit.

Valoarea campului F_AMOUNT trebuie sa fie numerica cu separator zecimal caracterul punct, lungimea maxima este de 8 cifre si 2 zecimale dupa delimitator

MI 3

60007 Ati depasit suma/valoarea maxima permisa!

Fiecare comerciant are o valoare limita pe tranzactie. Verificati limita contului in sectiunea “setari” in interfata comerciantilor si limitati suma pe tranzactie. Daca doriti sa marim suma limita va rugam sa ne contactati.

MI 3

60008 Suma introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul

Verificati ca in formarea parametrului F_MESSAGE sa puneti valoarea si formatul parametrului F_AMOUNT.

MI 3


introdus in campul [F_Amount].

60009

Valoarea introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul introdus in campul [F_Currency].

Verificati ca in formarea parametrului F_MESSAGE sa puneti valoarea si formatul parametrului F_CURRENCY.

MI 3

60010 Format invalid al campului [F_Message]!

Parametrul F_MESSAGE nu este format corect. Verificati ca datele concatenate sa fie conform operatiei pe care o executati.

MI 3

60011 Lipseste numele! Parametrul F_First_name este vid. CI 3 60012 Lipseste prenumele! Parametrul F_LAST_name este vid. CI 3 60013 Lipseste adresa! Parametrul F_ADDRESS este vid. CI 3 60014 Lipseste orasul! Parametrul F_city este vid. CI 3 60015 Lipseste judetul! Parametrul F_STATE este vid. CI 3 60016 Lipseste tara! Parametrul F_Country este vid. CI 3

60017 Nu puteti efectua tranzactii din/in

Verificati ca ip-ul sau codul tarii din care se incearca sa se efectueze tranzactia sa nu fie blocat de sistemul plationline.ro

CI 3

60018 Lipseste codul postal! Parametrul F_Zip este vid. CI 3 60019 Lipseste numarul de telefon! Parametrul f_phone este vid. CI 3

60020 Numarul de telefon trebuie sa aiba 7 cifre!

Verificati ca parametrul F_Phone sa aiba minim 7 cifre.

CI 3

60021 Lipseste adresa de e-mail. Parametrul f_email este vid. CI 3 60022 Lipseste descrierea comenzii. Parametrul f_order_string este vid. CI 3

60023 Este interzisa efectuarea tranzactiei din aceasta adresa IP!

Verificati ca ip-ul sau codul tarii din care se incearca sa se efectueze tranzactia sa nu fie blocat de sistemul plationline.ro

CI 3

60024 Adresa IP invalida! Sistemul PO nu poate sa inregistreze adresa de internet a computerului de pe care se face tranzactia.

IE 3

60025 Tranzactie duplicat! Tranzactia este deja aprobata de banca emitenta si clientul incearca sa plateasca din nou.

CI 3

60026

Valoarea introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul introdus in campul [F_Order_Number].

Verificati ca in formarea parametrului F_MESSAGE sa puneti valoarea si formatul parametrului

MI 3

60027 Campul [F_Currency] este obligatoriu.

Parametrul F_Currency este vid. CI 3

60028 Campul [F_Order_Number] este obligatoriu. Parametrul F_Order_Number este vid. CI 3

60029 Campul [F_CC_Number] este obligatoriu.

Parametrul F_CC_Number este vid. CI 3

60030 Campul [F_Order_String] este obligatoriu. Parametrul F_Order_String este vid. CI 3

60031 Invalid Credit Card CVC2! Parametrul F_CC_CVV2 este vid, sau formatul nu este corect.

CI 2

60032 Invalid Credit Card Exp. Month!

Parametrul F_CC_EXP_Month este vid, sau formatul nu este corect. CI 3

60033 Invalid Credit Card Exp. Year! Parametrul F_CC_EXP_Year este vid, sau formatul nu este corect.

CI 3

60034 Credit Card has Expired ! Cardul introdus a expirat. CI 3


60035 Invalid card type! Tipul de card utilizat nu este acceptat in sistemul plationline.ro. CI 3

60036 Autorizata Tranzactia a fost autorizata. NA 1

60037 CONTACTATI BANCA EMITENTA

Comerciantul trebuie sa sune emitentul inainte ca tranzactia sa poata fi aprobata. AR 1

60038 TRIMITERE – CONDITII SPECIALE

Comerciantul trebuie sa sune emitentul inainte ca tranzactia sa poata fi aprobata. AR 1

60039 COMERCIANT INEXISTENT Numarul de identificare al comerciantului este invalid. MI 4

60040 RECUPEREAZA CARDUL

Cardul este listat in Buletinul Avertismentelor. Comerciantul poate primi recompense in bani daca recupereaza cardul.

AR 2

60041 NU ONORA Tranzactia a fost respinsa fara nici o explicatie din partea bancii emitente. AR 2

60042 EROARE - INCEARCA DIN NOU

O eroare interna a intervenit. Sfatuiti clientul sa sune dun nou. AR 3

60043 RECUPEREAZA!! FRAUDA!! Atentie FRAUDA!! AR 2

60044 ONOREAZA CU IDENTIFICARE

Comerciantul trebuie sa obtina un act de identifiare de la client inainte ca tranzactia sa poata fi aprobata.

AR 2

60045 CERERE IN CURS DE DESFASURARE

CERERE IN CURS DE DESFASURARE AR 2

60046 APROBATA PARTIAL Tranzactia a fost aprobata pentru o suma partiala. AR 1

60047 APROBARE VIP Tranzactia este aprobata, program VIP. AR 1

60048 TRANZACTIE INVALIDA Tranzactia ceruta nu este suportata sau nu este valida pentru numarul de card prezentat.

AR 3

60049 SUMA INVALIDA Suma depaseste limitele stabilite de emitent pentru acest tip de tranzactie. AR 3

60050 NUMAR DE CONT INVALID Numarul contului de card nu este valid sau este inexistent AR 3

60051 EMITENT INEXISTENT-IMPOSIBILITATEA DE A INDRUMA CATRE IEM

Primele 8 cifre ale numarului cardului nu sunt valide si tranzactia nu poate fi directionata spre emitent.

CI 3

60052 APROBATA, ACTUALIZEAZA TRASEUL 3

APROBATA, ACTUALIZEAZA TRASEUL 3 AR 1

60053 REINTRODU CEREREA REINTRODU CEREREA AR 4

60054 NICI O MASURA LUATA Nicio masura luata. Emitentul a refuzat tranzactia fara nicio explicatie. AR 2

60055 DEFECTIUNE A aparut o eroare in reteaua de tranzactii. Incercati mai tarziu. AR 3

60056 EROARE DE FORMAT Tranzactia nu a are formatul necesar. AR 3

60057 Banca emitenta nu este eligibila pentru tranzactionare

Sistemul emitentului nu poate fi accesat. AR 3

60058 PARTIAL FINALIZATA PARTIAL FINALIZATA AR 1

60059 RECUPERARE – CARD RESTRICTIONAT

Cardul este restrictionat de banca emitenta. Comerciantul poate primi recompense in bani daca recupereaza cardul.

AR 2

60060 RECUPERARE – CONTACTATI BANCA ACCEPTATOARE

Contactati banca emitenta. Comerciantul poate primi recompense in bani daca recupereaza cardul.

AR 2

60061 RECUPERARE – DEPASIREA NR. ADMIS DE

Incercarile de introducere de PIN au depasit limitele emitentului. Comerciantul AR 2


REINTRODUCERE DE PIN poate primi recompense in bani daca recupereaza cardul.

60062 CONT DE CREDIT INEXISTENT

CONT DE CREDIT INEXISTENT AR 2

60063 RECUPERARE – CARD PIERDUT

Cardul a fost declarat pierdut. AR 2

60064 RECUPERARE - CARD FURAT Cardul a fost declarat furat. AR 2

60065 FONDURI INSUFICIENTE Limita de credit pentru acest cont a fost depasita. AR 2

60066 CONT CURENT INEXISTENT CONT CURENT INEXISTENT AR 2

60067 CONT DE ECONOMII INEXISTENT

CONT DE ECONOMII INEXISTENT AR 2

60068 PIN INCORECT PIN-ul posesorului cardului este incorect. AR 2

60069 NEPERMIS POSESORULUI CARDULUI

Cardului nu ii este permis tipul de tranzactie cerut. AR 2

60070 NEPERMIS POS-ULUI Comerciantului nu ii este permis acest tip de tranzactie. AR 2

60071 DEPASESTE LIMITA DE SUMA Suma depaseste maximul zilnic permis. AR 2 60072 CARD RESTRICTIONAT Cardul a fost restrictionat. AR 2 60073 VIOLAREA SECURITATII Cardul a fost restrictionat. AR 2

60074 S-A DEPASIT NR. DE OPERATIUNI PE CONT

Limita operatiunilor pe cont a fost depasita o data cu aceasta tranzactie. AR 2

60075 S-A DEPASIT NR DE REINTRODUCERI A PINULUI.

S-A DEPASIT NR DE REINTRODUCERI A PINULUI AR 2

60076 Autentificare nereusita.

Eroare tehnica, sau nu ati introdus corect parola 3D, sau banca emitenta nu accepta tranzactii in standardul 3D Verified by Visa sau Mastercard 3D Secure.

AR 2

60077 Raspuns invalid. Raspunsul invalid de la banca emitenta. AR 2

60078 Terminalul este blocat va rugam sa incercati din nou.

Terminalul este blocat va rugam sa incercati din nou. AR 2

60079 Eroare tehnica - nu trebuie sa apara.

Eroare tehnica – nu trebuie sa apara IE 3

60080 Codul operatiei este invalid ! Parametrul F_ACTION are o valoare incorecta. Verificati valoarea parametrului. MI 3

60081 Valoarea introdusa in campul [F_Currency] are un format gresit.

Parametrul F_CURRENCY are o valoare incorecta. Verificati valoarea parametrului. MI 3

60082 Autorizare cu success insa necesita verificari ulterioare.

Comanda a fost acceptata insa scorul de frauda asociat tranzactiei are o valoare ce indica necesitatea unor verificari manuale ulterioare.

NA 1

60083 Campul [F_Email] are un format invalid.

Parametrul F_Email trebuie sa fie de forma: nume_cont@nume_domeniu.domeniu

CI 3

60084 Campul [F_Order_Number] are un format invalid.

Parametrul F_Order_number trebuie sa fie numeric MI 3

60085 Parametrul [F_Shipping_Company] nu are valoare.

Daca tranzactia nu presupune livrarea produselor puneti semnul minus la valoare MI 3

60086

Valoarea introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul campului [F_Login].

Atentie la modul in care formati campul F_Message. El are o componenta diferita in functie de tipul operatiei.

MI 3

60087 Valoarea introdusa in campul Atentie la modul in care formati campul MI 3


[F_Message] nu se potriveste cu valoarea sau formatul campului [X_Trans_ID].

F_Message. El are o componenta diferita in functie de tipul operatiei.

60088

Valoarea introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul campului [F_AWB].


MI 3

60089

Valoarea introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul campului [F_Shipping_Company].


MI 3

60090

Valoarea introdusa in campul [F_Message] nu se potriveste cu valoarea sau formatul campului [F_Action].


MI 3

60091 Tranzactie neindentificata. Tranzactia nu a putut fi identificatata in sistem. Verificati parametrii de identificare ai tranzactiei.

MI 3

60092 Tranzactia nu a fost verficata manual.

Tranzactia este autorizata insa necesita verificari suplimentare (asteptati maxim 24 de ore lucratoare pentru raspunsul final; recomandam sa nu faceti expedierea bunului/prestarea serviciului pana cand verificarile de frauda nu se finalizeaza).

NA 3

60093 Starea actuala a tranzactiei este incompatibila cu operatia ceruta.

Starea actuala a tranzactiei este incompatibila cu operatia ceruta. MI 3

60094 Suma tranzactiei este mai mica decat suma pe care doriti sa o creditati.

ATENTIE suma creditata este mai mare decat cea a tranzactiei. Verificati sumele.

MI 3

90000 NOT DOCUMENTED EROARE PRIMITA NU ESTE RECUNOSCUTA. CITITI DESCRIEREA ERORII.

AR 3


Anexa F

Operatiile e-commerce, valorile campului F_Action

Sistemul plationline.ro suporta urmatoarele tipuri de operatii:

Parametrul F_Action

Descriere

2 Autentificare si autorizare. 3 Incasare 7 Anulare 1 Creditare 0 Interogare

Date post:	27-Jun-2015
Category:	Documents
Upload:	dpetronela
View:	191 times
Download:	7 times

API Plat Ion Line Ver 3.01

Documents