- Ghid de integrare
- Implementarea unei integrări Batch
- Trimitere solicitare pentru lot
Trimitere solicitare pentru lot
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.
Încărcarea solicitărilor de lot
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
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:
- <versionNum> este versiunea Batch
- <merchantId> este identificatorul dvs. comerciant
- <batchName> este numele dvs. unic pentru lot
# 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
Date de autentificare
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"
Anteturi HTTP
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"
Încărcarea codului de integritate a mesajului
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ă:
- Încărcați un lot către serviciul Batch.
- Încărcați codul MIC către serviciul Batch, transmițând o solicitare HTTPS POST către următoarea adresă URL având codul MIC codificat HEX în corpul solicitării.
- <versionNum> este versiunea Batch
- <merchantId> este identificatorul dvs. comerciant
- <batchName> este numele dvs. unic pentru lot
- Batch validează codul MIC furnizat pe baza lotului încărcat și dacă acesta corespunde, lotul va fi acceptat pentru procesare. În cazul în care codul MIC nu corespunde, se presupune că lotul este corupt. Lotul va fi șters și veți fi nevoit să-l încărcați din nou.
Unde: