> For the complete documentation index, see [llms.txt](https://docs.ippopay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ippopay.com/ecommerce-integrations/magento.md).

# Magento

## **Prerequisites**

* Sign up for a IppoPay account.
* Generate the API keys from the [IppoPay Dashboard](https://app.ippopay.com/dashboard) by navigating to Settings and then API Keys. You can use the Test mode keys for testing and later switch to Live mode keys when going live with the integration.

## Integration Steps

### Step 1: Install Extension

#### Installation Without Composer

* Download the code.zip file from the [latest release](https://marketplace.magento.com/ippopay-paymentgateway.html). Extract the zip.
* Place the code folder from Step 1 in your app folder. If you're performing an update, replace/overwrite the existing code folder.
* Enable and deploy the IppoPay module using commands
  * `bin/magento module:enable Ippopay_PaymentGatway`
  * `bin/magento setup:upgrade`
  * ~~`bin`~~`/magento cache:flush` 

### Step 2: Configure Magento Store

To configure your Magento store for IppoPay Payments 

1. Log into your Magento store.
2. Choose Stores on the Admin sidebar to the left. Now go to Settings > Configuration.
3. In the Configuration page, click on Sales on the left and choose Payment Methods.
4. In the Payment Methods page, navigate to IppoPay.
5. Enter your test mode \[PUBLIC\_KEY] and \[SECRET\_KEY]. These can be generated from your [Dashboard](https://app.ippopay.com/signin).
6. Select Yes for the option Enabled.
7. Click Save Config. This activates your account in the Test Mode. You can use this account to make a few test payments to ensure a successful workflow. 

**Note: In test mode, no real money is deducted from your account.**

### Step 3: Accept Live Payments

After testing your Magento store, when you are ready to accept live payments:

1. [Generate the \[PUBLIC\_KEY\] and \[SECRET\_KEY\]](https://app.ippopay.com/settings/api) in the Live mode on your IppoPay Dashboard.
2. Enter the Live mode \[PUBLIC\_KEY] and \[SECRET\_KEY] in your Magento store.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.ippopay.com/ecommerce-integrations/magento.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.