Setting Up JVZoo For WC Integration

The JVZoo for WC integration allows your Downline Builder Plugin to automatically set referral usernames for new customers based on JVZoo affiliate transaction data. When a JVZoo order comes in via IPN (Instant Payment Notification), this integration will match the affiliate ID with users in your affiliate programs and set the appropriate referral username.

Prerequisites

Before setting up this integration, ensure you have:

1. WordPress Website with admin access
2. WooCommerce Plugin installed and activated
3. JVZoo for WC Plugin installed and activated
4. Downline Builder Plugin installed and activated
5. JVZoo Vendor Account with products configured
6. Affiliate Programs set up in Downline Builder Plugin

Step 1: Install Required Plugins

1.1 Install WooCommerce

1. Go to Plugins > Add New in your WordPress admin
2. Search for “WooCommerce”
3. Install and activate the official WooCommerce plugin

1.2 Install JVZoo for WC

1. Upload the JVZoo for WC plugin to your site
2. Go to Plugins > Installed Plugins
3. Find “JVZoo for WC” and click Activate

1.3 Verify Downline Builder Plugin

1. Ensure the Downline Builder Plugin is installed and activated
2. Go to Plugins > Installed Plugins to verify

Step 2: Configure JVZoo for WC Plugin

2.1 Basic JVZoo Setup

1. Navigate to WooCommerce > Settings > JVZoo
2. Configure your JVZoo settings:

• Vendor ID: Your JVZoo vendor ID
• Secret Key: Your JVZoo secret key (from JVZoo account)
• IPN URL: Copy the provided IPN URL for use in JVZoo

2.2 Set Up IPN in JVZoo

1. Log into your JVZoo vendor account
2. Go to My Account > Vendor Settings > IPN Integration
3. Configure IPN settings:

• IPN URL: Enter the IPN URL from your JVZoo for WC settings
• Enable IPN: Check the box to enable IPN notifications
• IPN Version: Select version 6 or higher
• Include Affiliate Data: Ensure this is enabled
• Secret Key: Enter your secret key for validation

4. Save your settings

2.3 Configure Products

1. In WordPress, go to Products > All Products
2. Edit each product you want to connect to JVZoo
3. In the Product Data section, find the JVZoo tab
4. Enter your JVZoo Product ID
5. Configure order status settings as needed
6. Save the product

Step 3: Set Up Affiliate Programs in Downline Builder

3.1 Create Affiliate Program

1. Go to Downline Builder > Settings > Affiliate Programs
2. Click Add New Program
3. Configure your affiliate program:

• Program Name: e.g., “JVZoo”

4. Click Save Program

3.2 Add Users to Affiliate Program

1. Go to Users > All Users
2. Edit a user who should be an affiliate
3. Scroll to the Affiliate Programs section
4. Find your JVZoo affiliate program
5. Enter the user’s JVZoo affiliate ID in the program field
6. Save the user profile

Important: The value you enter here must exactly match the affiliate ID that JVZoo sends in the IPN data (ctransaffiliate field).

Step 4: Enable JVZoo Integration in Downline Builder

4.1 Access Integration Settings

1. Navigate to Downline Builder > Settings > Integrations
2. Find the Available Integrations section

4.2 Enable JVZoo Integration

1. Check the box next to “JVZoo for WooCommerce”
2. The configuration section will appear below

4.3 Configure Integration Settings

1. In the JVZoo for WooCommerce Configuration section:

• Affiliate Program to Check: Select the affiliate program you created (e.g., “JVZoo”)

2. Click Save Integration Settings

Step 5: Test the Integration

5.1 Verify Setup

1. Ensure all plugins are active and configured
2. Check that your affiliate program has users with JVZoo affiliate nicknames
3. Verify JVZoo IPN is configured correctly

5.2 Test Transaction Flow

1. Create a test JVZoo transaction (or use JVZoo’s test IPN feature)
2. Monitor the transaction in WooCommerce > Orders
3. Check if the new customer has the correct referral username set
4. Review logs in WooCommerce > Status > Logs for any JVZoo-related entries

5.3 Debug Common Issues

If the integration isn’t working:

1. Check Plugin Status: Ensure all required plugins are active
2. Verify IPN URL: Make sure JVZoo is sending IPNs to the correct URL
3. Review Logs: Check WordPress error logs and WooCommerce logs
4. Test Affiliate Matching: Verify the JVZoo affiliate nickname exactly matches the value in the user’s profile

How It Works

Integration Flow

1. Customer Purchase: A customer purchases through a JVZoo affiliate link
2. IPN Received: JVZoo sends an IPN to your JVZoo for WC plugin
3. Data Capture: The Downline Builder integration captures the affiliate data
4. User Lookup: The system searches for a user with the matching JVZoo affiliate nickname
5. Referral Assignment: If found, the referring user’s username is set as the new customer’s referral username
6. Fallback: If no match is found, the default referral username is used (if configured)

Troubleshooting

Common Issues

Integration Not Available

Problem: JVZoo for WC integration doesn’t appear in settings

Solution:

• Verify WooCommerce is installed and activated
• Verify JVZoo for WC plugin is installed and activated
• Check for plugin conflicts

No Referral Username Set

Problem: New customers don’t have referral usernames assigned

Solutions:

• Check that the affiliate program is selected in integration settings
• Verify the JVZoo affiliate nickname in the user profile matches exactly
• Review IPN logs to ensure JVZoo is sending affiliate data
• Check that the affiliate user exists and has the correct program value
• Ensure the ctransaffiliate field is being sent in the IPN

IPN Not Working

Problem: JVZoo IPNs are not being received

Solutions:

• Verify the IPN URL is correctly set in JVZoo
• Check that your server can receive POST requests
• Ensure SSL certificate is valid (JVZoo requires HTTPS)
• Test IPN using JVZoo’s IPN testing tools
• Verify firewall settings allow JVZoo IPN servers

Affiliate Data Missing

Problem: IPN received but no affiliate data

Solutions:

• Check JVZoo IPN configuration includes affiliate information
• Verify the transaction was made through an affiliate link
• Review the IPN payload in logs to confirm ctransaffiliate field is present
• Ensure affiliate approval settings allow the affiliate to promote
• Check if the affiliate is approved for the specific product

Secret Key Validation Errors

Problem: IPN validation fails due to secret key mismatch

Solutions:

• Verify the secret key in WordPress matches JVZoo settings
• Check for extra spaces or characters in the secret key
• Regenerate the secret key if necessary
• Ensure the secret key is properly configured in both systems

Debug Mode

Enable WordPress debug mode to see detailed error messages:

1. Edit your wp-config.php file
2. Add these lines:

define('WP_DEBUG', true);

define('WP_DEBUG_LOG', true);

3. Check /wp-content/debug.log for error messages

Log Messages

The integration logs important events with prefixes:

• DBP JVZoo Integration: – General integration messages
• Look for these in your WordPress error logs or WooCommerce logs

JVZoo-Specific Debugging

1. Test IPN: Use JVZoo’s IPN testing feature in your vendor account
2. Check Product Settings: Verify product is properly configured in JVZoo
3. Review Affiliate Status: Ensure affiliates are approved and active
4. Monitor Launch Status: Check if product launch settings affect IPN delivery

This integration automatically handles referral assignments from JVZoo transactions, streamlining your affiliate program management and ensuring accurate tracking of affiliate relationships in the dynamic JVZoo marketplace. With proper setup and monitoring, this integration will help you maximize your affiliate program’s effectiveness and scale your business successfully.