Skip to main content

​
Overview

Connect Shopify to automatically track orders and attribute sales to partners.

​
Features

  • Automatic order tracking - Shopify orders synced automatically
  • Discount code integration - Partner discount codes for attribution
  • Customer syncing - Shopify customers mapped to Partnero
  • Multi-currency support - Handle orders in any currency

​
Setup

​
Step 1: Install App

Install Partnero from the Shopify App Store:
  1. Go to Shopify App Store
  2. Search for “Partnero”
  3. Click Add app
  4. Authorize the app

​
Step 2: Connect Program

  1. In the Partnero app, select your program
  2. Configure tracking settings
  3. Click Connect

​
Step 3: Add Tracking Script

The app automatically adds tracking, or add manually:
  1. Go to Online Store → Themes → Edit code
  2. Open theme.liquid
  3. Add before </head>:
<!-- PartneroJS -->
<script>
  (function(p,t,n,e,r,o){ p['__partnerObject']=r;function f(){
  var c={ a:arguments,q:[]};var r=this.push(c);return "number"!=typeof r?r:f.bind(c.q);}
  f.q=f.q||[];p[r]=p[r]||f.bind(f.q);p[r].q=p[r].q||f.q;o=t.createElement(n);
  var _=t.getElementsByTagName(n)[0];o.async=1;o.src=e+'?v'+(~~(new Date().getTime()/1e6));
  _.parentNode.insertBefore(o,_);})(window, document, 'script', 'https://app.partnero.com/js/universal.js', 'po');
  po('settings', 'assets_host', 'https://assets.partnero.com');
  po('program', 'YOUR_PROGRAM_ID', 'load');
</script>
<!-- End PartneroJS -->

​
How It Works

​
Order Flow

​
Attribution

Orders attributed via:
  • Referral Cookie - From clicking partner link
  • Discount Code - Partner’s unique code
  • Customer Email - Match existing customer

​
Discount Code Integration

​
Partner Discount Codes

Create discount codes for partners:
  1. In Shopify: Discounts → Create discount
  2. Create code (e.g., PARTNER20)
  3. In Partnero: Link code to partner

​
Automatic Codes

Enable automatic discount code generation:
  1. Go to Program Settings → Coupons
  2. Enable Auto-generate Shopify discounts
  3. Configure discount amount and rules

​
Tracking Conversions

​
Order Created Webhook

Partnero listens for order webhooks:
  • orders/create - New order placed
  • orders/paid - Payment received
  • refunds/create - Refund processed

​
Track Checkout

Add tracking to checkout (Shopify Plus): 
{% if first_time_accessed %}
<script>
  po('createTransaction', {
    key: '{{ order.id }}',
    amount: {{ order.total_price | money_without_currency }},
    currency: '{{ order.currency }}',
    customer: {
      email: '{{ order.email }}'
    }
  });
</script>
{% endif %}

​
Refund Handling

When orders are refunded:
  1. Shopify sends refund webhook
  2. Partnero marks transaction as refunded
  3. Commission is reversed
  4. Partner balance updated

​
Multi-Store Setup

For multiple Shopify stores:
  1. Create separate programs in Partnero
  2. Install app on each store
  3. Connect each store to its program

​
Testing

​
Test Mode

Use Shopify’s test payment gateway:
  1. Enable Bogus Gateway in Shopify
  2. Place test orders
  3. Verify transactions in Partnero

​
Test Order

Card Number: 1
CVV: 111
Expiry: Any future date

​
Troubleshooting

  • Verify app is installed correctly
  • Check webhook is receiving events
  • Ensure tracking script is on all pages
  • Test referral link clicks
  • Verify discount code is linked
  • Check customer email matching
  • Check browser console for errors
  • Verify script placement in theme
  • Test in incognito mode

​
Next Steps

Coupons

Manage partner discount codes

Transactions

Learn about transaction tracking