Sell with us is the pitch. This is the integration manual: the levels of connection, the exact permissions we ask for, how a sale gets attributed, and what we will never touch.
Three levels, start anywhere
Start at A and move to B and then C whenever you like. There is no re-onboarding between them.
| Level | Your setup | What the buyer sees | What you get |
|---|---|---|---|
| A · Zero touch | 0 minutes. No credentials, no token, no webhook. | Your catalog on PTD. Clicking a product opens it on your store with the variant pre-selected. | Listed, sometimes same day. Attribution by URL tag only. |
| B · + sale tracking | ~10 min. One webhook, and you hand over its signing secret. | Identical to A. | Authoritative sale data, so the monthly invoice is real numbers rather than a reconciliation. |
| C · Headless | ~10 min. Shopify's free Headless app, plus a read-only Storefront token. | Catalog and cart on PTD. They only leave at the final checkout step. | The deepest visual integration. Worth it once PTD drives real volume. |
There is a fourth shape, click-out only: one tile and a visit-our-store button, with no catalog on PTD at all. We use it when a partner does not want their products rendered here.
Exactly what we ask for
Level A needs nothing at all. For B and C, create a custom app in Shopify Admin → Apps → Develop apps and tick these Admin API scopes and no others:
read_productsread_product_listingsread_inventory· optional, and used for exactly one thing: hiding sold-out items on PTD.
Send the access token through a password manager or Signal. Never email, never a chat thread. We use it to pull your catalog, and again whenever you ask for a re-sync. It is not stored in code.
The webhook, and its secret
Level B is one webhook: Settings → Notifications → Webhooks → Create webhook, event Order payment, format JSON, pointed at our endpoint.
Rotation is not a routine ask. We would only raise it if exposure were suspected, and you can ask us to rotate whenever you want. Rotation always starts on your side, because we cannot generate or read the secret ourselves.
How a sale gets attributed
Every click we send you lands with ?ref=ptd-{your-handle} on the URL, which is sortable in your own Shopify analytics. That tag is what makes a sale ours to invoice.
buyer clicks a product on PTD
→ lands on YOUR store, ?ref=ptd-your-handle, variant pre-selected
→ checks out on YOUR checkout
→ YOU receive 100% from Shopify
→ orders/paid webhook tells PTD the sale happened, with the gross
→ once a month PTD invoices 6% of the tagged grossSales from Instagram, Google, your newsletter or direct traffic carry no tag. We do not see them and we do not bill on them.
The 6%, worked
A PTD shopper clicks through and buys a $50 hoodie and a $20 hat. Subtotal $70.
| Step | Amount |
|---|---|
| Buyer pays, on your checkout | $70.00 |
| Shopify pays you, less their normal fees | $70.00 gross to you |
| PTD invoices at month end, 6% of tagged gross | $4.20 |
You pay it like any other vendor bill. Zero PTD-attributed sales in a month means a zero invoice. The full rate card is in Fees.
If a tagged session also picks up items you never listed with us, the default is deliberately conservative and the whole session counts as PTD-attributed. We can set a stricter rule per partner if you would rather.
Proving it works
Before you go live we run a $1 test order. You click one of your own products from your PTD page, confirm the ?ref= tag is on the URL, and check out. Within about thirty seconds we confirm the recorded gross and the tracked fee back to you. If that loop does not close, you are not live.
End to end: roughly 25 minutes of your time across the steps, and about a day of ours once the token and the secret have arrived.
What you keep
| Yours, untouched | What we do |
|---|---|
| Your store, theme and checkout | Render your products on paythedolls.com |
| Your customers and all customer data | Send buyers over with a ?ref= tag |
| Fulfilment, shipping and returns | Listen for the paid-order webhook on tagged sessions |
| Your tax position and your accounting | Invoice 6% monthly on tagged sales |
| 94% of every PTD-originated sale | Ignore every sale that did not come from us |
What we will never do
- Pull your customers, their emails, their accounts, or any personal data.
- Edit your products, prices, inventory or settings. Our access is read-only.
- List your products under a different brand and compete with your own store.
- Charge you in a month with no PTD-attributed sales.
- Lock you in. Pause or remove takes 24 hours, and no fees accrue while paused.
Not on Shopify?
Then the integration on this page does not apply to you, and we would rather say so than imply support that does not exist. Three of our four connection shapes are Shopify-specific. The fourth is the click-out tile, which works with any store on any platform because it ingests nothing.
Squarespace, Etsy, WooCommerce and the rest are not integrated today. Tell us what you are on when you apply. Either we list you as a click-out, or we build a store with you instead. See Launch a store.