> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.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://mintcdn.com/gr4vy/jCFeFdffXM43huI0/assets/images/magento/config.png?fit=max&auto=format&n=jCFeFdffXM43huI0&q=85&s=c3e4a8b448da5215001ccfe075f4bb52" alt="Configuration" width="1908" height="632" data-path="assets/images/magento/config.png" />
</Frame>

There are three configuration sections.

## API configuration

This contains the basic set up. Fill in
the `Gr4vy ID`, `Private Key`, and `Environment` fields based on the environment.

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

### API key

To use Magento, generate a new **API key**. Head over to
the dashboard and visit the **Integrations** page.

<img src="https://mintcdn.com/gr4vy/jCFeFdffXM43huI0/assets/images/api-keys/add-key.png?fit=max&auto=format&n=jCFeFdffXM43huI0&q=85&s=303f2845a0f3727c623ccf3cd98b2ad1" alt="API key dashboard" width="1413" height="1040" data-path="assets/images/api-keys/add-key.png" />

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

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

## Options

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

<Frame>
  <img src="https://mintcdn.com/gr4vy/jCFeFdffXM43huI0/assets/images/magento/config_options.png?fit=max&auto=format&n=jCFeFdffXM43huI0&q=85&s=dc7b1a0a59357e33808cb39e2e69c570" 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/gr4vy/jCFeFdffXM43huI0/assets/images/magento/config_theme.png?fit=max&auto=format&n=jCFeFdffXM43huI0&q=85&s=ee1ed562c9c477ed901879b2e6c94b5b" 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`.