---
title: "Troubleshooting and FAQ"
description: "This guide helps you resolve common configuration errors, tracking script issues, and payout processing failures. Use the sections below to troubleshoot domain verification problems, missing conver..."
last_updated: "2026-10-05T05:09:52.153497+00:00"
canonical_url: "https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/guide/troubleshooting/troubleshooting-and-faq"
---

## Overview

This guide helps you resolve common configuration errors, tracking script issues, and payout processing failures. Use the sections below to troubleshoot domain verification problems, missing conversion attributes, and issues with partner payouts.

---

## Resolving Domain Verification Failures

### Overview

Domain verification problems typically occur when custom domain DNS records are missing, misconfigured, or conflicting with existing entries.

> [!WARNING]
> If a custom domain remains invalid for more than 30 days and has no active link clicks, it will be automatically deleted from your workspace.

### Step-by-Step Instructions

1. **Check your domain status:** Navigate to your workspace domain settings to review the current status of your connected domain.
2. **Review DNS configuration:** Configure either an A record or a CNAME record depending on whether you are using an apex domain or a subdomain:
   - **Apex Domain:** Set an `A` record with name `@` pointing to the custom domain A record value.
   - **Subdomain:** Set a `CNAME` record with your subdomain name pointing to the custom domain CNAME value.
3. **Resolve conflicting records:** If you see a conflicting DNS record error, remove any old or overlapping records from your DNS provider before applying the correct recommended values.
4. **Add TXT verification records:** If a TXT verification record is requested, add it to your DNS provider alongside your A or CNAME record, then click **Verify**.

---

## Resolving Missing Conversion Attributes

### Overview

Conversion attribution requires properly formatted tracking scripts and parameters on your website. If sales or leads are not being attributed, check your script installation.

### Common Script Errors

| Error Code | Description | Resolution |
| :--- | :--- | :--- |
| `not_installed` | The tracking script was not found on the page. | Ensure the tracking script is properly pasted into your website header. |
| `malformed` | The script tag structure is invalid or missing required sources. | Verify the script tag uses the correct SDK source and attributes. |
| `missing_attributes` | Required parameters like publishable keys or SDK names are missing. | Include your publishable key and SDK attributes inside the tracking script tag. |
| `missing_refer_domain` | The referral or short domain configuration does not match. | Update the domain attributes in your tracking script to match your configured workspace domain. |
| `duplicate` | Multiple tracking scripts were detected on the same page. | Remove duplicate script tags so only a single tracking script loads per page. |

> [!TIP]
> Ensure your conversion tracking script includes your publishable key and uses the official analytics package source to guarantee all conversion attributes are captured correctly.

---

## Resolving Payout Processing Errors

### Overview

Payout processing errors can occur due to bank account verification failures, incorrect tax details, or disconnected payout apps.

### Common Payout Errors and Solutions

- **Stripe or Shopify Connection Required:** If you encounter connection errors, install or reconnect the required integration application from the Stripe Marketplace or Shopify App Store.
- **Bank Account Verification Failed:** If microdeposits or bank verifications fail, update your bank account or tax identification details in your payout settings. Failed transfers automatically retry once valid bank account information is restored.
- **Insufficient Balance for Withdrawal:** Ensure your processed payouts balance meets the minimum withdrawal amount before requesting a manual payout. Withdrawals below the minimum threshold may incur a below-minimum withdrawal fee.

> [!NOTE]
> Payouts that fail due to authentication requirements or incorrect bank details are reverted to a **Pending** status. Update your payment details and retry the payout from your program's payouts tab.

## Related

- [Domains and Branding](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/guide/configuration/domains-and-branding)
- [Commissions and Payouts](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/guide/how-to-guides/commissions-and-payouts)


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/llms.txt) for all pages in this wiki.