> 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="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FtDqn0l5YMqOa6OIiUBM3%2F1.PNG?alt=media&amp;token=6d34f092-2266-4689-80ff-aea4e05d62e1" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FnVl26pewViTElqSe8mqZ%2F2.PNG?alt=media&amp;token=08464c19-4f58-4f8c-a0ce-9040fa2598ff" alt=""><figcaption><p>2</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FohthICfImcEWzglq5XMA%2F3.PNG?alt=media&amp;token=adcac612-ec7e-42ae-8d11-2a0b02cfd2c3" 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="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FEGX0ruLNQS9V7d9OCCmx%2F1.PNG?alt=media&amp;token=26679519-2b1e-491d-a74f-29b9a573183f" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2F1LM18yEWMQzKxSQsj0fq%2F2_1.PNG?alt=media&amp;token=b84eb544-71a2-4d65-b165-b749277da2ab" alt=""><figcaption><p>2.1</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FOlOhXaWBAMb9U5QC6iwi%2F2_2.PNG?alt=media&amp;token=3fe98842-ab1d-48d8-81cd-1c7a70556291" alt=""><figcaption><p>2.2</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FUcbtmcvPuoiRoSusBdmF%2F2_3.PNG?alt=media&amp;token=db0f5141-c034-49d2-b61f-36a2d5af4d21" alt=""><figcaption><p>2.3</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2FBqv0TD11WxKRFtbYtuJX%2F3_1.PNG?alt=media&amp;token=e28cee6a-d70e-424a-a63f-5361557bc388" alt=""><figcaption><p>3.1</p></figcaption></figure> <figure><img src="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2F5wGENHeVHyyiYFL9J43i%2F3_2.PNG?alt=media&amp;token=58de673f-3fd8-45ee-ae57-5d56bf9cb0a3" 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="https://2209855812-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPDIM0OxcpQbz9TdR5jZJ%2Fuploads%2Fk6EE3VrBOii8FNJhlUMQ%2Fmaib-logo.png?alt=media&amp;token=89974e93-ac84-4bfe-b970-e00d97db9516" 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
