# Cartum

Подробнее об этапах интеграции и требованиях к сайту можно узнать [здесь](https://docs.maibmerchants.md/e-commerce/ru/etapy-i-trebovaniya-k-integracii).

Чтобы протестировать интеграцию, вам понадобятся данные доступа к тестовому проекту (*Project ID / Project Secret / Signature Key*). Для этого просим вас отправить запрос на электронную почту: <ecom@maib.md>.

Для осуществления реальных платежей вам необходимо заключить договор e-commerce и выполнить как минимум одну успешную транзакцию, используя данные тестового проекта и [данные карты](#user-content-fn-1)[^1] для тестирования.

После подписания договора вы получите доступ к платформе maibmerchants и сможете активировать Производственный Проект.

### Активация Проекта в maibmerchants

<div><figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FsQvNudNhSBvtOMxC3FO5%2F1.PNG?alt=media&#x26;token=db49eb21-ad4c-44da-8749-762d5739fb6c" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2Fg8vbgNbo7j6uMbnvBCOk%2F2.PNG?alt=media&#x26;token=399589d1-82a8-43b6-bea1-e388ec725831" alt=""><figcaption><p>2</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FIWBxM7LFGVc8dS8wsqAP%2F3.PNG?alt=media&#x26;token=524a5876-41d2-481c-82b3-97ae454b5852" alt=""><figcaption><p>3</p></figcaption></figure></div>

Чтобы активировать Проект, заполните все поля и нажмите кнопку «Активировать».

**Домен** - домен сайта (например: *shop.cartum.md* или *domain.md*)

**Платформа** - выберите **Cartum**

**IP** - введите: **\*.\*.\*.\***

**Callback URL** - введите ссылку на ваш сайт (например: *<https://domain.md>*)

**Ok URL** - введите ссылку на ваш сайт (например: *<https://domain.md>*)

**Fail URL** - введите ссылку на ваш сайт (например: *<https://domain.md>*)

При успешной активации проекта станут доступны *Project Secret* и *Signature Key*, которые необходимо скопировать в соответствующие поля настроек способа оплаты **maib** в Cartum.

### Настройки на платформе Cartum

<div><figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2Fkc7r9rxWLfUJ5RK8qhfi%2F1.PNG?alt=media&#x26;token=aefd7bbe-ffd8-4d17-b2fa-0ece27c77b95" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FULGYjInBPlVDRWeQVcFZ%2F2_1.PNG?alt=media&#x26;token=06085ed1-de89-4494-a0a1-37bba19c826f" alt=""><figcaption><p>2.1</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FP6x438p9W2kve70jruKm%2F2_2.PNG?alt=media&#x26;token=83aada10-9330-4cfb-9d39-9477a2d622b9" alt=""><figcaption><p>2.2</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2Fb5Pgs1wnbNcOEcvMbnTs%2F2_3.PNG?alt=media&#x26;token=68d00910-e94c-4220-820c-79edcc54996f" alt=""><figcaption><p>2.3</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FiEa82oniwLHtBi9rIjQr%2F3_1.PNG?alt=media&#x26;token=d376d161-413e-40ee-b748-19db03a5c872" alt=""><figcaption><p>3.1</p></figcaption></figure> <figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FpfiCykosSlkX2n7v0TJ7%2F3_2.PNG?alt=media&#x26;token=8c3a172c-2088-404d-9712-08172bbb351a" alt=""><figcaption><p>3.2</p></figcaption></figure></div>

#### 1. Настройка платежной системы maib

Войдите в свой аккаунт на **Cartum** и перейдите здесь:

*Настройки → Платежные системы -> **maib***

Сделайте необходимые настройки и сохраните:

**Project ID** - ID проекта на платформе maibmerchants.

**Project Secret** - Секретный ключ проекта на платформе maibmerchants. Он доступен при активации проекта.

**Signature Key** - Ключ подписи проекта на платформе maibmerchants. Он доступен при активации проекта.

#### 2. Настройка варианта оплаты maib

Зайдите в *Настройки → Варианты оплаты*.

Выберите вариант оплаты с типом **maib**, сделайте необходимые настройки и сохраните:

**Включено** - поставьте галочку, чтобы активировать опцию платежа;

**Тип** - выберите способ оплаты **maib**;

**Название** - наименование способа оплаты **maib**, которое увидит покупатель при оплате. Добавьте следующий текст: *Оплатить онлайн*

**Описание** - описание способа оплаты **maib**, которое увидит покупатель при оплате. Добавьте следующий текст: *Visa / Mastercard / Apple Pay / Google Pay*

**Логотип** - логотип способа оплаты в футер веб-сайта; загрузите изображение ниже:

<div align="left"><figure><img src="https://1079170279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAT4z9CaFRZUR6GeFEd2i%2Fuploads%2FLENRofHwNWIEyd3E9zeT%2Fmaib-logo.png?alt=media&#x26;token=44a4798c-1f08-4ed0-b25a-454f80e490ed" alt=""><figcaption></figcaption></figure></div>

**Ссылка** - ссылка для логотипа метода оплаты в футер веб-сайта; добавьте следующую ссылку: *<https://maib.md>*

**Alt для логотипа** - название метода оплаты для логотипа; добавьте следующий текст: *maib*

#### 3. Настройка вариантов доставки

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

Перейдите в *Настройки → Опции доставки*

Конфигуруйте доступные варианты доставки или нажмите кнопку **Добавить**, чтобы добавить новый вариант доставки. Выполните необходимые настройки и сохраните:

**Название** - название варианта доставки, которое увидит покупатель при оплате;

**Тип** - выберите метод доставки;

**Варианты оплаты** - выберите метод оплаты **maib** по названию, которое вы указали при настройке варианта оплаты;

**Включено** - поставьте галочку, чтобы активировать вариант доставки;<br>

[^1]: Card holder: Test Test

    Card number: 5102180060101124

    Exp. date: 06/28

    CVV: 760