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

Эндпоинт	Описание
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 платежи)

Эндпоинт

Описание

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

https://api.maibmerchants.md/v1/execute-recurring

https://api.maibmerchants.md/v1/savecard-oneclick

https://api.maibmerchants.md/v1/execute-oneclick

https://api.maibmerchants.md/v1/delete-card

Удаление карты из maib ecomm (регулярные и one-click платежи)

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