Skip to main content
Where to find this: Shopify admin → Apps → Yuko Loyalty → Integrations → Return Prime

Introduction

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

Yuko app is installed on your Shopify store — see Install Yuko on Shopify.
The Yuko Theme App Embed is enabled in your active theme — see Theme App Embed.
Your loyalty program is enabled under Loyalty Program Status at Shopify admin → Apps → Yuko Loyalty → Loyalty → Programs.
Your point labels are set in Loyalty Settings.
Return Prime is installed on your Shopify store.
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.
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.
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

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.
Yes. Only the items whose refund mode is set to Others with yuko_rp_credit are credited as points.
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.

REST API

Read and write Yuko data programmatically.

Webhooks

Receive real-time event notifications.

Shopify Flow

Trigger Shopify Flow workflows from Yuko loyalty, VIP and referral events.

Shopify POS

Redeem points and apply loyalty discounts at the till.

Klaviyo

Sync customers, points and tier data into Klaviyo.

Mailchimp

Sync loyalty merge fields and events into a Mailchimp audience.

Omnisend

Sync loyalty data into Omnisend.

WhatsApp

Send transactional loyalty messages via 14 supported WhatsApp Business API providers.

Retainful

Email marketing & abandoned cart recovery.

Judge.me

Award loyalty points for Judge.me reviews.

Return Prime

Refund approved returns as loyalty points.

Book a Free Setup Call

Talk to our team for personalised setup help.Time: 30 minutes

Contact Support

Visit our support hub for help articles, live chat and ticket submission.

Browse the Guides

Documentation across loyalty, referrals, memberships and more.

Install Yuko

Add Yuko to your Shopify store from the Shopify App Store.