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

# maib e-commerce API

Взаимодействие с **maib ecomm** происходит через HTTPS-запросы (POST / GET / DELETE) к эндпоинтам API с данными в формате JSON.

Ответы, полученные в веб-сайте/приложении от **maib ecomm**, представляют собой HTTPS-запросы POST с данными в формате JSON.

Все эндпоинты структурированы по следующему шаблону: 

*{base-url}/{api-version}/{point}*

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

Текущая версия API: *v1*

### Эндпоинты API

<table><thead><tr><th width="456"> Эндпоинт</th><th>Описание</th></tr></thead><tbody><tr><td>https://api.maibmerchants.md/v1/generate-token</td><td><a href="/pages/Y8My13KUcqdIHYpZbEuk">Генерация Токена доступа</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay</td><td><a href="/pages/d6MY3Mcib4dC0YKELJ3U">Прямой платеж</a></td></tr><tr><td>https://api.maibmerchants.md/v1/hold</td><td><a href="/pages/nTcj9wbS59yUeCA020RO">Авторизация транзакции </a>(двухэтапные платежи)</td></tr><tr><td>https://api.maibmerchants.md/v1/complete</td><td><a href="/pages/5IlL1sAHaI7R0hSwhBbr">Завершение транзакции</a> (двухэтапные платежи)</td></tr><tr><td>https://api.maibmerchants.md/v1/refund</td><td><a href="/pages/Q4l27jhKamzSZiIFiok8">Возврат платежа</a></td></tr><tr><td>https://api.maibmerchants.md/v1/pay-info</td><td><a href="/pages/HWMWCkxgki1k8lPFByS8">Информация о платеже</a></td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-recurring</td><td><a href="/pages/RyGLkFA0X1zleRhIbjdt">Регистрация карты в <strong>maib ecomm</strong></a> (регулярные платежи)</td></tr><tr><td>https://api.maibmerchants.md/v1/execute-recurring</td><td><a href="/pages/o2jaeHAW0pzmoLUKRkO3">Выполнение регулярного платежа</a> (регулярные платежи)</td></tr><tr><td>https://api.maibmerchants.md/v1/savecard-oneclick</td><td><a href="/pages/aVDAAwrK2dMLVekd06W5">Регистрация карты в <strong>maib ecomm</strong> </a>(one-click платежи)</td></tr><tr><td>https://api.maibmerchants.md/v1/execute-oneclick</td><td><a href="/pages/vlXwo8Ag0XpYDOozbRP5">Выполнение one-click платежа</a> (one-click платежи)</td></tr><tr><td>https://api.maibmerchants.md/v1/delete-card</td><td><a href="/pages/hbp5Al3D9pN66RCYuLCB">Удаление карты  из <strong>maib ecomm</strong></a> (регулярные и one-click платежи)</td></tr></tbody></table>

### Взаимодействие через API

1. Клиент заходит на сайт Мерчанта, выбирает товар или услугу, которую хочет купить, и добавляет в корзину.
2. Покупатель нажимает кнопку «**Оплатить заказ**», и Мерчант отправляет HTTPS-запрос POST (с данными транзакции) на эндпоинт API **maib ecomm.**
3. **maib ecomm** возвращает *промежуточный ответ*, содержащий ссылку (*payUrl*).
4. Покупатель перенаправляется на ссылку *payUrl* и попадает на страницу **maib ecomm checkout**.
5. Покупатель вводит данные карты (или платит через Apple Pay / Google Pay).
6. Система **maib ecomm** обрабатывает транзакцию.
7. Покупатель перенаправляется обратно на сайт (на *okUrl* или *failUrl* в зависимости от статуса транзакции).
8. Мерчант получает (на *callbackUrl*) *окончательный ответ*, содержащий статус и основные данные транзакции.

### Postman Collection

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