Overview
This guide helps you diagnose and resolve common issues you might encounter while using the application, including domain verification errors, failed partner payouts, tracking installation problems, and login or authorization challenges.
Use the sections below to find step-by-step troubleshooting instructions for each scenario.
Domain Verification Errors
Understanding Domain Verification Issues
When adding a custom domain to your workspace, you may occasionally run into verification issues due to incorrect DNS records, conflicts, or missing configurations.
Common Domain Errors and Their Meanings
| Status / Error Code | Description | Resolution Steps |
|---|---|---|
| Domain Not Found | The domain has not been added to your project or DNS configuration properly. | Check that you entered the correct domain name and that it points to your project. |
| Conflicting DNS Records | Existing DNS records (such as an old A or CNAME record) are conflicting with the required configuration. | Remove the conflicting records from your DNS provider, then set the recommended A or CNAME record. |
| Invalid Configuration | The domain's DNS records do not match the expected values. | Verify your DNS provider settings against the required A, CNAME, or TXT verification values provided in your dashboard. |
| Unknown Error | An unexpected error occurred while communicating with the domain registrar or DNS management service. | Wait a few minutes and try verifying again. If the issue persists, contact support. |
Warning
If a domain remains invalid for more than 14 or 28 days, reminder emails will be sent to workspace owners. If a domain remains unverified for more than 30 days and has no active link clicks, it may be automatically deleted from the database.
Failed Payouts
Understanding Payout Failures
Partner payouts can occasionally fail due to issues with payment methods, authentication requirements, or insufficient billing details. When a partner payout fails, the affected payouts are automatically reverted back to a Pending status, and you will receive a notification email detailing the failure reason. If applicable, a payment failure fee may be charged to your card to cover processing costs.
Resolving Payout Failures
- Open your workspace settings and navigate to your billing or payment methods page to update your card or direct debit details.
- Go to your program's Payouts tab.
- Review the pending payouts and click Retry payout or Confirm all payouts once your payment details have been updated.
Tip
You can press the C key as a keyboard shortcut while viewing the payouts page to quickly open the confirmation sheet for pending payouts.
Tracking Discrepancies and Installation Issues
Understanding Tracking Installation Errors
If your analytics or conversion tracking script is not working correctly, you can verify your installation directly from your workspace settings. When you use the Verify installation tool in your tracking settings, you may encounter specific error codes that explain why the script cannot be validated.
Troubleshooting Installation Error Codes
- Script is not installed (
not_installed): The tracking script could not be found on the specified hostname. Ensure the script tag is added to your website's HTML header. - Script missing attributes (
missing_attributes): The conversion tracking script is missing required attributes, such as a publishable key or SDK name. - Script is missing the referral link domain (
missing_refer_domain): The tracking script needs to specify the correct referral link domain attribute. - Duplicate script (
duplicate): More than one tracking script tag was detected on the page. Remove all but one valid script tag. - Malformed script (
malformed): The script tag is improperly formatted or missing required source attributes. - We couldn’t reach this hostname (
unreachable): The system was unable to establish a connection to your hostname. Check that your website is live and publicly accessible. - Wildcard hostnames can’t be verified (
unsupported): Wildcard hostnames (starting with*.) cannot be automatically verified. Please select a specific subdomain or apex domain.
Important
Make sure your tracking script includes your correct publishable key and matches your active website domain.
Login and Authorization Issues
Understanding Access and Authorization Challenges
If you or your partners encounter issues accessing the application or partner portal, review the common error messages and resolution steps outlined below to restore access.
Authentication Error Reference
| Error Code / Message | Meaning | Resolution |
|---|---|---|
| Unauthorized | You are not logged in or your session has expired. | Log in to your account at the appropriate portal URL to continue. |
| Partner profile not found | Your partner account does not exist or was not found. | Complete the partner onboarding flow to create your profile. |
| Invalid or expired state | The security state token for authentication or connection has expired. | Restart the login or connection process from the beginning. |
| PayPal email address is not verified | Your connected PayPal account has an unverified email address. | Log in to PayPal, verify your email address, and try reconnecting. |
| The PayPal account you're trying to connect is already in use | The PayPal account is linked to another partner profile. | Use a different PayPal account that is not currently tied to another partner. |
Tip
If you experience persistent session issues, try clearing your browser cookies and cache, or log in using an incognito window.
Related
On This Page
OverviewDomain Verification ErrorsUnderstanding Domain Verification IssuesCommon Domain Errors and Their MeaningsFailed PayoutsUnderstanding Payout FailuresResolving Payout FailuresTracking Discrepancies and Installation IssuesUnderstanding Tracking Installation ErrorsTroubleshooting Installation Error CodesLogin and Authorization IssuesUnderstanding Access and Authorization ChallengesAuthentication Error ReferenceRelated