> 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="/pages/R9qv8jC2tys4KipM7bEd">Generare token de acces</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay</td><td><a href="/pages/dDyjiFHwypuuOgMyb9u1">Plată directă</a></td></tr><tr><td>https://api.maibmerchants.md/v1/hold</td><td><a href="/pages/h7pF49mlw1kHBp8DPlkv">Autorizare tranzacție</a> (plată în 2 etape)</td></tr><tr><td>https://api.maibmerchants.md/v1/complete</td><td><a href="/pages/F1gK2UW5d2eeHe2M24hg">Finalizare tranzacție</a> (plată în 2 etape)</td></tr><tr><td>https://api.maibmerchants.md/v1/refund</td><td><a href="/pages/pzwAEJPUHPFGJlI2zCMS">Returnare plată</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay-info</td><td><a href="/pages/Z58LVPHCB54CZM0AdaMl">Informație despre plată</a></td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-recurring</td><td><a href="/pages/GbVJf6yeMjXZi9pkhzng">Î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="/pages/yPcXqeri2VgKTGvbNwLT">Executare plată recurentă</a> (plăți recurente)</td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-oneclick</td><td><a href="/pages/QI4v6MYkRSOBDD6mpbix">Î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="/pages/gFOdA1SOxTwl46eWUvXu">Executare plată one-click</a> (plăți one-click)</td></tr><tr><td>https://api.maibmerchants.md/v1/delete-card</td><td><a href="/pages/CcRGRQW1VntL2UHodcPp">Ș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 %}