Wardrowbe Partner Integration: From Feed to First Sale

This is the practical companion to the Wardrowbe Partners announcement. If that post is the why, this one is the how: everything a store needs to go from approved application to first attributed sale, in the order you will actually do it. Most partners get through the integration part in a day, and honestly the feed step is usually done before lunch.

Before You Start

You need three things: an approved partner application (apply at wardrowbe.com/partners, review takes up to 5 business days), a product catalog you can export as JSON, and an HTTPS URL where that feed can live. When your application is approved you get a sign-in link by email, and you generate your API key yourself in the portal settings. The key is never sent over email, so it is only ever seen by you.

If you want to explore the portal before applying, the partners page has a demo mode with realistic data in every tab.

Step 1: The Product Feed

The feed is a JSON document at any HTTPS URL you control. We poll it every 6 hours automatically, and you can trigger a sync on demand from the portal whenever you push a big catalog change. A minimal valid feed looks like this:

{
  "products": [
    {
      "name": "Classic White Leather Sneaker",
      "price_cents": 7900,
      "external_url": "https://yourstore.com/products/white-sneaker",
      "clothing_type": "shoes",
      "image_url": "https://yourstore.com/img/white-sneaker.jpg",
      "colors": ["white"],
      "style": "casual"
    }
  ]
}

Four fields are required, the rest improve matching:

A feed can carry up to 500 products. There is no minimum, but matching quality scales with catalog depth: under 20 items you will see low match rates, and 50 or more well-tagged items performs noticeably better. If you would rather push products in real time instead of hosting a feed, the same data goes through the REST API with your key.

Step 2: Understand Attribution

When the AI suggests one of your products, it is because the matching engine found a gap in a real wardrobe your product can fill. The user data side of this is described in the announcement post, and users control it entirely, which is worth understanding as a partner too: you are only ever shown to people who have partner suggestions enabled.

When a user taps Shop, they land on your external_url with three query parameters attached: utm_source=wardrowbe, utm_medium=partner, and wr_sid, a unique suggestion id. That wr_sid is the whole attribution contract. Store it with the order, and when the purchase completes, report the conversion through the API echoing the same wr_sid back with the order amount.

Two rules to know upfront:

• Attribution lasts 30 days from the click. Conversions reported after that window are rejected.
• Refunds are first-class. Report them through the API and they net against your next invoice, partial refunds included. Better that than clawback emails.

Step 3: Webhooks (Optional but Worth It)

If you would rather not poll, configure a webhook endpoint in the portal and we push you four event types: conversion, refund, feed_sync_completed, and feed_sync_failed. That last one is the quiet hero, since a broken feed otherwise fails silently until your products drift stale.

Every delivery is signed with HMAC-SHA256 in the X-Wardrowbe-Signature header, using the exact bytes of the payload, and there is a verification snippet in the portal docs. Failed deliveries retry up to 5 times with increasing backoff, so a short outage on your side does not lose events.

Step 4: Commission

You take the payment and keep 100% of every sale, so nothing is ever transferred to you. Instead we invoice you for commission on the sales we sent you. You add a payment method once from the portal (Stripe handles the card side), and then it is hands-off:

• Commissions accrue on attributed conversions at the rate agreed during your onboarding.
• On the 1st of each month, the previous month is calculated: gross conversions minus refunds, times your rate.
• Commission under $10 is not billed, it carries forward and combines with the next month. If refunds outweigh sales, the negative balance rolls forward and reduces your next invoice.
• Every invoice is reviewed before it is issued, and comes with a line-by-line statement in the portal, so you can reconcile each conversion against your own order data.

The Whole Thing on One Screen

Get Started

Apply at wardrowbe.com/partners or open the demo portal from the same page to see the dashboard with data in it first. If you are still deciding whether commission-based placement beats your current ad spend, I did the math on that with real numbers. Curious how the consumer side works? How the app learns each user's style explains the engine your products get matched by, and the features overview covers the rest of the app.