Documente Academic
Documente Profesional
Documente Cultură
ro
Versiunea 3.0
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
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.
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)
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.
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).
ID Comerciant
Cheia 1
Comerciant PlatiOnline.ro Securitate
Cheia 2
cont e-commerce
Contul de utilizator
(https://comercianti.plationline.ro)
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>
Fig. 1
Dupa conectare veti avea acces la toate serviciile oferite comerciantilor de sistemul
PlatiOnline.
Fig. 2
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.
Fig. 3
Parametru Tipul de
Descriere
Incasare data
Valoare=3 – cererea a fost inregistrata cu success
Valoare=10 – o eroare a intervenit si tranzactia nu a
putut fi trimisa spre incasare
Int Valoare=13 – tranzactia este autorizata insa necesita
X_RESPONSE_CODE
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).
Varchar(50) Valoarea reprezinta codul mesajului primit.
X_RESPONSE_REASON_CODE
Vezi Anexa E.
Varchar(500) Mesajul explica valoarea parametrului
X_RESPONSE_REASON_TEXT
X_RESPONSE_CODE.
Reprezinta ID – ul tranzactiei in sistemul plationline.
Numeric Acest ID identifica in mod unic tranzactia in cadrul
X_TRANS_ID
sistemului plationline, si este utilizat de fiecare data cand
se modifica starile tranzactiei prin operatii specifice.
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
departe bancilor emitente.
Parametru Tipul de
Descriere
Anulare data
Valoare= 7 – cererea a fost inregistrata cu success
Valoare= 10 – o eroare a intervenit si tranzactia nu a
X_RESPONSE_CODE Int putut fi trimisa spre anulare.
Valoare= 13 – cererea a fost respinsa deoarece starea
tranzactiei nu permite anularea.
Varchar(50) Valoarea reprezinta codul mesajului primit.
X_RESPONSE_REASON_CODE
Vezi Anexa E.
Varchar(500) Mesajul explica valoarea parametrului
X_RESPONSE_REASON_TEXT
X_RESPONSE_CODE.
Reprezinta ID – ul tranzactiei in sistemul plationline.
Numeric Acest ID identifica in mod unic tranzactia in cadrul
X_TRAN_ID
sistemului plationline, si este utilizat de fiecare data cand
se modifica starile tranzactiei prin operatii specifice.
Char(2) Codul actiunii reprezinta o recomandare a actiunii ce
X_ACTION_CODE
trebuie intreprinsa.
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.
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
departe bancilor emitente.
ATENTIE: Operatia de creditare se poate face doar dupa incasarea efectiva a banilor.
Parametru Tipul de
Descriere
Creditare data
Valoare=1 – cererea a fost inregistrata cu success ;
Valoare=10 – o eroare a intervenit si tranzactia nu a
X_RESPONSE_CODE Int putut fi trimisa spre creditare ;
Valoare= 13 – cererea a fost respinsa deoarece starea
tranzactie nu permite creditarea.
Varchar(50) Valoarea reprezinta codul mesajului primit.
X_RESPONSE_REASON_CODE
Vezi Anexa E.
Varchar(500) Mesajul explica valoarea parametrului
X_RESPONSE_REASON_TEXT
X_RESPONSE_CODE.
Reprezinta ID – ul tranzactiei in sistemul plationline.
Numeric Acest ID identifica in mod unic tranzactia in cadrul
X_TRAN_ID
sistemului plationline, si este utilizat de fiecare data cand
se modifica starile tranzactiei prin operatii specifice.
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.
Parametru Tipul de
Descriere
Interogare data
Valoare= 0 – cererea a fost inregistrata cu success
X_RESPONSE_CODE Int Valoare= 10 – o eroare a intervenit si tranzactia nu a
putut fi trimisa spre interogare.
Varchar(50) Valoarea reprezinta codul mesajului primit.
X_RESPONSE_REASON_CODE
Vezi Anexa E.
Varchar(500) Mesajul explica valoarea parametrului
X_RESPONSE_REASON_TEXT
X_RESPONSE_CODE.
Reprezinta ID – ul tranzactiei in sistemul plationline.
Numeric Acest ID identifica in mod unic tranzactia in cadrul
X_TRAN_ID
sistemului plationline, si este utilizat de fiecare data cand
se modifica starile tranzactiei prin operatii specifice.
Char(2) Codul actiunii reprezinta o recomandare a actiunii ce
X_ACTION_CODE
trebuie intreprinsa.
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.
Int Codul starii comenzii din punct de vedere al serviciului
X_STARE_SC
clienti. Vezi Anexa F.
F_Shipping_Company Varchar(50) Numele companiei care face livrarea comenzii.
Varchar(50) Numarul documentului de transport de la compania care
F_AWB
face livrarea.
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.
Exemple de formare a campului F_Message in PHP sau VBScript pentru diverse operatii
gasiti in sectiunea download din interfata dedicata comerciantilor.
ATENTIE:
Numai dupa succesul acestor verificari puteti sa prelucati raspunsul primit de la server.
<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>
Tipuri de mesaje
Tipul de
Parametrul Descriere
data
X_RESPONSE_CODE Int Indica starea operatiei
X_RESPONSE_REASON_CODE Varchar(50) Valoarea reprezinta codul mesajului primit.
Varchar(500) Mesajul explica valoarea parametrului
X_RESPONSE_REASON_TEXT
X_RESPONSE_CODE
Char(2) Codul actiunii reprezinta o recomandare a actiunii ce
F_ACTION_CODE
trebuie intreprinsa.
Cod
Descriere
actiune
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
AR 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.
Client information. Clientul a oferit informatii incorecte.
CI ACTIUNE :
Cereti utilizatorului sa introduca corect informatiile de pe card.
Eroare Interna. O eroare a intervenit in timpul operatiei. ACTIUNE :
IE Va rugam sa raportati problema la : tech@plationline.ro. Utilizati operatia de Interogare
ca sa aflati starea tranzactiei.
Merchant information. Aplicatia comerciantului a trimis informatii incorecte la serverul PO.
MI ACTIUNE:
Verificati lista parametrilor in functie de opratie si tipul de data asociat.
Nici o actiune.
NA
Tranzactia a fost aprobata. Felicitati clientul ☺.
Parametrul
Descriere
F_Action
2 Autentificare si autorizare.
3 Incasare
7 Anulare
1 Creditare
0 Interogare