Blog/

How D2C Brands Run Returns Inside WhatsApp With the Return Prime API

Pankaj Arora - Principal Product Manager
Pankaj Arora
November 16, 2026
4 Mins
read
return rate optimization checklist for fashion brands

Kwik Summary: You can let customers start a return or exchange from a WhatsApp chat by connecting your chat flow to Return Prime's fetch-order API. The bot asks for the order number and email, calls the API, and takes the customer straight into the return or exchange request for that order. Two merchants on Return Prime have built this, and one of them made 36,408 API requests in a single week.

Why are brands moving returns into WhatsApp?

Because that is where the customer already started the conversation. When someone messages "I want to return this" on WhatsApp, sending them to a separate portal adds a step and a link they may never open. Building the request into the chat removes that step.

Two of our merchants have built their own WhatsApp interface for returns. One is the heaviest Open API user in our tracked week, with 36,408 requests. The other, Bluetyga, made 620. Same build, very different volumes, which tells you this works for a small store as well as a large one.

How does a WhatsApp returns flow work with Return Prime?

The full setup is in our chatbot integration guide. It runs in four steps:

  1. The customer messages your WhatsApp number and the bot asks for their order number and email.
  2. The bot calls Return Prime's fetch-order API, a GET request, with four parameters (table below).
  3. On success, the customer is taken to the Return Prime request page for that order, where they raise the return or exchange.
  4. On failure, the API returns a response with success set to false, an event name and a message. Your bot should read that message and reply in plain language, for example "We couldn't find that order. Can you check the number?"
  • order_number: The Shopify order name (e.g. #RCOM1234)
  • email: The customer’s email address (e.g. the email on the order)
  • store: Your Shopify store URL (e.g. xyz.myshopify.com)
  • channel_id: A unique ID Return Prime issues for each channel (e.g. 99998 for staging)

What do you need before you start?

  • A plan with API access. Open API and webhook access are included on the Grow plan at $19.99/month and on Scale. Thrive AI includes everything in Grow.
  • A channel ID. Use 99998 to test on staging. We share the production channel ID once your integration is done; ask us through live chat or help@returnprime.com.
  • A WhatsApp tool that can make API calls. Any chat platform that can send a GET request and read the response will work.

New to Return Prime? Start with how to install and set up Return Prime on Shopify.

How long does the build take?

You can connect a chatbot to Return Prime in a few hours.

How do customers get updates after they raise the return?

Use webhooks. Return Prime can send a POST request to your system when a request is approved, refunded or rejected, along with six other events, and your WhatsApp tool can turn each one into a message. Setup is in our webhooks guide.

Clear updates also cut repeat questions; we cover that in how return notifications reduce "where is my refund" support tickets.

FAQs

Can customers raise a Shopify return on WhatsApp with Return Prime?‍

Yes. Connect your WhatsApp chat flow to Return Prime's fetch-order API. The bot collects the order number and email, calls the API, and takes the customer into the return or exchange request for that order.

Which Return Prime plan includes API access?‍

Open API and webhook access are included on the Grow plan, which starts at $19.99/month, and on the Scale plan. Thrive AI includes all Grow features.

What is a channel ID and where do I get one?‍

A channel ID is a unique identifier Return Prime issues for each channel, such as a chatbot. Use 99998 on staging. We share your production channel ID once the integration is complete.

Can I send return status updates on WhatsApp?‍

Yes. Subscribe to Return Prime webhooks for events like request approved, refunded or rejected, and have your WhatsApp tool send a message when each event arrives.

Subscribe to Return Prime

Get the latest posts delivered right to your inbox

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
By submitting this form, you agree to Return Prime’s privacy policy.
Maximize your Revenue by one return at a time