API Operatii/Procesare Credit/Debit Card simplu si in rate

De la PlatiOnline
Salt la: navigare, căutare
www.PlatiOnline.ro
Specificatiile interfetei de procesare tranzactii electronice
Toate drepturile rezervate C Solution SRL

Acest document ghideaza comerciantii noi in procesul de implementare a modulelor sistemul Plati Online. Documentul ofera instructiuni de implementare pas cu pas asociate cu exemple de cod. Anexele documentului contin informatii utile cum ar fi tabele cu definitii ale termenilor utilizati des in industria cardurilor, codurile de eroare, codurile de judet si tara, alte informatii.

Operatiile e-commerce

Autorizarea tranzactiilor

Inregistrarea tranzactiilor simple si in rate.
Autorizarea reduce limita creditului disponibil pentru acel card, deoarece fondurile sunt "blocate/rezervate" pentru incasare ulterioara.

Pagina cu informatii despre client, comanda, livrare si platitor

Comerciantii pot alege ca pagina in care se introduc datele despre client, livrare si platitor sa fie pe serverele Plati Online sau sa fie pe propriul server.

Trimiterea datelor despre client, comanda, livrare si platitor direct serverului PO

Pentru operatia de Autorizare trebuie sa trimiteti un set de date obligatorii in sistemul PO.

Setarea modului de primire a raspunsului tranzactiilor de autorizare

Systemul PO ofera posibilitatea comerciantului sa specifice:
- un URL (o adresa web) la care sistemul PlatiOnline va trimite raspunsul;
- modul in care care sistemul PlatiOnline va trimite raspunsul.

Raspunsul la operatia de autorizare

Dupa ce banca emitenta aproba sau refuza autorizarea tranzactiei PlatiOnline va trimite raspunsul catre comerciant.

Utilizarea elementelor grafice in pagina de raspuns

Atunci cand selectati ca mesajul de raspuns sa fie trimis prin metoda 1 serverul PO va face POST la URL-ul specificat, va prelua raspunsul HTML/JavaScript de la serverul comerciantului si il va trimite catre browserul clientului.
In acest mod daca in codul HTML sunt elemente grafice cu URL relativ ele nu vor functiona, si de aceea trebuie sa folositi adrese absolute.
Mai mult, daca adresa absoluta este de forma http:// si nu https://, in functie de browserul utilizat de client, o alerta este posibil sa ii apara pe ecran daca vrea sa incarce si elementele nesecurziate din pagina de raspuns.
Este un motiv in plus sa va recomandam sa utilizati certificate SSL pentru a asigura o experinta placuta clientilor dvs.

Incasarea

Dupa ce comanda autorizata a fost livrata sau serviciul prestat, tranzactia poate fi trimisa spre incasare, operatie suportata de serviciul PlatiOnline.

Incasarea incheie ciclul financiar, suma autorizata este transferata de banca emitenta a cardului din contul clientului in contul comerciantului si face update la extrasul de card al clientului.

Sistemul e-commerce presupune incasarea sumelor dupa expedierea produselor sau prestarea serviciilor. Din acest motiv tranzactiile se executa in doi pasi Autorizarea si apoi Incasarea.

Aceste operatii specifice comertului online sunt separate deoarece dureaza pregatirea, impachetarea si etichetarea comenzilor pana la expediere.

Incasarea 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 Incasare.

Spre deosebire de autorizare, operatia de incasare nu se executa imediat.
Zilnic in anumite momente tranzactiile trimise spre incasare sunt grupate si trimise mai departe bancilor emitente.


Trimiterea datelor pentru incasare direct la serverul PO

Operatia de incasare se poate face prin:

  1. API Incasare HTML POST ( cerere HTML POST la https://secure2.plationline.ro/ );
  2. API Incasare XML SOAP ( cerere XML SOAP la https://secure2.plationline.ro/remote/?action=s cu "Content-Type" = "application/soap+xml; charset=utf-8" ).

Raspunsul la operatia de incasare

Anularea

Cand o tranzactie autorizata nu poate fi livrata sau serviciul nu poate fi prestat, autorizarea trebuie anulata.

Operatia de anulare este suportata de serviciul PlatiOnline.

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.

Trimiterea datelor pentru anulare direct la serverul PO

Operatia de anulare se poate face prin:

  1. API Anulare HTML POST ( cerere HTML POST la https://secure2.plationline.ro/ );
  2. API Anulare XML SOAP ( cerere XML SOAP la https://secure2.plationline.ro/remote/?action=v cu "Content-Type" = "application/soap+xml; charset=utf-8" ).

Raspunsul la operatia de anulare

Creditarea

Atunci cand este necesara inapoierea sumei incasate de pe cardul clientului, ultilizati operatia de creditare.

Operatia de creditare este suportata de serviciul PlatiOnline.

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.


ATENTIE: Din motive de licentiere sistemul PlatiOnline nu permite efectuarea mai multor operatii de creditare pentru o tranzactie incasata.


Creditarea tranzactiilor se face doar pentru cele deja 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.


Trimiterea datelor pentru creditare direct la serverul PO

Operatia de creditare/refund se poate face prin:

  1. API Creditare/Refund HTML POST ( cerere HTML POST la https://secure2.plationline.ro/ );
  2. API Creditare/Refund XML SOAP ( cerere XML SOAP la https://secure2.plationline.ro/remote/?action=r cu "Content-Type" = "application/soap+xml; charset=utf-8" ).

Raspunsul la operatia de creditare

Interogarea

Dupa ce comanda autorizata a fost livrata sau serviciul prestat, tranzactia poate fi trimisa spre incasare, operatie suportata de serviciul PlatiOnline.

Incasarea incheie ciclul financiar, suma autorizata este transferata de banca emitenta a cardului din contul clientului in contul comerciantului si face update la extrasul de card al clientului.

Sistemul e-commerce presupune incasarea sumelor dupa expedierea produselor sau prestarea serviciilor. Din acest motiv tranzactiile se executa in doi pasi Autorizarea si apoi Incasarea.

Aceste operatii specifice comertului online sunt separate deoarece dureaza pregatirea, impachetarea si etichetarea comenzilor pana la expediere.

Incasarea 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 Incasare.

Spre deosebire de autorizare, operatia de incasare nu se executa imediat. Zilnic in anumite momente tranzactiile trimise spre incasare sunt grupate si trimise mai departe bancilor emitente.


Trimiterea datelor pentru interogare direct la serverul PO

Operatia de interogare se poate face prin:

  1. API Interogare HTML POST ( cerere HTML POST la https://secure2.plationline.ro/ );
  2. API Interogare XML SOAP ( cerere XML SOAP la https://secure2.plationline.ro/remote/ cu "Content-Type" = "application/soap+xml; charset=utf-8" ).

Raspunsul la operatia de interogare

Testarea contului de comerciant

Analiza PO si activarea contului