Connect Your Shopify Store
Convertly integrates directly with Shopify to sync products, track orders, and attribute sales to creators automatically.Installation
Install the app
From your Convertly dashboard, go to Settings > Integrations and click Connect Shopify. You will be redirected to the Shopify app install flow.Alternatively, find Convertly in the Shopify App Store and click Install.
Approve permissions
Shopify will ask you to approve the following scopes:
- Read products — to sync your product catalog
- Read and write orders — to track attributed sales
- Read customers — to associate customers with creator referrals
- Read and write discounts — to create and manage creator discount codes
What Syncs Automatically
| Data | Direction | Frequency |
|---|---|---|
| Products | Shopify to Convertly | On install + real-time via webhooks |
| Orders | Shopify to Convertly | Real-time via orders/create webhook |
| Order updates | Shopify to Convertly | Real-time via orders/updated webhook |
| Refunds | Shopify to Convertly | Real-time via refunds/create webhook |
| Customers | Shopify to Convertly | Real-time via customers/create webhook |
| Discount codes | Convertly to Shopify | When you create codes in Convertly |
Webhooks
Convertly registers five webhooks on your Shopify store automatically during installation:- orders/create — attributes new orders to creators via discount code matching
- orders/updated — handles order cancellations and status changes
- refunds/create — proportionally reverses commissions on refunded items
- customers/create — tracks new customers referred by creators
- app/uninstalled — cleans up data if you remove the app
Post-Purchase Widget
Convertly includes an optional post-purchase widget that appears on the order confirmation page. It asks customers “Who referred you?” and helps capture attribution for orders that did not use a tracking link or discount code. To enable it, go to Settings > Integrations > Post-Purchase Widget and toggle it on.Troubleshooting
Products are not syncing
Products are not syncing
Check that the app has Read products permission. Go to Shopify Admin > Settings > Apps and sales channels > Convertly and verify permissions.
Orders are not being attributed
Orders are not being attributed
Verify webhooks are registered: Settings > Integrations > Webhook Status. All five should show a green check. If any are missing, click Re-register.
Connection shows as disconnected
Connection shows as disconnected
Your Shopify access token may have expired. Click Reconnect in Settings > Integrations to re-authorize.