Your First Integration¶

Step-by-step guide to connecting your first platform to Dxtra.

Before You Begin¶

Ensure you have:

• Dxtra account with admin privileges
• Data Controller configured with your domain and DID
• Admin access to the platform you want to connect
• Your DID and DX Key from Developers in the dashboard

See Integration Prerequisites for full requirements.

Setup Process¶

Step 1: Navigate to Processors¶

1. Log into the Dxtra dashboard
2. Select Processors from the sidebar navigation
3. Click Add Integration

Step 2: Select Your Integration¶

Select the platform you want to connect. Popular first integrations:

See All Integrations for the complete list.

Step 3: Authenticate¶

Authentication varies by platform:

• OAuth integrations (Shopify, QuickBooks, Eventbrite) -- Follow the OAuth redirect to grant Dxtra permissions
• Webhook integrations (Stripe, Mailchimp) -- Configure a webhook URL in the platform's settings using your DID and DX Key
• API key integrations (Klaviyo, Customer.io) -- Enter API credentials in the Dxtra dashboard

Step 4: Configure Settings¶

Once authenticated:

1. Select your Data Controller to link the integration
2. Review the events that will be tracked
3. Confirm the configuration

Most privacy settings are applied automatically based on the platform type.

Step 5: Verify the Connection¶

1. Create test data in your platform (a test customer or transaction)
2. Check the Data Mapping section in the dashboard for incoming events
3. Verify that processing activities appear in the activity log

Events typically appear within a few minutes of being triggered.

Example: Shopify Integration¶

sequenceDiagram
    participant Customer
    participant Shopify
    participant Dxtra

    Customer->>Shopify: Creates Account
    Shopify->>Dxtra: Customer webhook
    Dxtra->>Dxtra: Create Data Subject

    Customer->>Shopify: Places Order
    Shopify->>Dxtra: Order webhook
    Dxtra->>Dxtra: Log Processing Activity

Troubleshooting¶

Events Not Appearing¶

1. Verify webhook URLs include the correct did and dxKey parameters
2. Check that webhook endpoints are active in the platform settings
3. Review webhook delivery logs in the platform for error messages

Authentication Problems¶

1. Verify you have admin access to the platform
2. Check that API credentials are correctly entered
3. For OAuth integrations, ensure redirect URLs are properly configured

Data Processing Delays¶

1. Events may take a few minutes to appear after being triggered
2. Check that the platform is sending the expected event types
3. Verify your Dxtra integration shows as active in the dashboard

Next Steps¶

After your first integration:

1. Add more integrations -- Connect additional business platforms
2. Review the Processing Activity Log -- Monitor data processing across platforms
3. Configure consent -- Set up consent collection via the Transparency Center widget
4. Invite your team -- Add team members with appropriate roles

Related Documentation¶

• All Integrations -- Available platforms and setup guides
• Widget Embedding -- Add the Transparency Center to your website
• API Documentation -- Build custom integrations