Instant Transaction Status Notification (ITSN): Diferență între versiuni
Linia 4: | Linia 4: | ||
Ofera posibilitatea comerciantului sa specifice un URL sau o adresa web la care | Ofera posibilitatea comerciantului sa specifice un URL sau o adresa web la care | ||
sistemul PlatiOnline va trimite notificarea de modificare a starii unei tranzactii. | 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 [[Interogarea|Operatia de Interogare]].''' | ||
Linia 16: | Linia 21: | ||
− | ITSN ver 3.x | + | == ITSN ver 3.x systemul PlatiOnline trimite == |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
Linia 44: | Linia 49: | ||
| F_CURRENCY || Char(3)|| Moneda tranzactiei. | | F_CURRENCY || Char(3)|| Moneda tranzactiei. | ||
(RON, USD, EUR) | (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: | ||
+ | |||
+ | <source lang="xml"><?xml version="1.0" encoding="UTF-8" ?> | ||
+ | <itsn> | ||
+ | <x_trans_id></x_trans_id> | ||
+ | <merchServerStamp></merchServerStamp> | ||
+ | <f_response_code></f_response_code> | ||
+ | </itsn> | ||
+ | |||
+ | </source> | ||
+ | |||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! 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.''' | ||
|} | |} |
Versiunea de la data 14 martie 2013 19:39
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. |