# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maibmerchants.md/e-commerce/plugins-and-solutions/cartum.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.