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.
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.
How the points are worked out
For each returned item markedyuko_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
I approved a return but no points were credited. Why?
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.Can I refund some items as points and others another way?
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.Does the customer get notified?
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
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.
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.