Instant Transaction Status Notification (ITSN)

De la PlatiOnline
Salt la: navigare, căutare

Setarea modului de primire a notificarilor de schimbare a starii tranzactiilor

Ofera posibilitatea comerciantului sa specifice un URL sau o adresa web la care sistemul PlatiOnline va trimite notificarea de modificare a starii unei tranzactii.


ATENTIE: Systemul ITSN doar notifica schimbarea starii tranzactiei si NU specifica ce stare are acum tranzactia. Pentru a prelua starea tranzactiei la momentul respectiv trebuie sa rulati Operatia de Interogare.


In interfata https://comercianti.plationline.ro parcurgeti urmatorii pasi:

  • Selectati link-ul “Setari”;
  • Selectati link-ul “ITSN”;
  • Faceti click in interiorul casutei URL-ului;
  • Introduceti URL-ul sau adresa de web pentru raspuns;
  • Apasati butonul “Salveaza modificarile”.

Notificarile ISTN de la serverul PO sunt trimise automat in momentul in care starea tranzactiei se modifica.


Pentru programatorii care implementeaza serviciul ITSN in interfata de comercianti pe fisa tranzactilor au disponibil un buton "Test ITSN" care va executa o notitificare ITSN catre URL-ul setat si prin metoda selectata.

ITSN ver 3.x systemul PlatiOnline trimite

Denumire Parametru Tipul de data Descriere
F_MESSAGE_ITSN Varchar(250) Secventa de valori concatenate cu caracterul ^ (accent circumflex):
  • numar random 3 cifre;
  • Login_ID (=F_login);
  • Stamp (=Data si ora server web);
  • F_Amount;
  • F_Currency;
  • PO Transaction ID (=X_Trans_ID);
  • Order Number (=F_Order_Number).

ATENTIE: Valorile concatenate trebuie sa fie identice cu valorile din campuri corespondente.

F_CRYPT_MESSAGE_ITSN Varchar(250) Rezultatul incriptarii campului F_MESSAGE_ITSN.
X_TRANS_ID bigint 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 Varchar(50) Numarul comenzii din sistemul comerciantului.

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

F_AMOUNT Money Suma tranzactiei.
F_CURRENCY Char(3) Moneda tranzactiei.

(RON, USD, EUR)

Raspunsul la ITSN

PlatiOnline face POST sau GET la URL-ul salvat in setari si asteapta sa primeasca raspunsul de la serverul comerciantului in format XML. Dupa ce procesasti cererea ITSN, trimiteti catre PlatiOnline raspunsul in urmatorul format XML:

<?xml version="1.0" encoding="UTF-8" ?>
  <itsn>
    <x_trans_id></x_trans_id>
    <merchServerStamp></merchServerStamp>
    <f_response_code></f_response_code>
  </itsn>


Tag XML Tipul de data Descriere
x_trans_id bigint 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.

merchServerStamp Datetime Data si ora serverului comerciantului.
f_response_code boolean
  • Valoare=1 daca cerera ITSN a fost inregistratat si prelucrata cu succes;
  • Valoare=0 daca cererea ITSN nu a putut fi inregistrata sau prelucrata cu succes.

ATENTIE: Cand raspundeti cu 0 systemul PO va retrimite automat cererea ITSN la interval de 5 minute repetat, pana la maxim 72 de ore de la prima notificare.