maib e-commerce API
RUEN
  • Terminologie
  • Etape și cerințe pentru integrare
    • Etapele integrării
    • Cerințe pentru integare
  • maib e-commerce API
  • Tipuri de plăți
  • Generare Token de acces
  • Plăți directe
  • Plăți în 2 etape
    • Autorizare tranzacție
    • Finalizare tranzacție
  • Returnare plată
  • Informație despre plată
  • Plăți recurente
    • Înregistrare card în sistemul maib ecomm
    • Executare plată recurentă
  • Plăți one-click
    • Înregistrare card în sistemul maib ecomm
    • Executare plată one-click
  • Ștergere card din maib ecomm
  • Notificări pe Callback URL
  • Starea tranzacției și 3D-Secure
  • Erori
    • Erori API
    • Coduri de stare HTTP
  • Plugin-uri si soluții gata
    • Plugin-uri
    • SDK
    • Tilda
    • Gomag
    • Cartum
    • ECOM
Powered by GitBook
On this page
  • Proiectul de Test
  • Proiectul de Producție

Terminologie

NextEtape și cerințe pentru integrare

Last updated 1 year ago

maibmerchants - este un portal dedicat Comerciantului, unde acesta poate configura setările necesare pentru integrarea cu maib e-commerce, efectua unele operațiuni financiare (cum ar fi returnarea plății) și accesa funcționalități suplimentare.

Portalul este în continuă dezvoltare si pe viitor va conține și alte instrumente care vor ușura și îmbunătăți experiența digitală a Comerciantului.

maib ecomm - sistemul maib care procesează tranzacțiile online.

maib ecomm checkout - pagina unde este redirecționat Cumpărătorul pentru a introduce datele cardului (sau achită prin Apple Pay™ / Google Pay™). Merchant-ul are posibilitatea de a modifica această pagină. La cerere el va primi template-ul paginii și cerințele conform cărora va efectua modificările.

Soluție ecommerce - reprezintă un website sau o aplicație care oferă funcționalități precum catalogarea produselor, procesarea plăților și gestionarea comenzilor. Scopul său este de a facilita vânzările online și de a oferi o experiență de cumpărare convenabilă atât pentru comercianți, cât și pentru cumpărători.

Merchant - entitate cu activitate comercială care deține o soluție ecommerce și inițiază integrarea cu maib ecomm pentru a accepta plăți online.

Proiect - entitate în platforma maibmerchants care conține informație și setări referitoare la integrarea unei soluții cu maib ecomm.

Pentru fiecare soluție ecommerce, va fi deschis un Proiect cu următoarele configurări necesare:

  1. Domeniu - se referă la domeniul soluției ecommerce (website/app). Merchant-ul trebuie să dețină dreptul de proprietate asupra domeniului.

  2. IP - se referă la IP-ul serverului/hostingului unde este găzduită soluția ecommerce.

  3. Platforma - se referă la platforma utilizată pentru construirea/dezvoltarea și gestionarea soluției ecommerce. Aceasta poate fi un CMS (sistem de administrare a conținutului), platformă ecommerce sau un limbaj de programare specific.

  4. Callback URL - este link-ul către care maib ecomm va trimite notificări cu răspunsul final ce conține starea și datele tranzacției. Acest URL trebuie să fie accesibil și pregătit pentru a primi și procesa notificări.

  5. Ok URL - este link-ul către care Cumpărătorul va fi redirecționat în cazul în care tranzacția este reușită. După finalizarea plății, Cumpărătorul va fi redirecționat către acest URL pentru a primi confirmarea și detaliile tranzacției.

  6. Fail URL - este link-ul către care Cumpărătorul va fi redirecționat în cazul în care tranzacția eșuează. Dacă ceva nu funcționează corect în timpul procesului de plată sau dacă tranzacția este respinsă, Cumpărătorul va fi redirecționat către acest URL pentru a primi o notificare despre eșecul tranzacției.

Project Secret - se folosește împreună cu Project ID la generarea Token-ului de acces, utilizat pentru autorizarea request-urilor către maib ecomm.

Signature Key - se folosește la validarea notificărilor cu starea și datele tranzacției pe Callback URL. Mai multe detalii vedeți în compartimentul .

Răspuns intermediar - răspuns instant transmis de maib ecomm către soluția dvs. ecommerce care conține identificatorul tranzacției și link-ul către pagina maib ecomm checkout.

Răspuns final - notificare transmisă de maib ecomm către soluția dvs. ecommerce (pe Callback URL) care conține starea și datele tranzacției. Callback URL este setat pentru fiecare Proiect în platformă dar poate fi transmis și în request către endpoint.

Proiectul de Test

Proiectul de Test este destinat pentru efectuarea tranzacțiilor în mediul de test. În mediul de test, pot fi efectuate toate tipurile de plăți prevăzute în maib e-commerce API: plăți directe, plăți în 2 etape, plăți recurente și plăți one-click.

Proiectul de Producție

Proiectul de Producție este destinat pentru efectuarea tranzacțiilor reale și poate fi activat doar după semnarea contractului de e-commerce și configurarea proiectului în platformă (Domeniu / IP / Platforma / Callback URL / Ok URL / Fail URL).

După activarea Proiectului, veți avea acces la Project Secret și Signature Key pentru integrarea soluției dvs. cu maib ecomm.

Efectuarea testelor este una din condițiile obligatorii pentru activarea Proiectului de Producție. Efectuați teste de succes conform endpoint-urilor pentru pe care doriți să-l utilizați, folosind pentru teste.

Notificări pe Callback URL
tipul de plată