Терминология
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 будет создан проект с необходимыми настройками:
Домен - относится к домену решения электронной коммерции (веб-сайт/приложение). Торговец должен иметь право собственности на домен.
IP - относится к IP-адресу сервера/хостинга, на котором размещено решение e-commerce.
Платформа - относится к платформе, используемой для построения/разработки и управления решением e-commerce. Это может быть CMS (система управления контентом), framework или конкретный язык программирования.
Callback URL - это ссылка, на которую maib ecomm будет отправлять уведомления с окончательным ответом, содержащим состояние и данные транзакции. Этот URL должен быть доступен и готов к приему и обработке уведомлений.
Ok URL - это ссылка, на которую покупатель будет перенаправлен в случае успешной транзакции. После завершения оплаты покупатель будет перенаправлен на этот URL, чтобы получить подтверждение и детали транзакции.
Fail URL - это ссылка, на которую покупатель будет перенаправлен в случае неудачной транзакции. Если что-то не работает должным образом во время процесса оплаты или если транзакция отклонена, покупатель будет перенаправлен на этот URL, чтобы получить уведомление о неудаче транзакции.
Project Secret - используется вместе с Project ID для генерации токена доступа, испозуемого для авторизации запросов к maib ecomm.
Signature Key - используется для проверки уведомлений о статусе транзакции на Callback URL. Дополнительные сведения см. в разделе Уведомления на 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.
Last updated