# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maibmerchants.md/e-commerce/ro/maib-e-commerce-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.