Există multe aspecte pentru asigurarea faptului că, corpul solicitării de tranzacție este trimis în siguranță către Gateway-ul de plăți. Această secțiune tratează conceptele și funcțiile esențiale care pot fi necesare pentru integrarea dvs.
eGenius PlatformAPI necesită ca fiecare solicitare de tranzacție să fie autentificată cu succes. Fragmentul de cod de mai jos acoperă modul de furnizare a datelor de autentificare (ID comerciant și/sau Parolă API) pentru fiecare tranzacție.
Acest fragment de cod vă prezintă modul de setare a acreditărilor în program.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
Anteturile HTTP furnizează informații aferente metadatelor despre solicitarea de tranzacție trimisă către eGenius Platform. Acest fragment de cod exemplifică Anteturile HTTP obligatorii, care trebuie să fie setate pentru fiecare solicitare de tranzacție (anteturile enumerate aici trebuie setate în plus față de orice anteturi de autentificare menționate în Date de autentificare, acolo unde sunt aplicabile).
Anteturile Content-Length și Content-Type sunt de o importanță critică deoarece ele comunică serverului web dimensiunea în octeți a datelor așteptate și tipul acestora, identificat printr-un tip MIME. Codificarea caracterelor pentru solicitarea dvs. trebuie să includă numai formatele ISO-8859-1 sau UTF-8. Consultați secțiunea Asigurare codificare caractere.
Acest fragment de cod vă prezintă modul de setare a anteturilor HTTP în program.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
În funcție de opțiunile de protocol și integrare selectate, este posibil să trebuiască să utilizați o metodă HTTP specifică pentru fiecare tranzacție. Toate operațiunile de bază realizate prin intermediul eGenius PlatformAPI utilizează metoda HTTP PUT cu protocolul REST (cu excepția operațiunilor Retrieve și CheckGateway); și metoda HTTP POST cu protocolul NVP.
Cu protocolul REST, metoda HTTP PUT actualizează componenta adresată a colecției; sau dacă nu există, creează o nouă componentă. De exemplu, dacă Request-URI este http://example.com/version/v1/merchant/m1/order/o1/transaction/t1, unde t1 este o componentă a resursei colecție o1, atunci dacă t1 există, solicitarea modifică resursa t1, în caz contrar creează o nouă componentă t1. Metoda HTTP GET colectează o reprezentare a componentei adresate a colecției. De exemplu, dacă Request-URI este http://example.com/version/v1/merchant/m1/order/o1/transaction/t1, atunci metoda GET colectează t1.
Cu protocolul NVP, metoda HTTP POST este utilizată pentru toate operațiunile de tranzacție.
Acest fragment de cod vă prezintă modul de utilizare a metodei HTTP POST.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
Acest fragment de cod vă prezintă modul de utilizare a metodei HTTP PUT.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
Adresa URL utilizată pentru trimiterea solicitării dvs. de tranzacție poate să se modifice pentru fiecare solicitare de tranzacție:
Acest fragment de cod vă prezintă modul de configurare a adresei URL pentru operațiunea Solicitare de tranzacție.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
Fragmentul de cod vă prezintă modul de setare a adresei URL pentru trimiterea unei tranzacții.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
Pentru a preveni atacurile rău voitoare precum și alte probleme potențiale de securitate, este de o importanță critică să realizați validarea certificatului SSL al eGenius Platform când trimiteți solicitarea de tranzacție. Fragmentele de cod de mai jos sunt de o importanță critică pentru asigurarea transmisiei sigure a solicitării dvs. de tranzacție.
Acest fragment de cod vă prezintă modul de verificare a certificatului SSL.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
În unele medii de rețea este posibil să fie necesară trimiterea solicitării de tranzacție prin intermediul unui server proxy. Aceasta este opțională și trebuie să consultați administratorul dvs. de rețea sau furnizorul de servicii de găzduire web pentru informații referitoare la relevanța acesteia pentru integrarea dvs.
Acest fragment de cod vă prezintă modul de setare a unui server proxy și autentificarea pentru acesta.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod
Ca un ultim pas, trebuie să trimiteți solicitarea de tranzacție formatată corect către eGenius Platform și să așteptați un răspuns.
Acest fragment de cod vă prezintă modul de trimitere a tranzacției către eGenius Platform.
Selectați Protocolul și Limbajul pentru vizualizarea fragmentului de cod.
Din: Descărcare exemplu de cod