Operațiuni ulterioare
Când utilizați metoda de integrare Hosted Session, procesul de plată pentru o nouă comandă începe cu o tranzacție inițială, cel mai adesea o tranzacție PAY sau AUTHORIZE. Pentru o listă completă a tranzacțiilor inițiale disponibile, consultați Tranzacții.
Tranzacția inițială definește toate informațiile importante pentru comandă și include:
- Detalii despre comanda în sine, cum ar fi ID-ul, suma și moneda.
- Metodă de plată care va fi folosită pentru plată.
- Detalii de plată ale plătitorului.
Dacă utilizați o tranzacție PAY și plătitorul primește bunurile comandate și este mulțumit de ele, comanda este finalizată și nu sunt necesare alte acțiuni. Cu toate acestea, în multe scenarii pot fi necesare tranzacții ulterioare pentru a gestiona ciclul de viață rămas al comenzii.
Scenariile ulterioare
Următoarele scenarii sunt exemple de situații în care trebuie să trimiteți tranzacții ulterioare pentru comanda dvs. existentă:
- Dacă utilizați o tranzacție
VERIFY, adesea creată cu valoarea comenzii setată la zero, ca tranzacție inițială pentru a verifica detaliile contului plătitorului, trebuie să continuați cu o tranzacțiePAYsauAUTHORIZEpentru a defini valoarea corectă a comenzii și a iniția transferul de bani. - Dacă utilizați o tranzacție
AUTHORIZEca tranzacție inițială, trebuie să continuați cu o tranzacțieCAPTURE, atunci când sunteți gata să expediați mărfurile și doriți ca banii să fie transferați. Dacă există o întârziere în capacitatea dvs. de a expedia mărfurile, poate fi necesar să utilizați tranzacțiaUPDATE AUTHORIZATIONpentru a menține autorizația activă până când sunteți gata să o decontați. - Dacă comanda este anulată din orice motiv, trebuie să utilizați tranzacția
VOIDpentru a o anula imediat și pe gateway. Dacă detaliile de plată au fost deja trimise băncii, trebuie să utilizați tranzacțiaVOIDpentru a o anula imediat și pe gateway. Dacă detaliile de plată au fost deja trimise băncii, trebuie să utilizați tranzacțiaREFUND, care este necesară și dacă plătitorul nu este mulțumit de achiziția sa și dorește să o returneze. În cazul rar în care tranzacția eșuează deoarece achizitorul necesită o autorizare suplimentară, puteți utiliza o tranzacțieREFUND, care este necesară și dacă plătitorul nu este mulțumit de achiziția sa și dorește să o returneze. În cazul rar în care tranzacția eșuează deoarece achizitorul necesită o autorizare suplimentară, puteți utiliza o tranzacțieREFERRALpentru a reîncerca operațiunea de plată cu detaliile suplimentare necesare.
Operațiunile API RETRIEVE TRANSACTION și RETRIEVE ORDER pot fi, de asemenea, considerate tranzacții ulterioare, deși sunt folosite doar pentru a prelua detaliile unei comenzi existente și nu afectează ciclul de viață al comenzii. Pentru o listă a tuturor tranzacțiilor ulterioare disponibile, consultați Tranzacții.
Asocierea cu tranzacția inițială
Toate tranzacțiile legate de aceeași comandă trebuie să fie asociate, astfel încât diferitele sisteme de plată precum eGenius Platform și băncile să le poată identifica ca fiind cele care aparțin împreună. Conectarea se face prin utilizarea aceleiași order ID în fiecare tranzacție legată de comandă. order ID este furnizat ca parametru de cale în adresa URL a solicitării.
Date partajate în tranzacțiile ulterioare
Asocierea diferitelor tranzacții în cadrul aceleiași comenzi înseamnă că trebuie să furnizați o singură dată date specifice despre comandă. Gateway-ul stochează detaliile comenzii și le poate folosi după cum este necesar, atunci când procesează orice tranzacții ulterioare.
În orice tranzacție ulterioară, trebuie să furnizați doar datele specifice tranzacției respective. De exemplu:
- Într-o tranzacție
CAPTURE, furnizați suma și moneda pentru mărfurile pe care le expediați în acel moment, care poate fi valoarea totală sau parțială a comenzii. - Într-o tranzacție
REFUND, furnizați suma și moneda pentru rambursarea pe care o trimiteți, care poate fi valoarea totală sau parțială a comenzii. - Într-o tranzacție
VOID, furnizați ID-ul tranzacției pe care doriți să o anulați. - Într-o tranzacție
REFERRAL, furnizați codul de autorizare care permite emitentului să aprobe tranzacția eșuată anterior.
Dacă furnizați informații identice în mai multe tranzacții dintr-o comandă, gateway-ul le ignoră. Dacă actualizați orice informație într-o tranzacție ulterioară, gateway-ul actualizează detaliile comenzii în consecință. De exemplu, ați furnizat mai întâi o adresă de expediere în tranzacția AUTHORIZE inițială, iar plătitorul se mută. Apoi, puteți adăuga o nouă adresă de expediere la tranzacția CAPTURE.