Operațiuni ulterioare
Când utilizați metoda de integrare Hosted Checkout, procesul de plată pentru o nouă comandă începe cu o tranzacție inițială (PAY, AUTHORIZE sau VERIFY).
Tranzacția inițială definește toate informațiile importante pentru comandă:
- Detalii despre comanda în sine (cum ar fi ID, 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ție PAY sau AUTHORIZE pentru a defini valoarea corectă a comenzii și a iniția transferul de bani.
- Dacă utilizați o tranzacție AUTHORIZE ca tranzacție inițială, trebuie să continuați cu o tranzacție CAPTURE 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ția UPDATE AUTHORIZATION pentru 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 VOID pentru a o anula imediat și cu gateway-ul. Dacă detaliile de plată au fost deja trimise băncii, trebuie să utilizați tranzacția REFUND, care este necesară și dacă plătitorul nu este mulțumit de achiziția sa și dorește să o returneze.
Operațiunile API RETRIEVE TRANSACTION și RETRIEVE ORDER pot fi, de asemenea, considerate tranzacții ulterioare, deși sunt utilizate numai 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ă (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ă caz, 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, trebuie să 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, trebuie să 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, trebuie să furnizați ID-ul tranzacției pe care doriți să o anulați.
- Într-o tranzacție REFERRAL, trebuie să 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.