# Joy and Shopney

{% hint style="info" %}
This integration is available for: **Ultimate only**
{% endhint %}

### Overview

[Shopney](https://shopney.co) is a mobile app builder that lets Shopify merchants create a branded iOS and Android app without coding. By connecting Joy Loyalty with Shopney, you can surface your loyalty program — points balance, rewards, VIP tiers, and referrals — directly inside your mobile app, giving customers a seamless way to earn and redeem on the go.

***

### How to set up

{% stepper %}
{% step %}
**Open the Joy Loyalty app**

In your Shopify admin, go to **Apps** and open **Joy: Loyalty Program**.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-a24d1cf20361e250617b765f4a19174aa0653c23%2Fimage%20(601).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Generate your API credentials**

Inside Joy, go to **Settings** → **Developers**. In the **Manage keys** card, click **Generate key** to create your credentials.

{% hint style="warning" %}
Generating a new key invalidates any previously issued key. If you've already connected another app using an existing key, you'll need to re-enter the new key in that app.
{% endhint %}

Once generated, click the clipboard icon next to **App ID** and **Secret key** to copy each value.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-39101738f15e5f6b1b1de5b4325df707716ffd1c%2Fimage%20(602).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Open Joy Loyalty in Shopney's Integrations**

In your Shopney dashboard, go to the **Integrations** section and click **Joy Loyalty App**.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-cd6d0acb4c11c239a7d7bd31a9942c4d8b7680f1%2Fimage%20(603).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Paste credentials and activate**

Paste your **App ID** and **Secret key** into the corresponding fields. Switch the **Enable** toggle on, then click **Save Changes**.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-2664f83e4193da82ca67e434a20f49880d0bfe97%2Fimage%20(604).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Add the Loyalty element to your app menu and showcase**

To make the loyalty page accessible for your customers, you need to add the Loyalty element to your app's menu and/or showcase.

**Menu:** In Shopney's **Design** section, click the **Menu** tab. Drag and drop the **Loyalty** element into your app's menu, configure it from the right panel, then click **Save & Update**.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-8cf1db6f0a2b0cbd38803ee81cbd9aa8eb1e6dd0%2Fimage%20(605).png?alt=media" alt=""><figcaption></figcaption></figure>

**Showcase:** In the **Design** section, click the **Showcase** tab. Drag and drop the **Loyalty** element into your showcase, configure it from the right panel, then click **Save & Update**.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-e54c4b09f39cfabccb6f0baa2b1452c4058de2a3%2Fimage%20(606).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Once you complete the steps above, the Joy Loyalty integration will be active and fully functional in your Shopney app.

***

### FAQ

**Do I need to generate a new key for each integration?**\
No. Your App ID and Secret key can be reused across integrations. Only click **Generate key** again if your key is compromised or you need to revoke access — doing so will invalidate the old key and any connected apps will stop working until you re-enter the new key.

**Which Joy plan is required for this integration?**\
The Shopney integration requires the **Ultimate plan**.

**I can't see the integration working — how do I preview it?**\
Make sure you have downloaded the latest version of the **Shopney Preview** app on your phone. Older versions may not reflect recent integration updates. Update the Preview app from the App Store or Google Play, then reload your store inside the app.

***

### Need help?

Contact Joy support at <support@joy.so> or visit [help.joy.so](https://help.joy.so) for more documentation.
