Instant Transaction Status Notification (ITSN)
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.
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):
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.
|
merchServerStamp | Datetime | Data si ora serverului comerciantului. |
f_response_code | boolean |
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. |