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

# Shopify

## Prerequisite

{% hint style="info" %}
When you register with iPay for the first time, you get a test account and test merchant key. This is to help you complete your integration and test your setup using our test mobile money numbers **0260000000** and **0240000000**.
{% endhint %}

To successfully complete the integration and send requests the following details are required as described in table:

| REQUIREMENTS    | DESCRIPTION                                                                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Shopify Account | <p>An active shopify account. <br><a href="https://www.shopify.com/">Click here</a> to create a shopify account if you haven't done that already.</p>                                       |
| iPay Account    | <p>An iPay account to integrate into shopify. <a href="https://manage2.ipaygh.com/xmanage/get-started"><br>Click here</a> to create an iPay account if you haven't created one already.</p> |
| Merchant ID     | Unique iPay merchant ID.                                                                                                                                                                    |
| Merchant Key    | This is a unique key created by iPay for third parties doing integration.                                                                                                                   |

{% hint style="success" %}
Your **`merchant id`** and **`merchant key`**. You can find them in your **Account profile** (under the **Account management** tab in your iPay account dashboard).
{% endhint %}

{% hint style="info" %}
**iPay for Shopify currently supports only sites that have Ghana cedis (GHS) as a default currency.**
{% endhint %}

## Integrate your Shopify store

To integrate your shopify site, follow the steps below:

### Steps

:ballot\_box\_with\_check:Visit [iPay-Shopify-payments](https://www.shopify.com/login?redirect=%2Fadmin%2Fauthorize_gateway%2F1054045) \
\
:ballot\_box\_with\_check:Click "**`Install Payment provider`**". \
\
:no\_entry: Note: Kindly ensure you have an active Shopify site and you are logged into your site's admin panel.\
\
:ballot\_box\_with\_check:Once iPay is installed, click the **`Edit Button`** next to **iPay Ghana Payment Gateway** (under Alternative Payments providers tab in your settings).\
\
:ballot\_box\_with\_check:Provide your merchant id and merchant key.\
\
:ballot\_box\_with\_check:Save your settings and test your setup on your website using our test numbers **0240000000 or 0260000000**.

### What next after setup

Once you are ready to receive LIVE payments, complete the 3 step activation process on the "`Getting Started` Tab" in your iPay account dashboard to request activation of your account to the BASIC plan.

{% hint style="info" %}
This mode activates your LIVE merchant Key which you will use in your integration to make and receive LIVE mobile money payments only into your account and enable settlements to your remittance account details configured.&#x20;

:no\_entry: Please note, account activation is given based on completed and tested site integration.
{% endhint %}

{% hint style="info" %}
You may request for upgrade of your account to STANDARD plan after account activation, to enable you receive VISA and MasterCard payments in addition to mobile money payments.
{% 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 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.ipaygh.com/ipay-plugins/all-plugins/shopify.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.