Operațiuni ulterioare
Când utilizați metoda de integrare Direct Payment, 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ă:
- 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 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 sau să furnizați serviciul și doriți ca banii să fie transferați. Dacă există o întârziere în capacitatea dvs. de a expedia mărfurile sau de a furniza serviciul, 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. În cazul rar în care tranzacția eșuează deoarece achizitorul necesită o autorizare suplimentară, puteți utiliza o tranzacție REFERRAL pentru a reîncerca operațiunea de plată cu detaliile suplimentare necesare. Operațiunile API RETRIEVE TRANSACTION și RETRIEVE ORDER pot fi, de asemenea, considerate operațiuni API 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 operațiunilor API disponibile, consultați Operațiuni. Pentru o listă a tuturor tranzacțiilor 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 Accertify Payment Gateway ș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 o sumă minimă și moneda pentru mărfurile pe care le expediați în acel moment, care poate fi valoarea totală sau parțială a comenzii. Dacă includeți date suplimentare, de exemplu, date ale companiei aeriene sau date de nivel 1/nivel 2, trebuie să trimiteți date suplimentare. Pentru mai multe informații, consultați secțiunea Date suplimentare.
- Î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.