> 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/plugins-and-solutions/cartum.md).

# Cartum

You can familiarize yourself with the integration steps and website requirements [here](/e-commerce/integration-steps-and-requirements.md).

To test the integration, you will need access to a Test Project (*Project ID / Project Secret / Signature Key*). For this, please submit a request to the email address: <ecom@maib.md>.

To process real payments, you must have the e-commerce contract signed and complete at least one successful transaction using the Test Project data and test [card details](#user-content-fn-1)[^1].

After signing the contract, you will receive access to the **maibmerchants** platform and be able to activate the Production Project.

### Project activation in maibmerchants

<div><figure><img src="/files/vzmHXt1on0ikxbLY4PMV" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="/files/0TF26347UGRe2yb6cqWz" alt=""><figcaption><p>2</p></figcaption></figure> <figure><img src="/files/XJ9YDt0o0J5YGw3w6ERl" alt=""><figcaption><p>3</p></figcaption></figure></div>

To activate the Project, please fill in all fields and click the **Activate** button.

**Domain** - website domain (e.g.: *shop.cartum.ro* or *domain.md*)

**Platform** - select **Cartum**

**IP** - enter the following text: **\*.\*.\*.\***

**Callback URL** - enter the link to your site (eg: *<https://domain.md>*)

**Ok URL** - enter the link to your site (eg: *<https://domain.md>*)

**Fail URL** - enter the link to your site (eg: *<https://domain.md>*)

Upon successful project activation, the *Project Secret* and *Signature Key* will become available, which need to be copied into the corresponding fields of the maib payment method settings in Cartum.

### Settings on the Cartum platform

<div align="left"><figure><img src="/files/UbcCVZomejEfeu1ZFtct" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="/files/RtGIEGX8rS1oXUjXUfp0" alt=""><figcaption><p>2.1</p></figcaption></figure> <figure><img src="/files/pLnIZlXlOVf3nbOQiWAP" alt=""><figcaption><p>2.2</p></figcaption></figure> <figure><img src="/files/EEiQMc5F6xyjODdDu4UI" alt=""><figcaption><p>2.3</p></figcaption></figure> <figure><img src="/files/EaYfg2ClcSWr2AQujo3e" alt=""><figcaption><p>3.1</p></figcaption></figure> <figure><img src="/files/CYcK8LMiHF2Sc5dFqkEn" alt=""><figcaption><p>3.2</p></figcaption></figure></div>

#### 1. Configuring maib payment provider

Log in to your **Cartum** account and navigate to:

*Settings -> Payment providers -> **maib***

Make the necessary settings and save:

**Project ID** - Project ID on the maibmerchants platform.

**Project Secret** - Project secret key on the maibmerchants platform. It is available upon project activation.

**Signature Key** - Project signature key on the maibmerchants platform. It is available upon project activation.

#### 2. Configuring payment method

Access *Settings → Payment methods*

Choose the payment method with the **maib** type, make the necessary settings and save:

**Active** - check to activate the payment method;

**Type** - choose the payment method **maib**;

**Title** - the name of the **maib** payment provider as the customer will see it during checkout. Add the following text: *Pay Online*

**Description** - the description of the maib payment method as the customer will see it during checkout. Add the following text: *Visa / Mastercard / Apple Pay / Google Pay*

**Logo** - the payment provider logo in the website footer; upload the image below:

<div align="left"><figure><img src="/files/HqwQfrZOEPCXy3EqdiXD" alt=""><figcaption></figcaption></figure></div>

**URL** - link for the payment provider logo in the website footer; add the following link: *<https://maib.md>*

**Alt for logo** - the name of the payment method for the payment method logo; add the following text: *maib*

#### 3. Configuring shipping methods

After configuring and activating the payment method, you need to select for which shipping methods this payment method will be available.

Access *Settings → Shipping methods and carriers*

Edit available shipping methods or click the **Add** button to add a new shipping method. Perform the necessary settings and save:

**Title** - the name of the delivery option as the buyer will see it during checkout;

**Type** - choose the shipping method;

**Payment** - select the **maib** payment option based on the name you gave it when configuring the payment method;

**Active** - check to activate the shipping method.&#x20;

[^1]: Card holder: Test Test

    Card number: 5102180060101124

    Exp. date: 06/28

    CVV: 760