Integration Types
Alte caracteristici
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Pentru trimiterea securizată a corpului solicitării de tranzacție către eGenius Platform, sunt necesare mai multe elemente. Această secțiune tratează conceptele și funcțiile esențiale care pot fi necesare pentru integrarea dvs.
Fișierul de lot este trimis prin intermediul HTTP, folosind protocolul Secure Socket Layer (SSL) și metoda HTTP PUT. Această secțiune conține exemple de fragmente de cod, scrise în limbajul de scripturi pentru shell. Pentru exemplul de cod de integrare, consultați secțiunea Descărcări.
Adresa URL de conexiune conține informații care identifică versiunea Batch (la fel ca versiunea API), identificatorul comerciantului și numele lotului.
https://egenius.unicredit.ro/batch/version/<versionNum>/merchant/<merchantId>/batch/<batchName>
unde:
# Configuration: Batch application
VERSION_NUM=72
HB_HOST="https://egenius.unicredit.ro/batch"; # Configuration: Merchant MERCHANT_ID="<YOUR_MERCHANT_ID>"
MERCHANT_PASSWORD="<YOUR_MERCHANT_PASSWORD>" CONNECT_URL="$HB_HOST/version/$VERSION_NUM/merchant/$MERCHANT_ID/batch/"
Dacă trimiteți o solicitare pentru lot cu o adresă URL formatată incorect, veți fi redirecționat către o pagină de retur care afișează informații despre modul cum trebuie formatată o solicitare.
https://egenius.unicredit.ro/batch
eGenius Platform necesită ca fiecare solicitare de lot să fie autentificată cu succes. Fragmentul de cod de mai jos acoperă modul de furnizare a datelor de autentificare (ID comerciant și Parolă API) pentru fiecare solicitare pentru lot.
Acest fragment de cod vă prezintă modul de setare a acreditărilor în program.
# Configuration: Batch application
VERSION_NUM=72
HB_HOST="https://egenius.unicredit.ro/batch"; # Configuration: Merchant
MERCHANT_ID="<YOUR_MERCHANT_ID>"
MERCHANT_PASSWORD="<YOUR_MERCHANT_PASSWORD>" # Configuration: Advanced
CONNECT_URL="$HB_HOST/version/$VERSION_NUM/merchant/$MERCHANT_ID/batch/"
HTTP_HEADERS="Authorization: Basic `echo -n :$MERCHANT_PASSWORD | base64`"$'\n'" Content-Type: text/plain; charset=UTF-8"
Anteturile HTTP furnizează informații aferente metadatelor despre solicitarea de lot trimisă către eGenius Platform. Acest fragment de cod exemplifică Anteturile HTTP obligatorii, care trebuie să fie setate pentru fiecare solicitare pentru lot (anteturile enumerate aici trebuie setate în plus față de orice anteturi de autentificare menționate în Date de autentificare, acolo unde sunt aplicabile).
Codificarea caracterelor pentru solicitarea dvs. trebuie să includă numai formatele ISO-8859-1(Latin1) sau UTF-8. Consultați secțiunea Asigurare codificare caractere.
Acest fragment de cod vă prezintă modul de setare a anteturilor HTTP în program.
HTTP_HEADERS="Authorization: Basic `echo -n :$MERCHANT_PASSWORD | base64`"$'\n' "Content-Type: text/plain; charset=UTF-8"
Batch necesită confirmarea integrității loturilor încărcate prin furnizarea unui cod de integritate mesaj (MIC) în vederea validării. Codul MIC trebuie calculat prin crearea rezumatului SHA-1 al întregului corp al solicitării de încărcare, care conține datele de lot CSV NVP și trebuie să fie codificat HEX.
Încărcarea codului MIC funcționează după cum urmează:
unde: