- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
Implementarea unei integrări pentru plată prin browser
Metodele de plată prin browser permit unui plătitor să plătească online pentru bunuri și servicii, pe site-ul web al furnizorului de metode de plată prin browser. eGenius Platform redirecționează browserul plătitorului către site-ul web al furnizorului de metode de plată prin browser, unde plătitorul se autentifică, selectează detaliile cardului, verifică plata și finalizează interacțiunea.
eGenius Platform acceptă următoarele metode de plată prin browser:
Cerințe preliminare
Pentru a implementa plățile prin browser în eGenius Platform, aveți nevoie de:
- un cont la furnizorul de metode de plată prin browser,
- o pagină pe site-ul magazinului dvs., la care eGenius Platform va readuce browserul plătitorului în momentul finalizării interacțiunii.
Este recomandat să vă abonați la serviciul de Notificări, pentru a putea primi notificări (e-mail/Webhook) atunci când o plată are succes. În numele dvs., eGenius Platform poate trimite, de asemenea, notificări prin e-mail plătitorului.
Plățile prin browser prin integrarea Hosted Checkout
Dacă aveți deja o integrare Hosted Checkout, metoda de plată prin browser va fi automat disponibilă din momentul în care your payment service provider vă configurează cu succes legătura comerciant de pe eGenius Platform cu legătura achizitor pentru furnizorul de metode de plată prin browser.
Diagrama de mai jos ilustrează procesul de plată prin browser într-un model Hosted Checkout:
- Dvs. inițiați o interacțiune Hosted Checkout atunci când plătitorul este gata pentru validare pe site-ul magazinului dvs. eGenius Platform afișează interfața de plată aleasă de dvs.: un lightbox sau o pagină de plată găzduită.
- Plătitorului i se afișează interfața de plată, în care metoda de plată prin browser apare ca opțiune de plată.
- Atunci când plătitorul selectează metoda de plată prin browser, eGenius Platform redirecționează browserul plătitorului către site-ul web al furnizorului de metode de plată prin browser, unde plătitorul se autentifică și selectează detaliile de plată sau efectuează plata.
- Odată ce interacțiunea plătitorului cu site-ul web al furnizorului de metode de plată prin browser ia sfârșit, plătitorului îi este prezentat rezultatul plății, prin:
- Confirmare găzduită: rezultatul plății este afișat pe pagina de plată găzduită/în lightbox. Aceasta este modalitatea de funcționare implicită.
- Confirmare pe site-ul magazinului dvs.: puteți alege să afișați rezultatul plății pe site-ul magazinului dvs., pentru plătitor. Pentru instrucțiuni de integrare, consultați Readucerea plătitorului pe site-ul magazinului dvs.
De asemenea, plătitorul poate obține rezultatul unei plăți efectuate cu succes printr-o notificare trimisă prin e-mail de către eGenius Platform — trebuie să vă abonați la notificările pentru plătitori în Merchant Administration.
Apelarea rezultatului tranzacției
Puteți utiliza Merchant Administration sau puteți efectua o operațiune Retrieve Order/Retrieve Transaction pentru a determina succesul sau orice altă stare a plății. Consultați secțiunea „Interpretarea rezultatului tranzacției” de pe pagina de integrare specifică plăților prin browser.
Puteți determina succesul plății și prin integrarea dvs. (numai dacă alegeți să readuceți plătitorul pe site-ul magazinului dvs.) sau prin serviciul Notificări (e-mail/Webhook).
Plățile prin browser prin integrarea Direct Payment
Diagrama de mai jos ilustrează procesul de plată prin browser într-un model Direct Payment:
Aceștia sunt pașii de integrare pentru o plată prin browser în integrarea Direct Payment:
Atunci când plătitorul selectează metoda de plată prin browser, efectuați o operațiune Initiate Browser Payment pentru a furniza informații despre comandă și a obține adresa URL de redirecționare pentru metoda de plată prin browser. Trebuie să completați următoarele câmpuri în solicitarea operațiunii Initiate Browser Payment:
order.amount: Valoarea comenzii.order.currency: Moneda în care este plătită comanda.sourceOfFunds.type: Metoda de plată prin browser. De exemplu, PAYPAL, UNION_PAY.browserPayment.returnUrl: Adresa URL de returnare reprezintă o pagină pe site-ul dvs. web. Browserul plătitorului este redirecționat către această pagină la finalizarea plății pe site-ul web al furnizorului de metode de plată prin browser. Poate fi util să includeți, în adresa URL de returnare, informații pentru identificarea comenzii plătitorului pe site-ul dvs. web.browserPayment.operation: Tipul tranzacției pe care doriți să o creați atunci când plătitorul finalizează interacțiunea. Aveți două opțiuni:
Authorize— O tranzacție în care plata este autorizată cu sursa sau sursele de finanțare de bază a plătitorului, dar nu este decontată imediat.Pay— O tranzacție în care plata este autorizată și, dacă are succes, este decontată imediat.
Rețineți că eGenius Platform ignoră drepturile configurate în contul dvs. de comerciant cu eGenius Platform.
PayPal și UnionPay SecurePay acceptă atât operațiunile Authorize, cât și operațiunile Pay; celelalte metode de plată prin browser (Sofortbanking, giropay, BancaNet) acceptă numai operațiunea Pay.
Puteți furniza, de asemenea, detalii suplimentare despre comandă, cum ar fi adresa de facturare, adresa de livrare, detaliile clientului etc.
Utilizați browserPayment.redirectUrl furnizat în răspunsul la Initiate Browser Payment pentru a direcționa browserului plătitorului către site-ul web al furnizorului de metode de plată prin browser.
Odată ce interacțiunea plătitorului cu site-ul web al furnizorului de metode de plată prin browser ia sfârșit, eGenius Platform readuce browserul plătitorului la site-ul magazinului dvs., folosind browserPayment.returnUrl furnizat în solicitarea Initiate Browser Payment. Site-ul magazinului dvs. trebuie să identifice comanda prin informațiile incluse în adresa URL de returnare.
Dacă nu readuceți browserul plătitorului pe site în intervalul de timp preconizat, efectuați o operațiune Retrieve Transaction (a se vedea pasul 4) pentru a afla starea interacțiunii și a determina dacă plata a avut sau nu succes.
După ce primiți browserul plătitorului, utilizați Retrieve Transaction pentru a afla dacă plata a avut sau nu succes.
Răspunsul Retrieve Transaction va conține detaliile comenzii și, în funcție de metoda de plată, poate conține detalii referitoare la plătitor, așa cum sunt returnate de către furnizorul de metode de plată prin browser.
Utilizați informațiile furnizate pentru a afișa rezultatul tranzacției către plătitor. Consultați secțiunea „Interpretarea rezultatului tranzacției” de pe pagina de integrare specifică plăților prin browser.
Dacă tranzacția nu are succes, efectuați din nou pașii 1–4, folosind același ID de comandă.
Testarea unei integrări pentru plată prin browser
Pentru detalii privind testarea metodelor acceptate de plată prin browser, consultați Testarea plăților prin browser.
Depanare și întrebări frecvente
Puteți urmări evoluția unei plăți prin browser folosind câmpul browserPayment.interaction.status și câmpurile de oră respective, returnate în răspunsul Retrieve Transaction/Retrieve Order.
browserPayment.interaction.status=INITIATEDbrowserPayment.interaction.timeInitiated=<the date and time the payment was successfully initiated is set>browserPayment.interaction.status=REDIRECTED_TO_PROVIDERbrowserPayment.interaction.timeRedirected=<the date and time the payer's browser was received from your shop site and redirected to the browser payment provider's website is set>browserPayment.interaction.status=RETURNED_TO_MERCHANTbrowserPayment.interaction.timeReturned=<the date and time the payer's browser was received from the browser payment provider's website and redirected back to your shop site is set>browserPayment.interaction.status=COMPLETEDbrowserPayment.interaction.timeCompleted=<the date and time the payment was completed is set>
Aceste câmpuri pot fi utile pentru depanare.