> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yuko.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Return Prime

> Refund approved Return Prime returns to customers as loyalty points instead of money or store credit.

> [!NOTE]
>
> **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Integrations → Return Prime

## Introduction

[Return Prime](https://apps.shopify.com/return-prime) handles returns and exchanges for Shopify stores. With this integration, you can refund a return as **Yuko loyalty points**. When you approve the return in Return Prime, Yuko credits the customer with points worth the amount they paid for the returned items.

You choose which returns are refunded as points, request by request, in Return Prime.

## When to use

* You use Return Prime for returns.
* You want to offer loyalty points as a refund option, which keeps the value in your store.

## Before you start

> [!TIP]
>
> Yuko app is installed on your Shopify store — see [Install Yuko on Shopify](https://docs.yuko.so/installation-and-setup/install-on-shopify.md).

> [!TIP]
>
> The Yuko **Theme App Embed** is enabled in your active theme — see [Theme App Embed](https://docs.yuko.so/installation-and-setup/theme-app-embed.md).

> [!TIP]
>
> Your loyalty program is enabled under **Loyalty Program Status** at **Shopify admin → Apps → Yuko Loyalty → Loyalty → Programs**.

> [!TIP]
>
> Your point labels are set in [Loyalty Settings](https://docs.yuko.so/loyalty/program-settings.md).

> [!TIP]
>
> Return Prime is installed on your Shopify store.

> [!TIP]
>
> Your **Points to Cash Conversion Rate** is set in your loyalty program setup (**Loyalty → Programs**). Yuko uses it to turn the refund amount into points.

## Connect Return Prime

The setup guide on the Return Prime page in Yuko shows the same steps, with your webhook URL and a copy button.

**1. Open Return Prime in Yuko**

Go to **Apps → Yuko Loyalty → Integrations**, pick the **Returns & Exchanges** category and click **Return Prime**. Keep this page open; you'll need the webhook URL from the setup guide.

**2. Create an app in Return Prime**

In your Return Prime dashboard, go to **Settings → Integrations → Develop Apps**. Click **Create New App**, give it a name (for example, "Yuko Loyalty") and click **Save**.

**3. Copy the API key**

Open the app and copy its **API key**.

**4. Add the webhook**

Go to the app's **Webhooks** tab. Paste the **Webhook URL** from Yuko under **Where do you want to receive the webhooks?**, select the **Request approved** event and click **Save**.

**5. Connect in Yuko**

Back in Yuko, paste the key into **API key** and click **Connect Integration**. The page shows **Connected**.

After you connect, the Return Prime page in Yuko still shows the **Webhook URL** and the refund instructions.

> [!NOTE]
>
> Yuko also uses the API key to check that each webhook really comes from Return Prime. If you create a new key in Return Prime, disconnect and connect again with the new key.

## Refund a return as points

Points are only credited for items you mark for Yuko in Return Prime. For each return you want to refund as points:

**1. Open the return request**

In Return Prime, open the return request.

**2. Set the refund mode before approving**

Edit the refund information, choose **Others** and enter `yuko_rp_credit` as the note. Save. On the Return Prime page in Yuko, click `yuko_rp_credit` to copy it.

**3. Approve the request**

Approve the return. Return Prime sends the approval to Yuko, and Yuko credits the points.

> [!WARNING]
>
> Set the refund mode **before** you approve. Returns refunded with any other mode, such as store credit, the original payment method or bank transfer, don't earn points, so a customer is never refunded twice.

## How the points are worked out

For each returned item marked `yuko_rp_credit`, Yuko works out what the customer paid:

**price × returned quantity − discount**, plus tax when your prices don't include tax.

Yuko then converts that amount into points with your **Points to Cash Conversion Rate**, so the points are worth the refund. For example, if 100 points are worth $1, a $25 refund becomes 2,500 points.

* Each returned item is credited as its own points adjustment, with the reason *"Return refunded as points by Return Prime"*.
* An item is credited only once per return request, even if Return Prime sends the approval again.
* Only **returns** earn points. Exchanges are ignored.

## Requirements and limitations

* **Loyalty must be on.** If the loyalty program is turned off, nothing is credited.
* **The order must be in Yuko.** Yuko only credits returns for orders it has synced.
* **The customer must be in Yuko.** Yuko matches the Return Prime customer by Shopify customer ID first, then by email.
* **Only approved returns.** Other Return Prime events are ignored.
* **Shopify stores only.**

## FAQs

> [accordion] I approved a return but no points were credited. Why?
>
> Check that the refund mode was set to **Others** with the note `yuko_rp_credit` before you approved it, that the **Request approved** webhook is saved in your Return Prime app with the URL from Yuko, and that the order and customer exist in Yuko. Also check that your Points to Cash Conversion Rate is set.

> [accordion] Can I refund some items as points and others another way?
>
> Yes. Only the items whose refund mode is set to **Others** with `yuko_rp_credit` are credited as points.

> [accordion] Does the customer get notified?
>
> The credit is recorded as a points adjustment, so it shows in the customer's points history and balance. Return Prime doesn't send a points notification of its own.

## Related

> [card] [REST API](https://docs.yuko.so/integrations/rest-api.md)
>
> Read and write Yuko data programmatically.

> [card] [Webhooks](https://docs.yuko.so/integrations/webhooks.md)
>
> Receive real-time event notifications.

> [card] [Shopify Flow](https://docs.yuko.so/integrations/shopify-flow.md)
>
> Trigger Shopify Flow workflows from Yuko loyalty, VIP and referral events.

> [card] [Shopify POS](https://docs.yuko.so/integrations/shopify-pos.md)
>
> Redeem points and apply loyalty discounts at the till.

> [card] [Klaviyo](https://docs.yuko.so/integrations/klaviyo.md)
>
> Sync customers, points and tier data into Klaviyo.

> [card] [Mailchimp](https://docs.yuko.so/integrations/mailchimp.md)
>
> Sync loyalty merge fields and events into a Mailchimp audience.

> [card] [Omnisend](https://docs.yuko.so/integrations/omnisend.md)
>
> Sync loyalty data into Omnisend.

> [card] [WhatsApp](https://docs.yuko.so/integrations/whatsapp.md)
>
> Send transactional loyalty messages via 14 supported WhatsApp Business API providers.

> [card] [Retainful](https://docs.yuko.so/integrations/retainful.md)
>
> Email marketing & abandoned cart recovery.

> [card] [Judge.me](https://docs.yuko.so/integrations/judgeme.md)
>
> Award loyalty points for Judge.me reviews.

> [card] [Return Prime](https://docs.yuko.so/integrations/return-prime.md)
>
> Refund approved returns as loyalty points.

> [card] [Book a Free Setup Call](https://cal.com/rameshelamathi/yuko-demo)
>
> Talk to our team for personalised setup help.
>
> **Time:** 30 minutes

> [card] [Contact Support](https://yuko.so/support/)
>
> Visit our support hub for help articles, live chat and ticket submission.

> [card] [Browse the Guides](https://docs.yuko.so/getting-started/welcome.md)
>
> Documentation across loyalty, referrals, memberships and more.

> [card] [Install Yuko](https://apps.shopify.com/yuko)
>
> Add Yuko to your Shopify store from the Shopify App Store.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.