Creare solicitare pentru lot
Crearea solicitării pentru lot este un pas critic pentru integrarea comerciantului. O solicitare de lot constă dintr-un fișier de lot în format nativ, pe care serviciul Batch îl acceptă și îl trimite către adresa URL eGenius PlatformBatch prin HTTPS PUT.
Formatul nativ este definit după cum urmează:
-
Antetul HTTP trebuie să specifice autentificarea de bază și include parola pentru integrare codificată base64.
- Codificarea caracterelor pentru solicitarea dvs. trebuie să includă numai formatele ISO-8859-1(Latin1) sau UTF-8. Consultați secțiunea Asigurare codificare caractere.
- Fișierele de lot trebuie să fie furnizate în format CSV delimitat prin virgule și să ia în calcul următoarele restricții de procesare:
- Nu trebuie incluse comentarii, deoarece acestea nu sunt acceptate.
- Valorile nu sunt curățate de spațiile prefix sau sufix.
- Virgulele din cadrul valorilor câmpurilor trebuie să fie tratate prin încadrarea valorilor între ghilimele.
- Ghilimelele duble din cadrul valorilor câmpurilor trebuie manipulate prin încercuirea valorilor între ghilimele, și apoi reprezentarea printr-o pereche de ghilimele duble.
- Există o lungime maximă a valorilor de 100.000 de caractere pe rând.
- Fiecare fișier de lot trebuie să conțină o singură linie de antet cu valori care corespund numelor de câmpuri din protocolul NVP API. Consultați secțiunea Referință NVP.
- Câmpurile din fișierul de date trebuie să se conformeze regulilor de validare API (lungime și format câmp, obligativitate, unicitate etc.).
- Înregistrările pentru toate tipurile de tranzacție (autorizare, achiziție, decontare, rambursare, anulare) pot fi furnizate în același fișier. Trebuie să vă asigurați, însă, că tipurile de tranzacții NU sunt asociate aceleiași comenzi, respectiv nu conțin același identificator de comandă. Pentru mai multe informații, consultați secțiunea Bune practici și sfaturi.
Exemplul de mai jos prezintă un fișier de intrare de lot de testare pentru un comerciant care utilizează parolă ca mecanism de autentificare pentru conectarea la eGenius Platform.
apiOperation,order.id,order.currency,transaction.id,transaction.amount,transaction.currency,sourceOfFunds.type,sourceOfFunds.provided.card.number,sourceOfFunds.provided.card.expiry.month,sourceOfFunds.provided.card.expiry.year,response.gatewayCode,result,error.cause,error.explanation,error.field,error.supportCode,error.validationType
PAY,921830104177,TXID1,30,AUD,CARD,5123456789012346,05,17,,,,,
PAY,921830104178,TXID1,100,AUD,CARD,5123456789012346,05,17,,,,,
PAY,921830104179,TXID1,50,AUD,CARD,4987654321098769,05,17,,,,,
PAY,921830104180,TXID1,90,AUD,CARD,4987654321098769,05,17,,,,,
PAY,921830104181,TXID1,45,AUD,CARD,345678901234564,05,17,,,,,
PAY,921830104182,TXID1,75,AUD,CARD,345678901234564,05,17,,,,,
PAY,936742085167,AUD,TX1,30.00,AUD,CARD,5123456xxxxxx346,05,21,,,,
PAY,936742085168,AUD,TX1,35.00,AUD,CARD,5123456xxxxxx346,05,21,,,,
Atât câmpurile pentru solicitare cât și cele de răspuns trebuie definite în solicitarea pentru lot. La pregătirea integrării dvs., ar trebui să analizați parametrii de răspuns pentru fiecare operațiune relevantă în Referința API, pentru a decide ce câmpuri includeți în solicitare. Toate aceste câmpuri furnizează informații prețioase și pe multe dintre acestea ați putea dori să le stocați local în scopuri de contabilitate, reconciliere, depanare și urmărire.
Un exemplu de cod pentru o integrare Batch de bază a fost inclus în mostra de cod. Consultați secțiunea Descărcări.