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

Эндпоинт	Описание
https://api.maibmerchants.md/v1/generate-token	Генерация Токена доступа
https://api.maibmerchants.md/v1/pay	Прямой платеж
https://api.maibmerchants.md/v1/hold	Авторизация транзакции (двухэтапные платежи)
https://api.maibmerchants.md/v1/complete	Завершение транзакции (двухэтапные платежи)
https://api.maibmerchants.md/v1/refund	Возврат платежа
https://api.maibmerchants.md/v1/pay-info	Информация о платеже
https://api.maibmerchants.md/v1/savecard-recurring	Регистрация карты в maib ecomm (регулярные платежи)
https://api.maibmerchants.md/v1/execute-recurring	Выполнение регулярного платежа (регулярные платежи)
https://api.maibmerchants.md/v1/savecard-oneclick	Регистрация карты в maib ecomm (one-click платежи)
https://api.maibmerchants.md/v1/execute-oneclick	Выполнение one-click платежа (one-click платежи)
https://api.maibmerchants.md/v1/delete-card	Удаление карты из maib ecomm (регулярные и one-click платежи)

Взаимодействие через 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

3KB

API_maib_e-commerce.postman_collection.zip

archive