Identificatori
Diferiți identificatori sunt utilizați pentru a reconcilia și a urmări tranzacțiile care se deplasează prin sistemele de plată. Acești identificatori sunt utilizați în raportul de decontare de la achizitorul dvs. pentru a vă ajuta să identificați fiecare tranzacție.
Furnizați identificatori atunci când trimiteți solicitări către eGenius Platform. În mod ideal, același identificator poate fi utilizat în toate sistemele, adică în sistemul dvs. propriu, gateway și achizitorul dvs. Cu toate acestea, diferitele sisteme au cerințe diferite și adesea este nevoie de o combinație de identificatori. Fiecare comandă pe care o creați poate avea trei tipuri diferite de identificatori:
Tipuri de identificatori
Fiecare comandă pe care o creați poate avea trei tipuri diferite de identificatori:
- ID comandă: Acesta este un identificator obligatoriu pe care trebuie să-l definiți ca parte a primei tranzacții pentru fiecare comandă. Valoarea este furnizată în câmpul orderID în corpurile de solicitare și răspuns sau ca parametru de interogare
orderID, în funcție de operație. Valoarea trebuie să fie unică în cadrul tuturor comenzilor trimise din contul dvs. de comerciant, deoarece gateway-ul o folosește pentru a identifica o anumită comandă trimisă de dvs. Pentru comoditate, utilizați o cheie naturală în propriul sistem caorder ID, cum ar fi ID-ul coșului de cumpărături sau numărul facturii. Acest lucru facilitează urmărirea comenzilor între sistemul dvs. și gateway. Deoarece gateway-ul încearcă, de asemenea, să folosească ID-ul comenzii în mesajele achizitorului, atunci când este posibil, toate cele trei sisteme, adică al dvs., gateway-ul și banca dvs. pot fi legate printr-un identificator comun. - Referință comandă: În unele situații, ID-urile de comandă pe care le utilizați în propriul sistem nu pot fi utilizate în gateway, deoarece nu îndeplinesc cerințele gateway-ului. De exemplu, dacă sistemul dvs. utilizează ID-urile de comandă prin rotație și revine la prima valoare atunci când depășește o limită superioară stabilită sau grupează mai multe tranzacții sub o singură comandă, ID-ul comenzii din sistemul dvs. nu funcționează ca un identificator unic în gateway. În acest caz, trebuie să creați un nou identificator unic
order IDpe care să îl utilizați pentru gateway. În plus, puteți furniza o valoare opțională,order.reference, care conține identificatorul pe care îl utilizați în propriul sistem și vă permite să urmăriți comenzile dintre sistemul dvs. și gateway. - Identificator pentru achizitor: Deoarece gateway-ul trebuie să transmită un identificator achizitorului, acesta încearcă să utilizeze
order IDdvs. Cu toate acestea, dacă acest lucru nu este potrivit pentru achizitorul dvs., portalul transformă valoarea în ceva care se potrivește cu cerințele privind lungimea câmpului și formatul achizitorului. Dacă doriți să controlați valoarea pe care portalul o oferă achizitorului, puteți furniza o valoare transaction.acquirer.transactionId în solicitare. Cu toate acestea, dacă această valoare nu corespunde cerințelor achizitorului, portalul o transformă și pe aceasta înainte de a o trimite. În ambele cazuri, puteți găsi identificatorul pe care portalul l-a trimis de fapt achizitorului în câmpul transaction.acquirer.transactionId al răspunsului la solicitare. Dacă portalul a trebuit să transforme identificatorul, stocați valoarea răspunsului pentru a putea potrivi detaliile plății achizitorului cu comenzile din sistemul dumneavoastră.
Tranzacții
Pentru a identifica tranzacțiile individuale dintr-o comandă, gateway-ul utilizează ID-uri de tranzacție. Valoarea este furnizată în câmpul transaction.id în corpurile de solicitare și răspuns sau ca parametru de interogare transactionID pentru anumite operațiuni. Dacă sistemul dvs. urmărește tranzacțiile folosind un identificator unic, utilizați-l. În caz contrar, utilizați orice număr secvențial sau aleator, atâta timp cât este unic pentru fiecare tranzacție din cadrul aceleiaşi comenzi.
Pentru a identifica tranzacția la achizitorul cardului, utilizați chitanța. Această valoare este returnată în câmpul transaction.receipt al răspunsului la solicitare; totuși, această valoare poate să nu fie unică.