The Explodely for WC integration allows your Downline Builder Plugin to automatically set referral usernames for new customers based on Explodely affiliate transaction data. When an Explodely 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:
- WordPress Website with admin access
- WooCommerce Plugin installed and activated
- Explodely for WC Plugin installed and activated
- Downline Builder Plugin installed and activated
- Explodely Vendor Account with products configured
- Affiliate Programs set up in Downline Builder Plugin
Step 1: Install Required Plugins
1.1 Install WooCommerce
- Go to Plugins > Add New in your WordPress admin
- Search for “WooCommerce”
- Install and activate the official WooCommerce plugin
1.2 Install Explodely for WC
- Upload the Explodely for WC plugin to your site
- Go to Plugins > Installed Plugins
- Find “Explodely for WC” and click Activate
1.3 Verify Downline Builder Plugin
- Ensure the Downline Builder Plugin is installed and activated
- Go to Plugins > Installed Plugins to verify
Step 2: Configure Explodely for WC Plugin
2.1 Basic Explodely Setup
- Navigate to WooCommerce > Settings > Explodely
- Configure your Explodely settings:
- Vendor ID: Your Explodely vendor ID
- Secret Key: Your Explodely secret key (from Explodely account)
- IPN URL: Copy the provided IPN URL for use in Explodely
2.2 Set Up IPN in Explodely
- Log into your Explodely vendor account
- Go to Account Settings > Integration
- In the IPN Settings section:
- Enter the IPN URL from your Explodely for WC settings
- Enable IPN notifications
- Set the notification format to include affiliate data
- Save your settings
2.3 Configure Products
- In WordPress, go to Products > All Products
- Edit each product you want to connect to Explodely
- In the Product Data section, find the Explodely tab
- Enter your Explodely Product ID
- Configure order status settings as needed
- Save the product
Step 3: Set Up Affiliate Programs in Downline Builder
3.1 Create Affiliate Program
- Go to Downline Builder > Settings > Affiliate Programs
- Click Add New Program
- Configure your affiliate program:
- Program Name: e.g., “Explodely”
- Click Save Program
3.2 Add Users to Affiliate Program
- Go to Users > All Users
- Edit a user who should be an affiliate
- Scroll to the Affiliate Programs section
- Find your Explodely affiliate program
- Enter the user’s Explodely affiliate ID in the program field
- Save the user profile
Important: The value you enter here must exactly match the affiliate ID that Explodely sends in the IPN data.
Step 4: Enable Explodely Integration in Downline Builder
4.1 Access Integration Settings
- Navigate to Downline Builder > Settings > Integrations
- Find the Available Integrations section
4.2 Enable Explodely Integration
- Check the box next to “Explodely for WooCommerce”
- The configuration section will appear below
4.3 Configure Integration Settings
- In the Explodely for WooCommerce Configuration section:
- Affiliate Program to Check: Select the affiliate program you created (e.g., “Explodely”)
- Click Save Integration Settings
Step 5: Test the Integration
5.1 Verify Setup
- Ensure all plugins are active and configured
- Check that your affiliate program has users with Explodely affiliate IDs
- Verify Explodely IPN is configured correctly
5.2 Test Transaction Flow
- Create a test Explodely transaction (or use Explodely’s test IPN feature)
- Monitor the transaction in WooCommerce > Orders
- Check if the new customer has the correct referral username set
- Review logs in WooCommerce > Status > Logs for any Explodely-related entries
5.3 Debug Common Issues
If the integration isn’t working:
- Check Plugin Status: Ensure all required plugins are active
- Verify IPN URL: Make sure Explodely is sending IPNs to the correct URL
- Review Logs: Check WordPress error logs and WooCommerce logs
- Test Affiliate Matching: Verify the Explodely affiliate ID exactly matches the value in the user’s profile
How It Works
Integration Flow
- Customer Purchase: A customer purchases through an Explodely affiliate link
- IPN Received: Explodely sends an IPN to your Explodely for WC plugin
- Data Capture: The Downline Builder integration captures the affiliate data
- User Lookup: The system searches for a user with the matching Explodely affiliate ID
- Referral Assignment: If found, the referring user’s username is set as the new customer’s referral username
- Fallback: If no match is found, the default referral username is used (if configured)