# 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 %}