Cunoașterea câmpurilor de introducere date

Înainte de realizarea unei tranzacții de testare, trebuie să aveți pregătite valori pentru câmpurile care necesită introducerea de date de către dvs. Indiferent de metoda pe care o alegeți pentru a genera aceste valori, manuală sau de generare automată pe baza unui script, existența unor valori corespunzătoare pentru aceste câmpuri poate simplifica procesul de administrare a comenzilor și tranzacțiilor, în mod special regăsirea tranzacțiilor pierdute.

Identificatori și referințe de tranzacție/comandă

Pentru mai multe informații despre tipurile câmpurilor, regulile de validare și ce operațiuni necesită următoarele câmpuri, consultați Referință API.

[Obligatoriu] Identificator comandă

Identificatorul unic pentru o comandă (inclus în adresa URL pentru REST), care distinge comanda de oricare alte comenzi pe care dvs. le creați. Acest câmp este obligatoriu și trebuie să fie unic pentru fiecare comandă pe care o creați în cadrul profilului dvs. comerciant. Când încercați să realizați o tranzacție ulterioară pentru o comandă, de exemplu, Refund, Capture sau Void trebuie să furnizați ID comandă corespunzător comenzii Authorization sau Pay inițiale.

Reutilizarea Identificator comandă

Începând cu versiunea v15 API în continuare, dacă tranzacția inițială pentru o comandă eșuează, puteți trimite o altă tranzacție inițială pentru această comandă fără a trebui să creați o comandă nouă. Această caracteristică este utilă în scenariile în care plătitorul dorește să încerce din nou o tranzacție eșuată cu detalii de plată diferite, de exemplu, un card de credit diferit sau o metodă alternativă de plată (PayPal).

Referință API ID comandă[REST][NVP]

[Obligatoriu] Identificator de tranzacție

Identificatorul pentru o tranzacție (inclus în adresa URL pentru REST), care distinge tranzacția de alte tranzacții din cadrul acestei comenzi. Acest câmp este obligatoriu și trebuie să fie unic pentru tranzacțiile pe care le creați în cadrul unei comenzi. Un ID tranzacție unic este util pentru colectarea tranzacțiilor la un moment ulterior. Totuși, un ID tranzacție trebuie să fie întotdeauna calificat cu ID comandă pentru a realiza cu succes o operațiune de colectare.

ID tranzacție este afișat în pagina Detalii tranzacție financiară în Administrare cont comerciant ca ID tranzacție.

Referință API Identificator tranzacție[REST][NVP]

[Opțional] Referință comandă

Un identificator opțional utilizat pentru a furniza un identificator semnificativ pe baza informațiilor de afacere în cadrul eGenius Platform. De exemplu, un număr de coș de cumpărături, un număr de comandă sau un număr de factură. Referință comandă poate fi utilizată ca un criteriu de căutare în Administrare cont comerciant.

Valoarea pentru câmpul Referință comandă este obligatoriu să fie unică numai dacă pentru profilul dvs. comerciant este activat dreptul "Impunere Referință unică comandă".

Referință API Referință comandă[REST][NVP]

[Opțional] Referință tranzacție

Un identificator opțional pentru identificarea tranzacției în cadrul eGenius Platform. Această valoare este setată la nivelul tranzacției și nu are nici un fel de restricție de unicitate pentru a putea fi utilizată conform necesităților dvs. Puteți căuta o tranzacție utilizând acest câmp în Administrare cont comerciant.

Valoarea pentru câmpul Referință tranzacție este obligatoriu să fie unică numai dacă pentru profilul dvs. comerciant este activat dreptul "Impunere referință tranzacție comerciant unică".

Referință API Referință tranzacție[REST][NVP]

[Opțional] ID Corelație

Un identificator temporar utilizat pentru identificare, care poate fi utilizat pentru a corela solicitările dvs. către eGenius Platform cu răspunsurile. Valoarea pe care o furnizați nu persistă în gateway și este returnată în răspunsul la solicitare așa cum este furnizată. Puteți utiliza ID-ul de corelație cu toate solicitările API.

Puteți utiliza această valoare pentru a corela intrările în fișierele de răspuns cu intrările corespunzătoare din fișierele de solicitare, chiar și atunci când răspunsurile sunt returnate într-o ordine diferită de cea a solicitărilor.

Copyright © 2023 UniCredit Bank