WooCommerce integration

​

Overview

​

Features

• Automatic order tracking - Orders create transactions automatically
• Coupon integration - Partner coupons track referrals
• Customer syncing - WooCommerce customers synced to Partnero
• Subscription support - Works with WooCommerce Subscriptions

​

Setup

​

Step 1: Install Plugin

1. Go to Plugins → Add New in WordPress admin
2. Search for “Partnero”
3. Click Install Now and then Activate

​

Step 2: Connect to Partnero

1. Go to WooCommerce → Settings → Partnero
2. Enter your Partnero API key
3. Select your program
4. Click Connect

​

Step 3: Configure Settings

​

How It Works

​

Order Tracking Flow

​

Attribution Methods

1. Referral Cookie - Customer clicked referral link before ordering
2. Coupon Code - Customer used partner’s coupon at checkout
3. Customer Match - Existing customer linked to partner

​

Coupon Integration

​

Creating Partner Coupons

1. Create coupon in WooCommerce
2. Link coupon to partner in Partnero
3. When used, order is attributed to partner

​

Automatic Coupon Sync

1. Go to WooCommerce → Settings → Partnero → Coupons
2. Enable Auto-create partner coupons
3. Configure discount amount and type

​

Subscription Support

​

Initial Purchase

​

Renewals

• Creates new transaction
• Calculates commission (if recurring enabled)
• Updates partner’s balance

​

Subscription Management

• woocommerce_subscription_renewal_payment_complete
• woocommerce_subscription_status_changed

​

Tracking Script

<!-- Added automatically by plugin (PartneroJS) -->
<script>
  (function(p,t,n,e,r,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>

​

Manual Installation

​

Add to Theme

add_action('wp_head', function() {
    ?>
    <!-- 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', '<?php echo PARTNERO_PROGRAM_ID; ?>', 'load');
    </script>
    <!-- End PartneroJS -->
    <?php
});

​

Track Orders via Webhook

1. Go to WooCommerce → Settings → Advanced → Webhooks
2. Add webhook with URL: https://api.partnero.com/v1/integrations/woocommerce/{program_id}/webhook
3. Select topic: Order created

​

Customer Sync

# API endpoint for WooCommerce sync
curl -X POST https://api.partnero.com/v1/customers/woocommerce/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": 123,
    "email": "[email protected]",
    "name": "John Doe",
    "woocommerce_id": "wc_456"
  }'

​

Testing

​

Test Orders

1. Enable WooCommerce test mode
2. Place test order with referral cookie set
3. Verify transaction appears in Partnero

​

Debug Mode

1. Go to WooCommerce → Settings → Partnero → Debug
2. Enable debug mode
3. Check logs in WooCommerce → Status → Logs

​

Troubleshooting

​

Next Steps