Asistență agregator

eGenius Platform vă oferă funcționalitatea necesară pentru a acționa ca agregator. Acest lucru vă permite să oferiți servicii online de acceptare a plăților electronice pentru alți comercianți (denumiți sub-comercianți), fără ca sub-comerciantul să aibă o relație contractuală nici cu achizitorul, nici cu gateway-ul. Aceasta este o opțiune atractivă pentru acceptarea de plăți online de la plătitori pentru comercianții cu un număr redus de tranzacții și oferă o configurare foarte rapidă.

Sub-comerciantul necesită numai o relație contractuală cu dvs., agregatorul. Dvs. gestionați relația contractuală cu achizitorul, primiți fondurile destinate sub-comerciantului și le decontați prin transferul către sub-comerciant.

  • Funcționalitatea de agregator este acceptată în API începând cu versiunea 32.
  • Schemele de card au anumite cerințe pe care trebuie să le respectați dacă doriți să acționați ca agregator. Pentru detalii, contactați achizitorul și/sau schemele de carduri.

Cerințe preliminare

Trebuie să contactați achizitorul, care vă va înscrie în schemele de carduri pentru a vă putea configura ca agregator. Achizitorul vă poate furniza un ID și/sau nume de agregator. Furnizați aceste detalii furnizorului dvs. de servicii de plată.

Furnizorul dvs. de servicii de plată trebuie să vă configureze corespunzător profilul de comerciant (legătura achizitor comerciant) în gateway.

Trimiterea tranzacțiilor API pentru sub-comercianți

La trimiterea unei tranzacții pentru un sub-comerciant prin următoarele operațiuni API, puteți furniza detaliile sub-comerciantului indicate mai jos în grupul de parametri order.subMerchant.

Solicitări API:

  • PAY
  • AUTHORIZE
  • Standalone CAPTURE
  • Standalone REFUND
  • VERIFY
  • UPDATE_SESSION

Detalii sub-comerciant:

  • order.subMerchant.identifier (obligatoriu dacă order.subMerchant.tradingName este furnizat)
  • order.subMerchant.registeredName
  • order.subMerchant.tradingName (obligatoriu dacă order.subMerchant.identifier este furnizat)
  • order.subMerchant.bankIndustryCode
  • Câmpurile order.subMerchant.address.*
  • order.subMerchant.phone
  • order.subMerchant.email

Dacă sunt furnizate, acestea vor fi returnate în următoarele răspunsuri:

  • RETRIEVE_TRANSACTION
  • RETRIEVE_ORDER
  • RETRIEVE_SESSION

Dacă gateway-ul nu asigură funcționalitatea de agregator pentru achizitorul dvs., o solicitare care conține detaliile sub-comerciantului va fi respinsă.

Detaliile sub-comerciantului se aplică tuturor tranzacțiilor dintr-o comandă. Acestea pot fi furnizate numai pentru tranzacțiile inițiale, respectiv tranzacțiile care creează o comandă. Dacă sunt furnizate în tranzacțiile ulterioare (respectiv, tranzacțiile pentru o comandă existentă, cum ar fi o solicitare CAPTURE sau REFUND ulterioară), gateway-ul respinge cererea.

Tokenization

Dacă acționați ca agregator, nu puteți utiliza funcționalitatea Tokenization. Gateway-ul respinge solicitările de tranzacții cu detaliile sub-comerciantului pentru comercianții cu Tokenization activat.

Validare găzduită

Dacă doriți să furnizați sub-comercianților dvs. funcționalitatea Hosted Checkout, trebuie să le furnizați o interfață către integrarea dvs. cu Hosted Checkout.

Dacă furnizați detaliile sub-comerciantului, trebuie să includeți un ID de sesiune când apelați Checkout.configure(). Trimiteți o solicitare APICREATE_CHECKOUT_SESSION și includeți detaliile comenzii sub-comerciantului pentru a genera un ID de sesiune. Browserul plătitorului va fi returnat în aplicația dvs. și trebuie să redirecționați plătitorul către aplicația sub-comerciantului.

Utilizați Checkout.configure() pentru a furniza detaliile de afișare ale sub-comerciantului, cum ar fi numele, adresa, detaliile de contact și sigla comerciantului. Aceste detalii sunt prezentate plătitorului în timpul interacțiunii Hosted Checkout.

Nu furnizați sub-comercianților acreditările dvs. de pe gateway. Acest lucru le-ar permite să acceseze tranzacțiilor celorlalți sub-comercianți ai dvs.

Autentificarea EMV 3D-Secure

Pentru a permite sub-comercianților să utilizeze autentificarea 3-D Secure EMV (3DS2) pe gateway, agregatoarele trebuie să trimită detaliile relevante ale sub-comercianților în solicitarea Initiate Authentication. Atunci când detaliile sub-comercianților sunt trimise către gateway, gateway-ul utilizează detaliile sub-comercianților în locul detaliilor agregatorului din mesajul de autentificare din aval. Câmpurile care trebuie completate diferă de la o schemă la alta. Schemele acceptate includ:

  • Mastercard SecureCode 2.0
  • Verified by Visa 2.0
  • Amex SafeKey 2.0

Dacă autentificarea este urmată de o plată care utilizează o operațiune Authorize sau Pay care include ID-ul autentificării 3DS2, detaliile sub-comerciantului furnizate în solicitarea Initiate Authenticationsunt, de asemenea, utilizate în operațiunile Authorize/Pay.

Trimiterea tranzacțiilor pentru 3DS2

Trebuie să furnizați următoarele detalii pentru sub-comerciant în solicitarea Initiate Authentication.

Detalii sub-comerciant

  • order.subMerchant.identifier (obligatoriu pentru toate schemele 3DS2 acceptate)
  • order.subMerchant.tradingName (obligatoriu pentru toate schemele 3DS2 acceptate)
  • order.subMerchant.bankIndustryCode (obligatoriu pentru toate schemele 3DS2 acceptate)
  • order.subMerchant.registeredName
  • order.subMerchant.address.country (obligatoriu pentru toate schemele 3DS2 acceptate)
  • order.subMerchant.address.* (alte câmpuri de adresă)
  • order.subMerchant.phone
  • order.subMerchant.email

Detalii 3DS2

Furnizați următoarele detalii ale configurației 3DS2 pentru sub-comerciant. Ca cerință preliminară, trebuie să aveți schema respectivă de autentificare 3DS2 activată în profilul dvs. de comerciant pentru care sub-comerciantul poate efectua autentificări 3DS2 ale plătitorilor.

  • order.subMerchant.websiteUrl: Adresa URL a site-ului web al sub-comerciantului. Dacă nu completați acest câmp, va fi utilizată adresa URL a site-ului web din profilul dvs. de comerciant.
  • order.subMerchant.authentication[n].protocol
  • order.subMerchant.authentication[n].3DS2.requestorId
  • order.subMerchant.authentication[n].3DS2.requestorName

Pentru fiecare schemă de autentificare (identificată de order.subMerchant.authentication[n].protocol) pentru care sub-comerciantul poate efectua autentificări 3DS2 ale plătitorilor, trebuie să introduceți ID-ul solicitantului și numele solicitantului, exceptând Mastercard SecureCode și Verified By Visa.

Pentru Mastercard SecureCode și Verified By Visa, nu este necesar să furnizați detaliile de autentificare. ID-ul și numele solicitantului sunt generate de gateway.

Pentru Amex SafeKey, dacă ID-ul solicitantului și numele solicitantului pentru sub-comerciant nu sunt disponibile, gateway-ul va utiliza ID-ul solicitantului și numele solicitantului configurate în profilul dvs. de comerciant.

Copyright © 2021 UniCredit Bank