- Ghid de integrare
- Caracteristici acceptate (Operațiuni de plată)
- Operațiuni tranzacții
Operațiuni tranzacții
Dacă sunteți integrat(ă) pe gateway prin <<webServicesIntegration>>, puteți utiliza operațiunile <<webServicesIntegration>> pentru a procesa tranzacții, a reapela detaliile tranzacțiilor, a stoca detaliile cardurilor etc. Pentru a efectua o operațiune, trebuie să aveți privilegiul corespunzător în profilul dvs. de comerciant de pe gateway. Pentru a verifica operațiile care vă sunt disponibile, contactați your payment service provider.
Operațiunile pentru tranzacțiile inițiale
Această secțiune descrie operațiunile pe care le puteți utiliza pentru a iniția o tranzacție.
Operațiunea Authorize verifică detaliile cardului plătitorului, se asigură că plătitorul are fonduri suficiente în linia de credit și încearcă să rezerve fondurile solicitate. Limita de credit a plătitorului este redusă cu suma autorizată, iar fondurile sunt rezervate pe o perioadă de timp (în majoritatea cazurilor, 5–8 zile), în funcție de schema cardului și regulile de emitere a cardului plătitorului.
Autorizarea nu debitează fonduri din contul plătitorului, dar rezervă întreaga valoare a comenzii, pregătită pentru operațiunea Capture prin care se debitează cardul și se transferă fondurile în contul dvs. În extrasul de cont al plătitorului nu apar tranzacțiile Authorize, ci numai tranzacțiile Capture.
Pentru efectuarea cu succes a autorizării, gateway-ul returnează valoarea result=SUCCESS în răspunsul la tranzacție. Puteți utiliza Authorize ca operațiune ulterioară doar dacă tranzacția inițială este Verify și dacă detaliile cardului din solicitarea Authorize și cele din tranzacția Verify corespund.
Operațiunea Authorize mai este denumită, de asemenea, "Auth", "Authorization".
Siguranță comandă
Puteți indica un nivel de certitudine al sumei autorizate, care va fi decontată prin furnizarea câmpului order.certainty în solicitarea Authorize. În acest scop, trebuie să aveți privilegiul „Schimbare certitudine comandă” activat în profilul dvs. de comerciant de către your payment service provider. Puteți seta câmpul la oricare dintre următoarele valori:
- FINAL: Suma autorizată finală va fi, în mod normal, decontată printr-una sau mai multe decontări, în intervalul de timp stabilit (în mod normal, 7 zile). Comanda va fi anulată numai în circumstanțe excepționale (de exemplu, dacă plătitorul își anulează achiziția). Furnizarea acestei valori în tranzacția dvs. poate face ca tranzacția să fie eligibilă pentru comisioane de procesare mai reduse.
- ESTIMATED: Suma autorizată este o estimare a sumei care va fi decontată în intervalul de timp prevăzut (în mod normal, 30–31 de zile). Este posibil ca suma decontată să fie mai mică sau să nu fie decontată deloc, sau ca autorizarea să fie anulată. Furnizarea acestei valori în tranzacția dvs. poate face ca tranzacției să îi fie aplicate comisioane de procesare mai mari.
Solicitarea este respinsă dacă nu aveți privilegiul de a schimba certitudinea comenzii, iar valoarea introdusă în acest câmp nu corespunde valorii implicite a certitudinii comenzii, configurată în profilul dvs. de comerciant.
Referință API Authorize [REST][NVP]
Anulările autorizărilor
Gateway-ul poate inversa automat sumele autorizate neplătite pentru autorizări nedecontate, decontate parțial sau expirate, dacă acest lucru este acceptat pentru achizitor. Acest lucru vă permite să respectați cerințele schemei de card pentru anulările complete și parțiale.
Autorizări nedecontate
Dacă nu doriți să decontați suma autorizată rămasă după trimiterea unei solicitări Authorize, trebuie să anulați autorizarea trimițând o solicitare VOID. Furnizați ID-ul de tranzacție pentru autorizarea care trebuie anulată în câmpul transaction.targetTransactionId.
Autorizări decontate parțial
Atunci când trimiteți o solicitare Capture pentru o comandă, puteți introduce o sumă Capture mai mică decât suma autorizată pentru comandă (order.AuthorizedAmount). Dacă nu intenționați să decontați suma autorizată rămasă, puteți anula suma autorizată neplătită dacă achizitorul acceptă acest lucru.
Puteți încerca să anulați/revocați suma autorizată neplătită în două moduri:
- Trimiteți o solicitare VOID cu ID-ul de tranzacție pentru autorizarea care trebuie anulată în câmpul
transaction.targetTransactionId. - Introduceți numărul prevăzut de operațiuni Capture pentru comandă în câmpul
order.expectedNumberOfCapturesdin solicitarea Capture sau prin Merchant Administration. În cazul în care numărul total de decontări pentru comandă (inclusiv decontarea curentă) este mai mare sau egal cu numărul total prevăzut de solicitări Capture, gateway-ul va declanșa automat anularea sumei autorizate neplătite, dacă acest lucru este acceptat pentru achizitor. Pentru a permite acest lucru, trebuie să aveți dreptul „Inversare automată sume autorizate neplătite” activat în profilul dvs. de comerciant de your payment service provider.
De exemplu, dacă introducețiorder.expectedNumberOfCaptures=2 în prima solicitare Capture, gateway-ul va anula automat suma autorizată rămasă după procesarea celei de-a doua solicitări Capture.
Dacă reduceți numărul preconizat de decontări în solicitările Capture ulterioare, respectiv actualizațiorder.expectedNumberOfCaptures=1 în a doua solicitare Capture, gateway-ul va anula automat suma autorizată rămasă la procesarea celei de-a doua solicitări Capture. Aceasta deoarece 2 (numărul total de operațiuni Capture pentru comandă, inclusiv operațiunea Capture curentă) este mai mare decât 1 (numărul preconizat de operațiuni Capture). Dacă, însă, reduceți numărul preconizat de operațiuni Capture în solicitările Capture ulterioare, respectiv actualizațiorder.expectedNumberOfCaptures=3 în a doua solicitare Capture, gateway-ul nu va anula suma autorizată neplătită decât la primirea celei de-a treia solicitări Capture.
order.expectedNumberOfCaptures poate fi trimis numai începând cu versiunea 44 a <<webServicesIntegration>>.Autorizări expirate
Autorizările au o perioadă de valabilitate, după care expiră. Perioada de valabilitate a autorizărilor poate fi configurată în gateway pentru o combinație de achizitor, tip de card și certitudine a comenzii.
Atunci când trimiteți o solicitare Authorize către gateway, acesta determină data și ora de expirare a autorizării pe baza perioadei de valabilitate configurate pentru autorizare (folosind combinația dintre tipul de card, achizitor și certitudinea comenzii). Dacă această funcție este acceptată pentru achizitor, expirarea autorizării este returnată în câmpul authorizationResponse.autoExpiry din răspunsul operațiunii Retrieve Transaction. Acest câmp conține data și ora la care gateway-ul va seta automat expirarea autorizării.
După expirarea perioadei de valabilitate a autorizării, gateway-ul va:
- încerca automat să anuleze autorizarea și să retrimită fondurile la plătitor (dacă această funcție este acceptată pentru achizitor). Pentru a permite acest lucru, trebuie să aveți dreptul „Inversare automată autorizări expirate” activat în profilul dvs. de comerciant de your payment service provider.
În cazul în care comanda a fost deja decontată parțial și dacă achizitorul acceptă anularea autorizărilor pentru decontări parțiale, gateway-ul va încerca să anuleze/să inverseze suma autorizată decontată.
- respinge orice solicitări Capture bazate pe comandă
Actualizările autorizărilor
Gateway-ul vă permite să extindeți valabilitatea autorizării și să măriți sau să micșorați opțional suma autorizată pentru autorizările valide, dacă achizitorul acceptă acest lucru. Trebuie să aveți dreptul „Update Authorization” activat în profilul dvs. de comerciant de către your payment service provider pentru a face acest lucru. Pentru mai multe informații, consultați Update Authorization.
Amânările autorizărilor
Gateway-ul permite amânarea unei autorizări dacă nu puteți trimite o tranzacție Authorize sau Pay în momentul în care a fost finalizată la plătitor. Eșecul poate fi legat de conectivitate sau problemele de sistem sau de alte limitări care vă impun să amânați trimiterea până ce sistemul revine online. Identificarea autorizărilor amânate este obligatorie pentru respectarea cerințelor schemei Visa.
Mai jos, sunt listate câteva scenarii în care trebuie să marcați o autorizare ca autorizare amânată pentru plățile cu carduri Visa:
- Dacă sunteți un comerciant care acceptă plăți cu cardul prezent la un terminal POS pentru care sistemul de autorizare POS este offline, atunci autorizarea trimisă mai departe când sistemul revine online trebuie marcată ca amânată.
- Dacă sunteți un comerciant cu amănuntul care acceptă plăți prin comenzi telefonice pentru care sistemul de autorizare POS este offline, atunci autorizarea trimisă mai departe când sistemul revine online trebuie marcată ca amânată.
Pentru a amâna o autorizare, completați câmpul transaction.deferredAuthorization din solicitarea Authorize, Pay sau Standalone Capture și setați valoarea acestuia la TRUE. Dacă nu completați acest câmp, se va utiliza valoarea implicită, FALSE.
Pentru comercianții de tranzit, autorizarea remisă pentru suma agregată la sfârșitul perioadei de deplasare pentru toate plățile dintr-o perioadă de deplasare trebuie marcată ca amânată. Pentru mai multe informații, consultați secțiunea Plățile agregate de taxe de tranzit.
Întrebări frecvente
Pentru a deconta o sumă mai mare decât cea autorizată pentru o comandă, profilul dvs. de comerciant de pe gateway trebuie activat pentru dreptul Decontare în exces. Consultați Decontările în exces
Da, aceasta este numită solicitare de Standalone Capture și, dacă este acceptată pentru achizitor, puteți trimite o simplă solicitare de decontare cu codul de autorizare returnat de achizitor (în răspunsul de autorizare).
Operațiunea Pay combină funcțional o operațiune Authorize și una Capture într-un singur mesaj. O singură tranzacție autorizează plata și transferă fondurile din contul plătitorului în contul dvs.
Dacă doriți ca următoarea operațiune trimisă să fie Pay, trebuie să aveți o tranzacție de verificare efectuată cu succes, iar detaliile cardului din solicitarea Pay și cele din tranzacția Verify trebuie să corespundă.
Nivelul de certitudine al comenzii pentru o tranzacție Pay este setat la FINAL. Pentru mai multe informații, consultați Certitudinea comenzilor.
Operațiunea Pay mai este denumită, de asemenea, "Sale", "Purchase".
Initiate Browser Payment. Pentru mai multe informații, consultați secțiunea Implementarea unei integrări pentru plată prin browser.Auto Capture
Auto-capture este o variantă a operațiunii Pay care permite unui comerciant care are dreptul de a efectua tranzacții Pay și utilizează un achizitor care acceptă numai tranzacțiile Authorize/Capture să efectueze o operațiune Authorize, urmată de o operațiune Capture declanșată automat. În cazul acestui tip de tranzacție, solicitarea Pay este transformată în operațiuni Authorize și Capture.
Această operațiune poate fi realizată utilizând modelele de integrare <<directPayment>>, <<hostedSession>> sau <<batchIntegration>>.
Identificatorul de tranzacție pentru ambele solicitări, Authorize și Capture, va fi identificatorul de tranzacție furnizat de către dvs. în solicitarea inițială Pay. În răspunsul Pay, câmpul transaction.type va indica ultima tranzacție încercată pentru a realiza solicitarea, adică Authorize sau Capture.
Puteți utiliza operațiunea Colectare pentru a colecta rezultatul unei operațiuni Auto Capture. Este returnat rezultatul ultimei tranzacții încercate pentru realizarea solicitării.
Puteți anula o tranzacție Pay decontată automat folosind operațiunea Void Pay. Când realizați această operațiune, serviciul <<paymentGateway>>:
- încearcă o „Void Capture” pentru tranzacția Capture.
- dacă operațiunea „Void Capture” are succes, este încercată o „Void Authorization” pentru Authorization. Dacă operațiunea „Void Capture” eșuează, răspunsul va indica faptul că anularea a eșuat; nu mai este încercată operațiunea Void Authorization.
Amânările autorizărilor
Puteți furniza un indicator în solicitarea Pay, pentru a amâna autorizarea. Pentru mai multe informații, consultați Amânările autorizărilor.
Operațiunea Verify vă permite să verificați detaliile contului plătitorului înainte de a realiza tranzacția Pay sau Authorize. Aceasta verifică detaliile plății utilizând metoda de verificare acceptată de achizitor. De exemplu, dacă achizitorul acceptă Serviciul de verificare a adresei (AVS), atunci Verify trimite o tranzacție Numai AVS, cu suma tranzacției egală cu zero și detaliile de adresă ale plătitorului.
O tranzacție de Standalone Capture este o tranzacție Capture în care autorizarea a avut loc în afara gateway-ului. Când trimiteți o tranzacție de Standalone Capture către gateway, trebuie să furnizați codul de autorizare generat extern în câmpul transaction.authorizationCode și să completați celelalte câmpuri obligatorii.
Puteți trimite Standalone Capture dacă aveți dreptul Capture activat pentru profilul dvs. de comerciant.
Referință API Standalone Capture [REST][NVP]
Amânările autorizărilor
Puteți furniza un indicator în solicitarea Standalone Capture pentru a amâna autorizarea. Pentru mai multe informații, consultați Amânările autorizărilor.
O tranzacție de Standalone Refund este o tranzacție de Refund care vă permite să transferați fonduri din contul dvs. înapoi plătitorului, fără o achiziție anterioară. Rambursările independente pot fi efectuate când doriți să creditați contul plătitorului fără a asocia creditul cu o tranzacție anterioară.
Operația de tranzacție de plată vă permite să trimiteți fonduri în contul de card al unui plătitor atunci când este necesar – de exemplu, pentru câștigurile la jocuri sau loterii sau atunci când plătiți rata de card de credit a unui plătitor. Când efectuați o tranzacție de plată, detaliile de facturare și expediție ale plătitorului nu sunt necesare, iar validarea cu codul de securitate a cardului nu se aplică. O tranzacție de plată poate fi efectuată fără tranzacții anterioare sau după verificarea detaliilor contului plătitorului.
Operațiuni ulterioare
Această secțiune descrie operațiunile pe care le puteți realiza asupra tranzacțiilor inițiale Authorize sau Pay.
Pentru a verifica ce operațiuni sunt configurate în profilul dvs. de comerciant, contactați your payment service provider.
Operația Update Authorization vă permite:
- Să extindeți perioada de valabilitate a unei autorizări existente,
- Să măriți sau să micșorați opțional suma autorizată.
Dacă doriți doar să extindeți perioada de autorizare, nu remiteți transaction.amount în solicitare. Data și ora actualizate de expirare a autorizării sunt returnate în câmpul authorizationResponse.autoExpiry din răspunsul Retrieve Transaction. Este recomandat să remiteți solicitarea Update Authorization în intervalul de validitate a autorizării originale.
Dacă furnizați o sumă de tranzacție care este mai mare decât suma autorizării existente, suma autorizată este actualizată la noua valoare. De exemplu, dacă suma autorizată existentă este de 100 USD, însă valoarea tranzacției introdusă în solicitarea Update Authorization este de 120 USD, noua sumă autorizată disponibilă pentru decontare va fi de 120 USD.
Dacă furnizați o sumă de tranzacție care este mai mică decât suma autorizării existente, suma autorizată este actualizată la noua valoare. De exemplu, dacă suma autorizată existentă este de 100 USD, însă valoarea tranzacției introdusă în solicitarea Update Authorization este de 80 USD, noua sumă autorizată disponibilă pentru decontare va fi de 80 USD. Gateway-ul procesează automat o solicitare de anulare pentru suma autorizată rămasă, de 20 USD (dacă achizitorul acceptă acest lucru).
Rețineți că gateway-ul poate actualiza o autorizare existentă numai dacă sunt îndeplinite următoarele condiții:
- Profilul dvs. de comerciant de pe gateway trebuie să aibă dreptul „Update Authorization” activat de către your payment service provider.
- Moneda comenzii trebuie să corespundă monedei autorizării existente.
- Autorizarea existentă trebuie să fie validă, efectuată cu succes și complet aprobată.
Totaluri comenzi
După o solicitare Update Authorization trimisă cu succes (pentru un card sau PayPal), valoarea comenzii (order.amount) și suma autorizată totală (order.totalAuthorizedAmount) sunt actualizate la valoarea tranzacției Update Authorization (transaction.amount). Aceasta se aplică indiferent dacă ați trimis achizitorului tranzacția UPDATE AUTHORIZATION sau aceasta a fost aprobată automat de către gateway (response.gatewayCode=APPROVED_AUTO). Dacă, însă, decideți să evitați actualizarea autorizării pentru o solicitare de decontare în exces (trimițând transaction.authorizationAdjustmentActions=NO_ACTION, a se vedea Decontările în exces), iar gateway-ul trimite o decontare în exces către achizitor, totalurile comenzii NU sunt actualizate.
response.gatewayCode=APPROVED_AUTO) se aplică numai atunci când suma furnizată este mai mare decât cea autorizată existentă. Subtotaluri comenzi
În solicitarea Update Authorization pentru plăți cu cardul sau prin PayPal, puteți furniza următoarele valori de subtotaluri:
order.itemAmountorder.shippingAndHandlingAmountorder.taxAmountorder.discount.amount(numai pentru plățile cu cardul)order.gratuityAmount(numai pentru plățile cu cardul)
order.cashbackAmount în solicitarea Update Authorization nu este acceptată.Gateway-ul NU efectuează validarea dacă suma subtotalurilor este egală cu transaction.amount (respectiv, order.amount); totuși, acest lucru trebuie asigurat pentru plățile PayPal.
Comisionarea
În solicitarea Update Authorization, puteți actualiza valoarea unui comision folosind oricare dintre câmpurile de mai jos:
order.surchargeAmount: Utilizați acest câmp dacă furnizați o valoare calculată în prealabil a comisionului.order.netAmount: Utilizați acest câmp dacă gateway-ul calculează valoarea comisionului (pe baza regulilor dvs. pentru comisioane).
order.surchargeAmount nu este acceptată, iar solicitările care conțin acest câmp vor fi respinse. Dacă furnizați order.netAmount pentru o plată prin PayPal, tranzacția va fi procesată fără aplicarea unui comision.Operațiunea Capture utilizează o autorizare obținută după operațiunea Authorize inițială pentru a transfera fonduri din contul plătitorului în contul dvs. Operațiunea Capture trebuie să fie precedată întotdeauna de o autorizare realizată cu succes și cel puțin ID-ul autorizării trebuie transmis împreună cu solicitarea Capture. Moneda utilizată la decontarea unei sume trebuie să corespundă monedei utilizate în cadrul tranzacției de autorizare.
Operațiunile Capture sunt, în mod normal, grupate în loturi de către gateway sau de către gazda achizitorului, astfel încât fondurile nu sunt în realitate transferate până la închiderea lotului, când are loc decontarea.
Operațiunea Capture mai este denumită, de asemenea, "Bill", "Complete".
Suma totală pe care o decontați poate depăși suma autorizată inițial, dacă aveți activat pentru profilul dvs. comerciant dreptul de decontare în exces.
Decontare în exces este o variație a decontării, în cazul căreia puteți realiza decontări pentru sume mai mari decât suma autorizată. Valoarea în exces permisă este specificată ca procent din suma inițială autorizată și este stabilită la nivelul your payment service provider. Puteți efectua o singură decontare excesivă pentru fiecare comandă nedecontată parțial dacă decontarea atinge sau depășește suma autorizată originală.
Când trimiteți o solicitare Capture în exces, gateway-ul va încerca să actualizeze automat suma autorizată la suma pe care doriți să o decontați. Dacă achizitorul acceptă actualizarea autorizărilor, gateway-ul trimite solicitarea Update Authorization către achizitor. În caz contrar, gateway-ul va aproba automat o actualizare a autorizării (până la limita de decontare în exces configurată pentru profilul dvs. de comerciant).
Trimiteți transaction.authorizationAjustmentAction=NO_ACTION în solicitarea Capture dacă nu doriți ca gateway-ul să încerce să actualizeze autorizarea înainte de a trimite operațiunea Capture către achizitor. Rețineți că, în situațiile în care valoarea autorizată nu corespunde decontării, este posibil ca respectiva comandă să nu beneficieze de protecție la rambursare.
Dacă doriți să decontați parțial o autorizare și pentru alte informații asociate, consultați Întrebări frecvente.
Operațiunea Refund vă permite să creditați fonduri pentru o comandă existentă înapoi în contul plătitorului. Operațiuni Refund pot fi realizate numai în cazurile în care a fost realizat un transfer de fonduri fie printr-o operațiune Pay, fie printr-o operațiune Capture. Puteți realiza oricâte tranzacții de rambursare asupra tranzacției originale, dar nu puteți rambursa o sumă mai mare decât suma totală care a fost obținută prin intermediul tuturor tranzacțiilor achiziție sau decontare asociate comenzii.
Rambursările sunt realizate din multe motive – de exemplu, returnarea bunurilor nedorite, incorecte sau defecte.
Autorizare de rambursare
Înainte de a trimite solicitarea de rambursare la achizitor pentru compensare și decontare, gateway-ul încearcă automat să autorizeze rambursarea dvs. cu emitentul (dacă achizitorul acceptă acest lucru). În acest fel, emitenții pot verifica detaliile cardului din solicitarea de rambursare, pentru a se asigura că rambursarea va avea succes.
Autorizarea rambursării se realizează online și returnează un răspuns în timp real. Aceasta prezintă multe beneficii:
- Veți primi o notificare imediată de la emitenții de card privind reușita sau eșecul rambursării. Acest lucru vă va permite să luați măsurile adecvate atunci când emitentul răspunde cu un refuz. De exemplu, în cazul în care cardul utilizat pentru tranzacția de rambursare nu mai este valid, emitentul respinge autorizarea rambursării. Puteți contacta plătitorul pentru a soluționa rambursarea folosind un instrument de plată diferit.
- Emitentul cardului primește o notificare imediată privind solicitarea de rambursare, care le permite emitenților să afișeze instantaneu informațiile despre rambursarea către plătitor. De asemenea, le va permite să gestioneze eficient interogările/reclamațiile plătitorului.
Dacă nu doriți ca gateway-ul să trimită solicitarea de autorizare a rambursărilor, trebuie să aveți activat privilegiul „Activare rambursări fără autorizări”. Chiar dacă aveți acest privilegiu activat, puteți solicita autorizarea rambursărilor setând câmpul action.refundAuthorization = true în solicitarea API Refund.
Dacă autorizarea rambursării reușește, Serverul de plăți continuă procesul de rambursare, în caz contrar rambursarea este refuzată. Rezultatul tranzacției de rambursare este returnat în răspunsul tranzacției. Codul de autorizare primit de la emitent va fi afișat în Merchant Administration.
Rambursarea unei anumite decontări
În secțiunea Refund, trebuie să selectați decontarea vizată și apoi să introduceți suma de rambursat. Dacă există mai multe decontări, se va afișa o nouă UI; în caz contrar, dacă există o singură captură, se va afișa UI existentă. În timpul tranziției cu API, transaction.targetTransactionld este obligatoriu doar atunci când există mai multe decontări.
Suma totală rambursată pentru o comandă poate depăși suma care a fost decontată cu succes pentru o comandă, dacă pentru profilul dvs. de comerciant aveți activat dreptul de rambursare excesivă.
Suma în exces permisă pentru rambursare pentru o sumă decontată pentru tranzacții <<webServicesIntegration>> poate fi configurată pentru fiecare monedă în parte în Setări de integrare din Merchant Administration. Dacă nu setați o limită maximă de rambursare excesivă pentru o monedă, rambursările excesive pentru comenzi în acea monedă sunt respinse.
La trimiterea unei rambursări, suma totală rambursată pentru comandă (inclusiv rambursarea încercată) nu trebuie să depășească suma totală decontată pentru comanda cu o valoare mai mare decât suma maximă de rambursare excesivă permisă. De exemplu, dacă trimiteți o rambursare excesivă prin intermediul <<webServicesIntegration>> pentru o comandă în cazul căreia suma totală decontată este de $100 USD și ați setat limita de rambursare excesivă pentru tranzacții <<webServicesIntegration>> ca fiind $20 USD, atunci puteți rambursa până la maxim $120 USD.
Operația de tranzacție de plată vă permite să trimiteți fonduri în contul de card al unui plătitor atunci când este necesar – de exemplu, pentru câștigurile la jocuri sau loterii sau atunci când plătiți rata de card de credit a unui plătitor. Când efectuați o tranzacție de plată, detaliile de facturare și expediție ale plătitorului nu sunt necesare, iar validarea cu codul de securitate a cardului nu se aplică. O tranzacție de plată poate fi efectuată fără tranzacții anterioare sau după verificarea detaliilor contului plătitorului.
Operațiunea Retrieve Transaction vă permite să colectați detaliile unei tranzacții utilizând ID comandă și ID tranzacție. Ambele valori sunt obligatorii pentru că ID tranzacție identifică o tranzacție în cadrul unei comenzi.
Operațiunea Retrieve Order vă permite să colectați detaliile unei comenzi și tuturor tranzacțiilor asociate cu respectiva comandă.
Operațiunea Void încearcă să elimine/anuleze imediat o solicitare de tranzacție. Operațiunile Void pot fi realizate numai pentru tranzacții care nu au fost încă trimise băncii de către achizitor pentru procesare la finalul zilei. Din momentul în care o tranzacție a fost trimisă de achizitor pentru procesare, trebuie să realizați o operațiune Refund în locul unei operațiuni Void.
Puteți anula tranzacții Authorize, Capture, Pay sau Refund. O anulare realizată asupra unei tranzacții de Authorize va elibera imediat orice fonduri rezervate. În cazul tuturor celorlalte tipuri de tranzacții, anularea va împiedica realizarea transferului fondurilor.
Operațiunea Referral trimite din nou o tranzacție inițială recomandată (tranzacție Authorizaton sau Pay care a primit răspunsul „Consultați emitentul” de la achizitor) ca nouă tranzacție Authorization sau Pay cu un cod de autorizare obținut de la emitent.
Este posibil ca plătitorului să i se solicite să furnizeze informații suplimentare pentru ca emitentul să aprobe tranzacția și să furnizeze un cod de autorizare/ID autorizare manuală.
O rambursare apare atunci când un plătitor dispută o plată efectuată către dvs. De exemplu, bunurile nu au fost primite sau plătitorul nu a autorizat plata către dvs. Your payment service provider poate decide să importe detaliile tranzacțiilor de rambursare în gateway, astfel încât acestea să fie disponibile pentru dvs., pentru căutare și raportare. Your payment service provider poate decide să înregistreze fiecare tranzacție de rambursare pentru comanda originală sau să creeze o comandă nouă cu o tranzacție de rambursare separată.
Gateway-ul poate crea mai multe tranzacții de rambursare pentru o singură comandă. Puteți efectua tranzacții ulterioare pentru o comandă care include o tranzacție de rambursare, cum ar fi invalidările sau rambursările.
O tranzacție de rambursare înregistrată cu succes va returna următoarele câmpuri în răspunsul Retrieve Transaction/Retrieve Order:
order.status=CHARGEBACK_PROCESSEDsauDISPUTED: La crearea unei tranzacții de rambursare, starea comenzii corespunzătoare este actualizată pentru a indica existența unei dispute inițiate de plătitor.order.status=DISPUTEDindică faptul că a fost inițiată o dispută, însă nu au fost transferate încă fonduri.order.status=CHARGEBACK_PROCESSEDindică faptul că o solicitare de rambursare a fost procesată, iar fondurile vor fi transferate în sau din contul comerciantului.
order.chargeback.amountorder.chargeback.currency- Grupul de parametri
transaction.dispute: Informații despre disputa legată de rambursare, de ex. evenimentul disputei, data etc. transaction.type=CHARGEBACKtransaction.source=SERVICE_PROVIDERgatewayEntryPoint=SERVICE_PROVIDER_API