> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switch.vaultera.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup Custom Domain

You can use a **custom domain** for your payment links in Vaultera switch. This means the payment link will use your own branded domain instead of a default Vaultera Switch domain.

> To enable this, contact Vaultera Switch support. We will configure the domain on our end and provide a TLS certificate.

***

### 🔧 Setting Up a Custom Domain on Your Cloud

#### 1. Identify Your DNS Provider

First, determine who manages your DNS records. This is typically your domain registrar, but it might be a different provider.

If you're unsure, you can find your DNS provider by running the following command in your terminal:

```bash theme={"system"}
nslookup -querytype=NS yourdomain.com
```

Replace `yourdomain.com` with your actual domain name. The output will list the name servers managing your DNS.

***

#### 2. Create Required DNS Records

To link your custom domain to Vaultera switch, follow these steps:

***

##### Step 1: Sign In to Your DNS Provider

Log in to your DNS provider’s control panel (e.g., GoDaddy, Cloudflare, AWS Route 53).

***

##### Step 2: Navigate to DNS Settings

Locate the section where you can manage DNS records for your domain.

***

##### Step 3: Create a CNAME Record

Create a new CNAME record to point your subdomain to Vaultera switch.

| **Field**      | **Instructions**                               | **Description**                                                                       |
| -------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Type**       | Select `CNAME`                                 | Specifies the record type                                                             |
| **Name**       | For `paymentlink.xyz.com`, enter `paymentlink` | The subdomain (prefix before the first dot)                                           |
| **Value**      | `test.switch.vaultera.co`                      | Points to the Vaultera Switch server (check if your provider requires a trailing dot) |
| **TTL/Expiry** | `300`                                          | Sets the record to expire after 5 minutes                                             |

***

##### Step 4: Create a TXT Record

This TXT record is required for domain ownership verification and TLS certificate provisioning.

| **Field**      | **Instructions**                            | **Description**                     |
| -------------- | ------------------------------------------- | ----------------------------------- |
| **Type**       | Select `TXT`                                | Specifies the record type           |
| **Name**       | `_acme-challenge.paymentlink`               | Used for certificate validation     |
| **Value**      | Paste the value provided by Vaultera Switch | A unique verification string        |
| **TTL/Expiry** | `300`                                       | A 5-minute expiration is sufficient |

***

##### Step 5: Verify Your CNAME Record

Run the following command to verify the CNAME record:

```bash theme={"system"}
nslookup -querytype=CNAME paymentlink.xyz.com
```

Expected output:

```
<your subdomain>  canonical name = test.switch.vaultera.co
```

***

##### Step 6: Verify Your TXT Record

Check that the TXT record has propagated:

```bash theme={"system"}
nslookup -querytype=TXT _acme-challenge.paymentlink.xyz.com
```

Expected output:

```
_acme-challenge.<your domain> text = "<your unique TXT record value>"
```

If the value doesn’t show up, wait a few more minutes and try again.

***

### ✅ What Happens Next?

Once your DNS records are correctly configured and verified, Vaultera Switch will validate your domain and provision it on our end. You will receive a confirmation email when the domain is ready to use.

***

## 💳 Enabling Wallets (Apple Pay & Google Pay) with Custom Domains

To enable **Apple Pay** or **Google Pay** in payment links, you need to validate your custom domain with Apple or Google.

This is necessary to:

* Generate Apple Pay or Google Pay session tokens.
* Ensure the wallets work correctly in your payment link flow.

### Steps:

1. Set up your custom domain as described above.
2. Obtain and register the respective Apple Pay or Google Pay certificates.
3. Upload and configure these certificates within the Vaultera Switch dashboard.

> Wallet support via payment links is only available when using custom domains due to domain-based validation requirements from Apple and Google.