> For the complete documentation index, see [llms.txt](https://doc.ecomm.api.tietoevry.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ecomm.api.tietoevry.com/integrations/plug-ins/magento-2.md).

# Magento 2

## **Requirements**

Before installing the extension, ensure your environment meets the following requirements:

* Magento version: 2.4.7
* PHP version: 8.3

> Using an unsupported version of Magento or PHP may result in unexpected behavior.

## **Installation Instructions**

Follow these steps to install the **E-commerce Gateway extension:**

1. **Navigate to the Magento 2 code directory**

Go to your Magento installation path:

> magento2/app/code

{% hint style="info" %}
If the code directory does not exist, create it manually.
{% endhint %}

2. **Extract the extension files**

Unzip the downloaded extension package and place its contents into:

> magento2/app/code

Folder structure should look like:

> magento2/app/code/Tietoevry/EGW

3. **Enable the extension via command line**

Open a terminal and navigate to the root of your Magento installation and then run the following commands:

> php bin/magento module:enable Tietoevry\_EGW\
> php bin/magento setup:upgrade\
> php bin/magento cache:flush

The extension is now installed and ready for configuration.

## **Configuration Instructions**

The payment methods provided by the E-commerce Payment Gateway extension are disabled by default. To enable and configure them:

1. **Log in to the Magento Admin Panel**

By default, this is accessible at:

> https\://\<your\_domain>/admin

2. **Navigate to the configuration settings**

In the left-hand menu, go to:

> Stores → Configuration
>
> <img src="https://1349856663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuxLHJOqJIapfeJ1Ei4Hr%2Fuploads%2FFFhQcsuQcVsOHQAWs4D4%2Fconfig_1_ar.jpg?alt=media&amp;token=e9d12b0a-aacb-4db4-8a96-75cfca7f4a32" alt="" data-size="original">

3. **Access payment method settings**

Under the **Sales** section, click on **Payment Methods**.

<figure><img src="https://1349856663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuxLHJOqJIapfeJ1Ei4Hr%2Fuploads%2FxGs8TTePaEl6eGOdzUH2%2Fconfig_2_ar.jpg?alt=media&amp;token=36405ee8-6f15-49cf-86fd-f85da7cc9f8b" alt=""><figcaption></figcaption></figure>

4. **Locate the E-commerce Gateway settings**

Scroll to the **Other Payment Methods** section and find **Tietoevry E-commerce Payment Gateway**.

5\. Configure the extension:

\- Set **Enabled** to **Yes** to activate the payment methods.\
\- Choose the desired Environment:\
  - Sandbox (recommended for testing)\
  - Live (for production use)\
\- Enter your OAuth2 credentials as provided by Tieto.

<figure><img src="https://1349856663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuxLHJOqJIapfeJ1Ei4Hr%2Fuploads%2F60UtCL23G9t8GYFqgtna%2Fconfig_3_v1.jpg?alt=media&amp;token=cf46af27-c72f-4570-8d73-68c42f194225" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
We recommend thoroughly testing in the sandbox environment before switching to live mode.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.ecomm.api.tietoevry.com/integrations/plug-ins/magento-2.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
