> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattildapayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Magento Configuration

Within the Magento dashboard you can access the module configuration by
going to **Stores** -> **Settings** -> **Configuration** -> **Sales** ->
**Payment Methods** -> **Gr4vy**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/mattilda/assets/images/magento/config.png" alt="Config" />
</Frame>

There are three configuration sections.

## **API Configuration**

This contains the basic set up. You will need to fill in
the `Gr4vy ID`, `Private Key`, and `Environment` fields based on your environment.

<Frame>
  <img src="https://mintcdn.com/mattilda/NYRslQ0epuL-JaEH/assets/images/magento/api_configuration.png?fit=max&auto=format&n=NYRslQ0epuL-JaEH&q=85&s=7480a5a93793cb905b214982c5761a63" alt="API Configuration" width="1122" height="1134" data-path="assets/images/magento/api_configuration.png" />
</Frame>

### API key

To use Magento you will need to generate a new **API key**. Head over to
your dashboard and visit the **Integrations** page.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/mattilda/assets/images/api-keys/add-key.png" alt="API key dashboard" />

On this page, click the **Add API key** button, and select a name for your key. The name is purely for you to
track what key is for what integration. You will need to upload the downloaded key
to Magento via the configuration panel.

When creating an API key for Magento we recommend restricting the permissions for this key to **Processing only**.
Additionally, in a Multi-Merchant environment, we recommend you restrict it to the targeted
merchant account only.

## Options

This allows you to further configure the behavior of the plugin.

<Frame>
  <img src="https://mintcdn.com/mattilda/NYRslQ0epuL-JaEH/assets/images/magento/config_options.png?fit=max&auto=format&n=NYRslQ0epuL-JaEH&q=85&s=911cd871ca875350714f73d851f358ad" alt="Options" width="1434" height="604" data-path="assets/images/magento/config_options.png" />
</Frame>

## Theming

Control of the theming of the Embed plugin used in Magento. See
[Embed theming](/guides/payments/embed/theming) for more details.

<Frame>
  <img src="https://mintcdn.com/mattilda/NYRslQ0epuL-JaEH/assets/images/magento/config_theme.png?fit=max&auto=format&n=NYRslQ0epuL-JaEH&q=85&s=5643d33e84d90bf5c9d1b082091822cb" alt="Theming" width="1872" height="322" data-path="assets/images/magento/config_theme.png" />
</Frame>

## **Webhook Configuration**

The plugin supports handling incoming webhooks for asynchronous transaction status updates.  To support webhooks you'll need to setup the Magento Plugin webhook URL `{{magento2_url}}/gr4vy/webhook/order`.