Formatul campului F Message pentru operatia de AUTORIZARE
Versiunea din 13 martie 2014 18:17, autor: Plati Online (Discuție | contribuții)
Formarea cererii de autorizare/campul F_Message pentru operatia de Autorizare ver 4.x
<po_auth_request>
<f_sequence>
<![CDATA[
Obligatoriu.
Numar random 3 cifre.
Integer.
]]>
</f_sequence>
<f_login>
<![CDATA[
Obligatoriu.
ID-ul Comerciantului in numele caruia se face cererea de autorizare.
Este oferit de PO dupa parcurgerea procesului de inrolare.
ATENTIE!!!
NU ESTE ADRESA DE E-MAIL cu care va conectati la interfata de comerciant.
]]>
</f_login>
<f_website>
<![CDATA[
Obligatoriu.
URL-ul site-ului in numele caruia se face cererea de autorizare.
Este oferit de PO dupa parcurgerea procesului de inrolare.
]]>
</f_website>
<f_test_request>
<![CDATA[
Obligatoriu
Valoare = 1 tranzactia este de test si nu poate va fi Incasata.
Valoare = 0 tranzactia este in Productie.
Maxim 1 cifra.
]]>
</f_test_request>
<f_timestamp>
<![CDATA[
Obligatoriu.
Formatul: YYYY-MM-DDThh:mm:ss
Date time in formatul ISO 8601.
http://en.wikipedia.org/wiki/ISO_8601
]]>
</f_timestamp>
<f_action>
<![CDATA[
Obligatoriu
Valoare = 2 Cerere de Autorizare Card Mastercard/Visa fara rate
Valoare = 10 Cerere de Autorizare in RATE
Maxim 2 cifre.
]]>
</f_action>
<f_order_number>
<![CDATA[
Obligatoriu.
Maxim 50 char
]]>
</f_order_number>
<f_amount>
<![CDATA[
Obligatoriu.
Suma autorizata.
Cu "punct" ca delimitator si 2 zecimale dupa delimitator.
Maxim 8 char.
]]>
</f_amount>
<f_currency>
<![CDATA[
Obligatoriu.
Moneda in care se face tranzactia.
Valori acceptate: RON sau USD sau EUR
Maxim 3 char.
]]>
</f_currency>
<f_auth_minutes>
<![CDATA[
Obligatoriu.
Durata maxima in minute per F_Order_Number in care utilizatorul trebuie sa finalizeze operatia de Autorizare.
Daca Autorizarea se finalizeaza dupa acest interval de timp tranzactia Autorizata se anuleaza.
Integer.
Valoare = 0 Nu conteaza cand se Autorizeaza. Comerciantul asteapta oricat.
]]>
</f_auth_minutes>
<f_language>
<![CDATA[
Obligatoriu.
Sistemul PO este multilingv, iar acest parametru stabileste limba utilizata.
Valori accepate: ro, en, de, es, it, hu.
Maxim 2 char.
]]>
</f_language>
<customer_info>
<contact>
<f_email>
<![CDATA[
Obligatoriu.
Adresa de e-mail a clientului.
Maxim 50 char.
]]>
</f_email>
<f_phone>
<![CDATA[
Obligatoriu.
Numarul de telefon al clientului.
Maxim 20 char.
]]>
</f_phone>
<f_mobile_number>
<![CDATA[
Obligatoriu daca clientul doreste sa primeasca notificare SMS cand starea tranzactiei se modifica.
Numarul de telefon mobile al clientului.
Maxim 20 char.
]]>
</f_mobile_number>
<f_send_sms>
<![CDATA[
Optional.
Valoare = 1 Clientul doreste sa primeasca notificare SMS cand starea tranzactiei se modifica. Notificarea se trimite pe nr de mobil trecut la tagul <f_mobile_number> din sectiunea <customer_info>.
Valoare = 0 Systemul PO nu trimite SMS.
Optiunea este valida doar daca comerciantul are optiunea activata pe contul de comerciant.
Maxim 1 cifra.
]]>
</f_send_sms>
<f_first_name>
<![CDATA[
Obligatoriu.
Prenumele clientului.
Maxim 50 char.
]]>
</f_first_name>
<f_last_name>
<![CDATA[
Obligatoriu.
Numele clientului.
Maxim 50 char.
]]>
</f_last_name>
<f_middle_name>
<![CDATA[
Obligatoriu.
Al doilea nume al clientului.
Maxim 50 char.
]]>
</f_middle_name>
</contact>
<invoice>
<f_company>
<![CDATA[
Compania client care achizitioneaza bunurile/produsele.
Cardul utilizat este emis pe persoana juridica.
Maxim 50 char.
]]>
</f_company>
<f_cui>
<![CDATA[
Codul unic de inregistrare al companiei client.
Maxim 50 char.
]]>
</f_cui>
<f_reg_com>
<![CDATA[
Nr. de inregistrare la Registrul Comertului al companiei client.
Maxim 50 char.
]]>
</f_reg_com>
<f_cnp>
<![CDATA[
Codul numeric personal al clientului.
Maxim 50 char.
]]>
</f_cnp>
<f_zip>
<![CDATA[
Obligatoriu.
Codul postal al adresei clientului.
Maxim 50 char.
]]>
</f_zip>
<f_country>
<![CDATA[
Obligatoriu.
Tara de resedinta a clientului.
Maxim 50 char.
]]>
</f_country>
<f_state>
<![CDATA[
Obligatoriu.
Judetul/Statul/Provincia clientului.
Maxim 50 char.
]]>
</f_state>
<f_city>
<![CDATA[
Obligatoriu.
Orasul clientului.
Maxim 50 char.
]]>
</f_city>
<f_address>
<![CDATA[
Obligatoriu.
Strada si numarul adresei clientului.
Maxim 50 char.
]]>
</f_address>
</invoice>
</customer_info>
<shipping_info>
<same_info_as>
<![CDATA[
Obligatoriu
Valoare = 0 Info diferite
Valoare = 1 Aceleasi date cu cele de la <customer_info>
Maxim 1 cifra.
]]>
</same_info_as>
<contact>
<f_phone>
<![CDATA[
Numarul de telefon al persoanei care primeste comanda.
Maxim 20 char.
]]>
</f_phone>
<f_mobile_number>
<![CDATA[
Obligatoriu daca clientul doreste ca persoana care primeste comanda sa primeasca notificare SMS inainte de livrare.
Numarul de telefon mobile al persoanei care primeste comanda.
Maxim 20 char.
]]>
</f_mobile_number>
<f_send_sms>
<![CDATA[
Optional.
Valoare = 1 Clientul doreste ca persoana care primeste comanda sa primeasca notificare SMS inainte de livrare. Notificarea se trimite pe nr de mobil trecut la tagul <f_mobile_number> sectiunea <shipping_info>.
Valoare = 0 Systemul PO nu trimite SMS.
Optiunea este valida doar daca comerciantul are optiunea activata pe contul de comerciant.
Maxim 1 cifra.
]]>
</f_send_sms>
<f_first_name>
<![CDATA[
Prenumele persoanei la care se face livrarea.
Maxim 50 char.
]]>
</f_first_name>
<f_last_name>
<![CDATA[
Numele persoanei la care se face livrarea.
Maxim 50 char.
]]>
</f_last_name>
<f_middle_name>
<![CDATA[
Al doilea nume al clientului.
Maxim 50 char.
]]>
</f_middle_name>
</contact>
<address>
<f_company>
<![CDATA[
Compania la care se face livrarea.
Maxim 50 char.
]]>
</f_company>
<f_zip>
<![CDATA[
Codul postal al adresei la care se face livrarea.
Maxim 50 char.
]]>
</f_zip>
<f_country>
<![CDATA[
Tara in care se face livrarea.
Maxim 50 char.
]]>
</f_country>
<f_state>
<![CDATA[
Judetul/Statul/Provincia in care se face livrarea.
Maxim 50 char.
]]>
</f_state>
<f_city>
<![CDATA[
Orasul in care se face livrarea.
Maxim 50 char.
]]>
</f_city>
<f_address>
<![CDATA[
Strada si numarul la care se face livrarea.
Maxim 50 char.
]]>
</f_address>
</address>
</shipping_info>
<card_holder_info>
<same_info_as>
<![CDATA[
Obligatoriu
Valoare = 0 info diferite
Valoare = 1 Aceleasi date cu cele de la <customer_info>
Valoare = 2 Aceleasi date cu cele de la <shipping_info>
Maxim 1 cifra.
]]>
</same_info_as>
<contact>
<f_email>
<![CDATA[
Obligatoriu.
Adresa de e-mail a posesorului de card.
Maxim 50 char.
]]>
</f_email>
<f_phone>
<![CDATA[
Numarul de telefon al posesorului de card.
Maxim 20 char.
]]>
</f_phone>
<f_mobile_number>
<![CDATA[
Obligatoriu daca posesorului de card doreste sa primeasca notificare SMS cand starea tranzactie se modifica.
Numarul de telefon mobile al posesorului de card.
Maxim 20 char.
]]>
</f_mobile_number>
<f_send_sms>
<![CDATA[
Optional.
Valoare = 1 Posesorului de card doreste sa primeasca notificare SMS cand starea tranzactie se modifica. Notificarea se trimite pe nr de mobil trecut la tagul <f_mobile_number> sectiunea <card_holder_info>
Valoare = 0 Systemul PO nu trimite SMS.
Optiunea este valida doar daca comerciantul are optiunea activata pe contul de comerciant.
Maxim 1 cifra.
]]>
</f_send_sms>
<f_first_name>
<![CDATA[
Obligatoriu.
Prenumele posesorului de card.
Maxim 50 char.
]]>
</f_first_name>
<f_last_name>
<![CDATA[
Obligatoriu.
Numele posesorului de card.
Maxim 50 char.
]]>
</f_last_name>
<f_middle_name>
<![CDATA[
Al doilea nume al posesorului de card.
Maxim 50 char.
]]>
</f_middle_name>
</contact>
<address>
<f_company>
<![CDATA[
Obligatoriu daca cardul utilizat este inregistrat pe numele companiei.
Compania posesorului de card.
Maxim 50 char.
]]>
</f_company>
<f_zip>
<![CDATA[
Obligatoriu.
Codul postal al posesorului de card.
Maxim 50 char.
]]>
</f_zip>
<f_country>
<![CDATA[
Obligatoriu.
Tara posesorului de card.
Maxim 50 char.
]]>
</f_country>
<f_state>
<![CDATA[
Obligatoriu.
Judetul/Statul/Provincia posesorului de card.
Maxim 50 char.
]]>
</f_state>
<f_city>
<![CDATA[
Obligatoriu.
Orasul posesorului de card.
Maxim 50 char.
]]>
</f_city>
<f_address>
<![CDATA[
Obligatoriu.
Strada si numarul strazii posesorului de card.
Maxim 50 char.
]]>
</f_address>
</address>
</card_holder_info>
<transaction_relay_response>
<f_relay_response_url>
<![CDATA[
Adresa URL unde systemul PO va trimite rezultatul operatiei de autorizare.
http://url/page?parametru=urlencode(value)
Maxim 200 char.
]]>
</f_relay_response_url>
<f_relay_method>
<![CDATA[
Metoda prin care se trimite rezultatul operatiei de autorizare.
Valoarea = GET (Redirect PlatiOnline Server - Client Internet Browser - Merchant Server) - NERECOMANDATA daca comerciantului detine certificat SSL
Valoarea = POST_S2S_PO_PAGE (Direct PlatiOnline Server - Merchant Server) - PlatiOnline HTML Template
Valoarea = POST_S2S_MT_PAGE (Direct PlatiOnline Server - Merchant Server) - Merchant HTML Template
Valoarea = PTOR (JavaScript PlatiOnline Server - Client Internet Browser - Merchant Server) - NERECOMANDATA daca comerciantului detine certificat SSL
Valoarea = SOAP_PO_PAGE (Direct PlatiOnline Server - Merchant Server) - PlatiOnline HTML Template
Maxim 16 char.
]]>
</f_relay_method>
<f_relay_handshake>
Metoda prin care se confirma procesarea raspunsului.
Valoarea = 1 - merchantul va confirma procesarea raspunsului tranzatiei prin adaugarea
unui HTTP Header: PO_Transaction_Response_Processing = true/false/retry (only 3 retry after 3 seconds)
Valoarea = 0 - merchanul nu doreste sa raspunda cu rezultatul procesarii tranzactiei.
Maxim 2 char.
Defaul value: OFF.
]]>
</f_relay_method>
<f_post_declined>
<![CDATA[
Daca comerciantul doreste sa primeasca raspunsul cand rezultatul este DECLINE
Valoarea = 1 (default value; systemul PO trimite rezultatul la f_relay_response_url prin metoda f_relay_method)
Valoarea = 0 (systemul PO trimite rezultatul doar pentru tranzactiile "Autorizate" si "In curs de verificare" la <f_relay_response_url> prin metoda <f_relay_method>)
Maxim 1 cifra.
]]>
</f_post_declined>
</transaction_relay_response>
<tracking_script>
<!-- put here your tracking code -->
<![CDATA[
<script> .... </script>
]]>
</tracking_script>
<f_order_cart>
<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>
<price></price>
<vat></vat>
<pimg></pimg>
</shipping>
</f_order_cart>
</po_auth_request>