maib e-commerce API
ROEN
  • Терминология
  • Этапы и требования к интеграции
    • Этапы интеграции
    • Требования к интеграции
  • maib e-commerce API
  • Типы платежей
  • Генерация Токена доступа
  • Прямой платеж
  • Двухэтапный платеж
    • Авторизация транзакции
    • Завершение транзакции
  • Возврат платежа
  • Информация о платеже
  • Рекуррентные (регулярные) платежи
    • Регистрация карты в системе maib ecomm
    • Выполнение регулярного платежа
  • One-click платежи
    • Регистрация карты в системе maib ecomm
    • Выполнение one-click платежа
  • Удаление карты из maib ecomm
  • Уведомления на Callback Url
  • Статус транзакции и 3D-Secure
  • Ошибки
    • Ошибки API
    • Коды состояния HTTP
  • Плагины и готовые решения
    • Плагины
    • SDK
    • Tilda
    • Gomag
    • Cartum
    • ECOM
Powered by GitBook
On this page
  • Тестовый проект
  • Производственный Проект

Терминология

NextЭтапы и требования к интеграции

Last updated 1 year ago

maibmerchants - портал предназначенный для Мерчантов, где они выполняют необходимые настройки для интеграции веб-сайта/приложения с maib e-commerce API. Также здесь Мерчант может просматривать информацию о транзакции, выполнять некоторые действия (возврат платежа) и имеет доступ к некоторым дополнительным функциям.

Портал находится в постоянном развитии, и в будущем он будет содержать другие функции, которые улучшат опыт электронной коммерции Мерчанта.

maib ecomm - система maib, которая обрабатывает транзакции электронной торговли.

maib ecomm checkout - страница на которую Покупатель перенаправляется для ввода данных карты (или оплаты через Apple Pay™ / Google Pay™). Мерчант имеет возможность изменить страницу maib ecomm checkout. По запросу Мерчант получит шаблон страницы и инструкцию, согласно которой он будет вносить изменения.

e-commerce решение - представляет собой веб-сайт или приложения, которые предлагают такие функции, как каталогизация продуктов, обработка платежей и управление заказами. Цель таких решений — облегчить онлайн-продажи и обеспечить удобство покупок как для продавцов, так и для покупателей.

Мерчант - субъект предпринимательской деятельности, владеющий решением для электронной коммерции и инициирующий интеграцию с maib e-commerce для приема онлайн-платежей

Проект - сущность на платформе maibmerchants, содержащая информацию и настройки, связанные с интеграцией решения с maib e-commerce.

Для каждого решения e-commerce будет создан проект с необходимыми настройками:

  1. Домен - относится к домену решения электронной коммерции (веб-сайт/приложение). Торговец должен иметь право собственности на домен.

  2. IP - относится к IP-адресу сервера/хостинга, на котором размещено решение e-commerce.

  3. Платформа - относится к платформе, используемой для построения/разработки и управления решением e-commerce. Это может быть CMS (система управления контентом), framework или конкретный язык программирования.

  4. Callback URL - это ссылка, на которую maib ecomm будет отправлять уведомления с окончательным ответом, содержащим состояние и данные транзакции. Этот URL должен быть доступен и готов к приему и обработке уведомлений.

  5. Ok URL - это ссылка, на которую покупатель будет перенаправлен в случае успешной транзакции. После завершения оплаты покупатель будет перенаправлен на этот URL, чтобы получить подтверждение и детали транзакции.

  6. Fail URL - это ссылка, на которую покупатель будет перенаправлен в случае неудачной транзакции. Если что-то не работает должным образом во время процесса оплаты или если транзакция отклонена, покупатель будет перенаправлен на этот URL, чтобы получить уведомление о неудаче транзакции.

Project Secret - используется вместе с Project ID для генерации токена доступа, испозуемого для авторизации запросов к maib ecomm.

Signature Key - используется для проверки уведомлений о статусе транзакции на Callback URL. Дополнительные сведения см. в разделе .

Промежуточный ответ - ответ Мерчанту от maib ecomm, содержащий идентификатор транзакции и ссылку на страницу maib ecomm checkout.

Окончательный ответ - ответ Мерчанту (на Callback Url) от maib ecomm, содержащий статус и основные данные транзакции. Callback Url задается в maibmerchants, но также может быть отправлен в запросе.

Тестовый проект

Тестовый проект предназначен для выполнения транзакций в тестовой среде. В тестовой среде можно осуществлять все типы платежей, предусмотренные в API: прямые платежи, двухэтапные платежи, регулярные платежи и one-click платежи.

Производственный Проект

Производственный проект предназначен для совершения реальных транзакций и может быть активирован только после подписания договора e-commerce и настройки проекта в платформе maibmerchants (Домен/Платформа/IP/Callback URL/Ok URL/Fail URL).

После активации Проекта будут доступны Project Secret и Signature Key для интеграции вашего решения с maib ecommerce API.

Проведение тестов является одним из обязательных условий для активации Производственного проекта. Проведите успешные тесты в соответствии с эндпоинтами для , который вы хотите использовать, используя тестовые .

Уведомления на Callback Url
типа платежа