# Terminologie

**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.&#x20;

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.&#x20;
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 [Notificări pe Callback URL](notificari-pe-callback-url).

**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.&#x20;

### **Proiectul de Test**

Proiectul de Test este destinat pentru efectuarea tranzacțiilor în mediul de tes&#x74;_**.**_ Î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.&#x20;

{% hint style="info" %}
Efectuarea testelor este una din condițiile obligatorii pentru activarea Proiectului de Producție. Efectuați teste de succes conform endpoint-urilor pentru [tipul de plată](https://docs.maibmerchants.md/ro/tipuri-de-plati) pe care doriți să-l utilizați, folosind [datele cardului](#user-content-fn-1)[^1] pentru teste.
{% endhint %}

### **Proiectul de Producție**&#x20;

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.**



[^1]: Cardholder: Test Test

    Card number: 5102180060101124

    Exp. date: 06/28

    CVV: 760
