WooCommerce integration¶

Integrate your self-hosted WooCommerce store with Dxtra to automate privacy compliance, handle data subject requests, and manage customer consent preferences.

Overview¶

WooCommerce stores substantial customer data—names, emails, billing and shipping addresses, phone numbers, orders, subscriptions, and download history. Dxtra integrates with your WooCommerce REST API to discover this data, fulfill access and deletion requests, and propagate consent changes across your platforms.

Unlike pre-built integrations (like Shopify), WooCommerce is self-hosted and requires setup via API webhook connection or custom processor configuration. This gives you full control over what data Dxtra can access.

What you can do¶

• Access Requests — Export customer names, emails, addresses, phone, order history, and subscription data
• Deletion Requests — Delete customer accounts and associated data from WooCommerce
• Consent Management — Sync email marketing preferences and manage unsubscribe workflows
• Data Discovery — Automatically identify personal data stored in orders, subscriptions, and customer metadata
• Preference Propagation — Update opt-out status across email platforms when customer unsubscribes

Prerequisites¶

• Self-hosted WooCommerce store (WooCommerce 4.0+)
• WordPress admin access
• Dxtra workspace with admin access
• PHP 7.4 or higher
• TLS 1.2+ support for secure API communication

Setup instructions¶

Option 1: Custom Processor (Recommended)¶

If WooCommerce is not in the Select Processor dropdown, use the custom processor option:

1. Go to Processors in your Dxtra dashboard
2. Click Select Processor → scroll to bottom
3. Select Add Processor (custom integration)
4. Choose WooCommerce REST API
5. Generate a WooCommerce API credential:
6. WordPress Admin → WooCommerce → Settings → Advanced → REST API
7. Click "Create an API Key"
8. Set Permissions to "Read/Write"
9. Copy the Consumer Key and Consumer Secret
10. Paste credentials into Dxtra wizard
11. Click "Confirm and Onboard"

Option 2: Webhook Connection¶

For real-time data sync, configure webhooks:

1. Go to WordPress Admin → WooCommerce → Settings → Advanced → Webhooks
2. Click "Add webhook"
3. Set the following webhook events:
4. customer.created
5. customer.updated
6. customer.deleted
7. order.created
8. order.updated
9. order.deleted
10. Delivery URL: https://conduit.dxtra.ai/api/v1/integrations/woocommerce/event?did={YOUR_DID}&token={YOUR_API_TOKEN}
11. Replace {YOUR_DID} with your Dxtra organization ID (found in Processors page)
12. Replace {YOUR_API_TOKEN} with your Dxtra API token
13. Click "Save webhook"
14. Test webhook delivery (WordPress will show delivery status)

Verify Connection¶

Once configured:

1. Return to Dxtra Manage Processors table
2. WooCommerce should show "Interconnected" status
3. Test with a customer access request to confirm data retrieval
4. Check WordPress logs for any API errors

Data covered¶

How data subject rights work¶

Access Requests¶

When a customer emails requesting their data:

1. Create a DSRR in Dxtra with the customer's email address
2. Dxtra queries WooCommerce API for:
3. All customer account information
4. Complete order history with items and amounts
5. Subscription data (if using WooCommerce Subscriptions)
6. Digital download history
7. Any custom fields or metadata
8. Export data in CSV or JSON format
9. Deliver to customer (keep documentation of fulfillment)

Deletion Requests¶

When a customer requests erasure:

1. Verify their identity (email confirmation or manual verification)
2. Create a deletion DSRR in Dxtra
3. Select deletion options:
4. Delete customer account and contact data
5. Pseudonymize order records (keep totals/dates for accounting, remove names/emails)
6. Delete subscription records
7. Delete download history
8. Dxtra executes deletion via WooCommerce REST API
9. Confirm completion to customer

Configuration options¶

Data Scope¶

Control what data Dxtra can access:

• Customer data — Names, emails, addresses, phone numbers
• Order data — Order history, items purchased, transaction amounts
• Subscription data — Subscription status, billing cycles (if applicable)
• Metadata — Custom fields, customer notes, tags
• Download history — Digital product downloads (if applicable)

Sync Frequency¶

• Real-time (Webhooks) — Data syncs immediately when changes occur in WooCommerce
• Scheduled (API) — Dxtra queries WooCommerce at set intervals (hourly/daily)
• Manual — Trigger sync only when creating a DSRR

Choose based on store size and update frequency.

Troubleshooting¶

Connection Not Established¶

• Verify API credentials are correct in Dxtra
• Check WordPress REST API is enabled (WooCommerce → Settings → Advanced → REST API)
• Ensure firewall/hosting provider allows outbound HTTPS requests
• Test API access: from terminal, run curl https://yourstore.com/wp-json/wc/v3/customers -u key:secret

Webhook Delivery Failures¶

• Check WordPress Admin → WooCommerce → Settings → Advanced → Webhooks
• Click the webhook to view delivery logs and error messages
• Verify Dxtra webhook URL includes did and token parameters
• Ensure URL is HTTPS (not HTTP)
• Check Dxtra status page for any service issues

Missing Customer Data¶

• Verify customer email is spelled correctly in both WooCommerce and DSRR
• Confirm customer account exists in WordPress → Users
• Check customer is not blocked or in spam state
• Verify WooCommerce REST API scopes include customer read permissions

Deletion Fails¶

• Confirm customer account is not a WordPress administrator
• Check for pending orders in fulfillment (cancel or complete first)
• Verify there are no other plugins locking customer records
• Check WordPress database for corruption (run WP-CLI wp db check)

Best practices¶

• Use Staging First — Test the integration on a staging/development store before production
• Document API Credentials — Store API keys securely (use a secrets manager, not plain text)
• Monitor Webhooks — Regularly check WordPress webhook delivery logs for failures
• Keep WooCommerce Updated — Apply security patches to WordPress and WooCommerce monthly
• Audit Data Access — Periodically review which customer data is being synced to Dxtra
• Train Your Team — Ensure staff knows how to create DSRRs and fulfill requests

Security considerations¶

• API Credentials — Store Consumer Key and Secret securely (never in version control)
• TLS Encryption — All communication with WooCommerce API is encrypted in transit
• Data Retention — Dxtra stores WooCommerce data only while DSRR is active, then deletes
• Access Logs — Dxtra logs all API access and data retrieval for compliance audit trails
• No Third-Party Sharing — Dxtra never shares your WooCommerce data with external services

Compatibility¶

WordPress and WooCommerce Versions¶

• WordPress 5.0+
• WooCommerce 4.0+
• PHP 7.4+

Popular WooCommerce Extensions¶

Dxtra works with:

• WooCommerce Subscriptions
• WooCommerce Bookings
• Affiliate WP
• WooCommerce PDF Invoices
• WooCommerce Membership

Related integrations¶

• Shopify Integration — For Shopify stores (simpler setup)
• Email Marketing — Connect Klaviyo, Mailchimp to sync consent
• CRM Integrations — Sync customer data with Salesforce, HubSpot

Support¶

Having trouble with your WooCommerce integration?

• Email — support@dxtra.ai
• Dashboard chat — Bottom-right corner of Dxtra app
• Documentation — Data Subject Rights Workflow
• Status page — Check Dxtra API status at status.dxtra.ai

Next step: Connect email marketing platforms or payment processors to manage consent and data across your entire business.