> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/e-commerce/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maibmerchants.md/e-commerce/ro/maib-e-commerce-api.md).

# maib e-commerce API

Interacțiunea cu **maib ecomm** are loc prin request-uri HTTPS (POST / GET / DELETE) către endpoint-urile API cu date în format JSON. 

Răspunsurile returnate de **maib ecomm** către soluția dvs. ecommerce (website/app), pe *Callback URL*, vor fi request-uri HTTPS POST cu date în format JSON.

Toate endpont-urile sunt structurate după următorul șablon: *{base-url}/{api-version}/{point}*

Base URL: *api.maibmerchants.md*

Versiunea actuală API: *v1*

### **Endpoint-uri API**

<table data-full-width="false"><thead><tr><th width="465">Endpoint</th><th>Descriere</th></tr></thead><tbody><tr><td>https://api.maibmerchants.md/v1/generate-token</td><td><a href="/e-commerce/ro/generare-token-de-acces.md">Generare token de acces</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay</td><td><a href="/e-commerce/ro/plati-directe.md">Plată directă</a></td></tr><tr><td>https://api.maibmerchants.md/v1/hold</td><td><a href="/e-commerce/ro/plati-in-2-etape/autorizare-tranzactie.md">Autorizare tranzacție</a> (plată în 2 etape)</td></tr><tr><td>https://api.maibmerchants.md/v1/complete</td><td><a href="/e-commerce/ro/plati-in-2-etape/finalizare-tranzactie.md">Finalizare tranzacție</a> (plată în 2 etape)</td></tr><tr><td>https://api.maibmerchants.md/v1/refund</td><td><a href="/e-commerce/ro/returnare-plata.md">Returnare plată</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay-info</td><td><a href="/e-commerce/ro/informatie-despre-plata.md">Informație despre plată</a></td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-recurring</td><td><a href="/e-commerce/ro/plati-recurente/inregistrare-card-in-sistemul-maib-ecomm.md">Înregistrare card în <strong>maib ecomm</strong></a> (plăți recurente)</td></tr><tr><td>https://api.maibmerchants.md/v1/execute-recurring</td><td><a href="/e-commerce/ro/plati-recurente/executare-plata-recurenta.md">Executare plată recurentă</a> (plăți recurente)</td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-oneclick</td><td><a href="/e-commerce/ro/plati-one-click/inregistrare-card-in-sistemul-maib-ecomm.md">Înregistrare card în <strong>maib ecomm</strong></a> (plăți one-click)</td></tr><tr><td>https://api.maibmerchants.md/v1/execute-oneclick</td><td><a href="/e-commerce/ro/plati-one-click/executare-plata-one-click.md">Executare plată one-click</a> (plăți one-click)</td></tr><tr><td>https://api.maibmerchants.md/v1/delete-card</td><td><a href="/e-commerce/ro/stergere-card-din-maib-ecomm.md">Ștergere card din <strong>maib ecomm</strong> </a>(plăți recurente și one-click)</td></tr></tbody></table>

### Interacțiunea prin API

1. Cumpărătorul intră pe website/app, selectează produsul sau serviciul pe care dorește să-l cumpere și îl adaugă în coș.
2. Cînd Cumpărătorul apasă butonul "**Achită comanda**" se execută un request HTTPS POST către endpoint-ul **API maib ecommerce**, cu datele tranzacției în format JSON.
3. **maib ecomm** returnează instant un *răspuns intermediar* care conține un link (*payUrl*).&#x20;
4. Cumpărătorul este redirecționat pe *payUrl* și ajunge pe pagina **maib ecomm checkout.**
5. Cumpărătorul introduce datele cardului (sau achită prin **Apple Pay** / **Google Pay**).
6. Sistemul **maib ecomm** procesează tranzacția.
7. Cumpărătorul este redirecționat înapoi pe website/app, pe *okUrl* sau *failUrl* în funcție de starea tranzacției (reușită sau eșuată).
8. **maib ecomm** transmite pe c*allbackUrl* o notificare cu *răspunsul final* ce conține starea și datele tranzacției.

### Postman Collection

{% file src="/files/Np2mbKhSxrLOr9fDooen" %}
Postman Collection
{% endfile %}