> 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/maib-e-commerce-api.md).

# maib e-commerce API

Interaction with **maib ecomm** occurs through HTTPS (POST / GET / DELETE) requests to API endpoints with data in **JSON** format. 

The responses received on the website/app from **maib ecomm** will be HTTPS POST requests with data in **JSON** format.

All endpoints are structured according to the following pattern: *{base-url}/{api-version}/{point}*

Base URL: *<https://api.maibmerchants.md>*

Current API version: *v1*

### API Endpoints

<table><thead><tr><th width="461">Endpoint</th><th>Description</th></tr></thead><tbody><tr><td>https://api.maibmerchants.md/v1/generate-token</td><td><a href="/e-commerce/access-token-generation.md">Access Token generation</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay</td><td><a href="/e-commerce/direct-payment.md">Direct payment</a></td></tr><tr><td>https://api.maibmerchants.md/v1/hold</td><td><a href="/e-commerce/two-step-payment/payment-authorization.md">Payment authorization </a>(two-step payments)</td></tr><tr><td>https://api.maibmerchants.md/v1/complete</td><td><a href="/e-commerce/two-step-payment/payment-capture.md">Payment capture</a> (two-step payments)</td></tr><tr><td>https://api.maibmerchants.md/v1/refund</td><td><a href="/e-commerce/payment-refund.md">Payment refund</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay-info</td><td><a href="/e-commerce/payment-information.md">Payment information</a></td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-recurring</td><td><a href="/e-commerce/recurring-payments/register-card-in-the-maib-ecomm-system.md">Register card</a> (recurring payments)</td></tr><tr><td>https://api.maibmerchants.md/v1/execute-recurring</td><td><a href="/e-commerce/recurring-payments/execute-recurring-payment.md">Execute recurring payment </a>(recurring payments)</td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-oneclick</td><td><a href="/e-commerce/one-click-payments/register-card-in-the-maib-ecomm-system.md">Register card</a> (one-click payments)</td></tr><tr><td>https://api.maibmerchants.md/v1/execute-oneclick</td><td><a href="/e-commerce/one-click-payments/execute-one-click-payment.md">Execute one-click payment</a> (one-click payments)</td></tr><tr><td>https://api.maibmerchants.md/v1/delete-card</td><td><a href="/e-commerce/deleting-the-card-from-maib-ecomm.md">Deleting the card</a> (recurring and one-click payments)</td></tr></tbody></table>

### Interaction via API

E.g for Direct Payment:

1. Customer chooses product or service in Merchant online shop (website/app) and adds it to his cart.
2. The Customer presses the «**Place order**» button, and the Merchant sends an HTTPS POST request (with transaction data) to the API endpoint.
3. **maib ecomm** returns an *intermediate response* containing the link (*payUrl*).
4. The Customer is redirected to the *payUrl* link and access the **maib ecomm checkout** page.
5. The Customer enters the card data (or pay via Apple Pay/Google Pay).
6. The **maib ecomm** processes the transaction.
7. The Customer is redirected back to the Merchant online shop (website/app), on *okUrl* or *failUrl* (depending on the status of the transaction).
8. The Merchant online shop receives (on *callbackUrl* via HTTPS POST request) a final response containing the status and basic transaction data.

### Postman Collection

{% file src="/files/BpDWkUTCCJp1ZpVEz6WL" %}