> 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/terminologiya.md).

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

**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. Дополнительные сведения см. в разделе [Уведомления на Callback Url](/e-commerce/ru/uvedomleniya-na-callback-url.md).

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

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

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

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

{% hint style="info" %}
Проведение тестов является одним из обязательных условий для активации Производственного проекта. Проведите успешные тесты в соответствии с эндпоинтами для [типа платежа](/e-commerce/ru/tipy-platezhei.md), который вы хотите использовать, используя тестовые [данные карты](#user-content-fn-1)[^1].
{% endhint %}

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

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

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

[^1]: Cardholder: Test Test

    Card number: 5102180060101124 

    Exp. date: 06/28 

    CVV: 760