# Cartum

Cu etapele de integrare și cerințele către website puteți face cunoștință [aici](https://docs.maibmerchants.md/e-commerce/ro/etape-si-cerinte-pentru-integrare).

Pentru a testa integrarea veți avea nevoie de datele de acces a unui Proiect de Test (*Project ID / Proejct Secret / Signature Key*). Pentru aceasta vă rugăm să veniți cu o solicitare la adresa de email: <ecom@maib.md>.

Pentru a efectua plăți reale, trebuie să aveți contractul e-commerce semnat și să efectuați cel puțin o tranzacție reușită folosind datele Proiectului de Test și [datele cardului](#user-content-fn-1)[^1] pentru teste.&#x20;

După semnarea contractului veți primi acces la platforma **maibmerchants** și veți avea posibilitatea să activați Proiectul de Producție.

### **Activare Proiect în maibmerchants**

<div><figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2F4vW8KD14KbxBNXUk4ddk%2F1.PNG?alt=media&#x26;token=10ba9a04-24f3-40d9-b267-709f1fa6244c" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2FfSlO1sV12bFt25XWvDwG%2F2.PNG?alt=media&#x26;token=554cfbd8-9f91-4dab-8937-296523e7c8c3" alt=""><figcaption><p>2</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2F6OhDlrheLRCfQA1HDI7U%2F3.PNG?alt=media&#x26;token=14ef518d-cbb4-4a68-a3fa-9f46cbc33fe7" alt=""><figcaption><p>3</p></figcaption></figure></div>

Pentru a activa Proiectul completați toate cîmpurile și accesați butonul **Activare*****.***

**Domeniu** - domeniul website-ului dvs. (de ex. *shop.cartum.md* sau *domeniu.md*)

**Platformă** - selectați **Cartum**

**IP** - introduceți: **\*.\*.\*.\***

**Callback URL** - introduceți link către website-ul dvs (de ex. *<https://domeniu.md>*)

**Ok URL** - introduceți link către website-ul dvs (de ex. *<https://domeniu.md>*)

**Fail URL** - introduceți link către website-ul dvs (de ex. *<https://domeniu.md>*)

La Activarea cu succes a Proiectului vor fi disponibile *Project ID*, *Project Secret* și *Signature Key* care trebuie să le copiați în cîmpurile respective din setările metodei de plată **maib** pe platforma Cartum.

### **Setări pe platforma Cartum**

<div><figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2F8rJOeokAzTEcgeBdlJrK%2F1.PNG?alt=media&#x26;token=9b3df5ae-9389-40ac-8fdf-c9a4313dd913" alt=""><figcaption><p>1</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2Ffb8AgW0PAtKHhxXXSVOk%2F2_1.PNG?alt=media&#x26;token=9516467e-04a1-4bed-a693-211a22149100" alt=""><figcaption><p>2.1</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2FcD60ukwZZBX9xPw63y5m%2F2_2.PNG?alt=media&#x26;token=a2aa3246-7054-43d4-a0c4-b2ddb3c17ad6" alt=""><figcaption><p>2.2</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2FjZBo8rCTdivX3G5CxGbj%2F2_3.PNG?alt=media&#x26;token=915642d1-0ad0-4c16-9462-4827e319a9d0" alt=""><figcaption><p>2.3</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2FzWP59B3dHM5cFjCT9FHE%2F3_1.PNG?alt=media&#x26;token=906d7377-6b39-41f0-be3d-5781b5bfbc86" alt=""><figcaption><p>3.1</p></figcaption></figure> <figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2FnlPMsjDAAVweO2cp2bSg%2F3_2.PNG?alt=media&#x26;token=d86c8a27-7c40-4468-8dd7-ea8cd6671b58" alt=""><figcaption><p>3.2</p></figcaption></figure></div>

#### **1. Configurarea metodei de plată maib**

Logați-vă în contul dvs. Cartum și accesați:

*Setări → Sisteme de plată -> **maib***

Efectuați setările necesare și salvați:

**Project ID** - ID Proiect în maibmerchants;

**Project Secret** - Project Secret din Proiect în maibmerchants. Este disponibil la activarea Proiectului;

**Signature Key** - Signature Key din Proiect în maibmerchants. Este disponibil la activarea Proiectului;

#### 2. Configurarea opțiunii de plată maib

Accesați *Setări → Opțiuni de plată*

Alegeți opțiunea de plată cu tipul **maib**, efectuați setările necesare și salvați:

**Activat** - bifați pentru a activa opțiunea de plată;

**Tip** - alegeți metoda de plată **maib**;

**Nume** - denumirea metodei plată **maib** cum o va vedea cumpărătorul la achitare. Adăugați următorul text: *Achită online*

**Descriere** - descrierea metodei plată **maib** cum o va vedea cumpărătorul la achitare. Adăugați următorul text: *Visa / Mastercard / Apple Pay / Google Pay*

**Logo** - logo-ul metodei de plată în footer website; încărcați imaginea de mai jos:

<div align="left"><figure><img src="https://109545076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15y2IL07pJBxRX7U52WU%2Fuploads%2FUb8Bgy5zeUtjKEzlLgwP%2Fmaib-logo.png?alt=media&#x26;token=4e5caea5-c0eb-452c-a650-7970dbdb5029" alt=""><figcaption></figcaption></figure></div>

**URL** - link pentru logo-ul metodei de plată din footer website; adăugați următorul link: *<https://maib.md>*

**Alt** - denumirea metodei de plată pentru logo-ul metodei de paltă; adăugați următorul text: *maib*

#### 3. Configurarea opțiunilor de livrare&#x20;

După configurarea și activarea metodei de plată, trebuie să selectați pentru ce opțiuni de livrare va fi disponibilă această metodă de plată.

Accesați *Setări → Opțiuni de livrare*

Redactați opțiunile de livrare disponibile sau accesați butonul **Adăugați** pentru a adăua o opțiune de livrare nouă. Eectuați setările necesare și salvați:

**Nume** - denumirea opțiunii de livrare cum o va vedea cumpărătorul la achitare;

**Tip** - alegeți metoda de livrare;

**Opțiuni de plată** - alegeți opțiunea de plată **maib** după denumirea pe care i-ați dat-o la configurarea opțiunii de plată;

**Activ** - bifați pentru a activa opțiunea de livrare;

[^1]: Card holder: Test Test

    Card number: 5102180060101124

    Exp. date: 06/28

    CVV: 760