Domain Verification Guide

This guide explains how to verify your domain with ZoPay for production API access. Domain verification is required to ensure that API requests are coming from authorized domains.

Understanding Domain Verification

Why Domain Verification?

Domain verification ensures that:

• Only authorized domains can make API requests to ZoPay
• Prevents unauthorized third parties from using your API keys
• Provides an additional layer of security for production environments

How It Works

1. Add your domain in the ZoPay dashboard
2. Get a verification token (unique string)
3. Add a DNS TXT record to your domain's DNS settings
4. Test the DNS record using online tools (recommended)
5. Click "Verify Domain" - ZoPay checks if the TXT record exists
6. Domain is verified - You can now use the domain in API requests

Do I Need to Wait 15-30 Minutes?

Short Answer

You can click "Verify Domain" immediately after adding the TXT record, but DNS propagation may take 15-30 minutes (or sometimes longer). If you click verify too soon, it will fail with a helpful error message, and you can try again later.

Detailed Explanation

DNS Propagation

• When you add a TXT record to your DNS, it doesn't appear instantly worldwide
• DNS servers around the world need to update their records (this is "propagation")
• Typically takes 15-30 minutes, but can take up to 48 hours in rare cases
• Different DNS servers may see the record at different times

ZoPay's Verification Process

• When you click "Verify Domain", ZoPay immediately performs a DNS lookup
• It uses Google DNS (8.8.8.8) for reliability
• It checks for the TXT record _zopay.yourdomain.com
• If the record is found and matches your token, verification succeeds
• If not found, you'll get an error message and can try again later

Best Practice

1. Add the TXT record to your DNS settings
2. Test the DNS record using online tools (see below)
3. Wait 15-30 minutes for DNS propagation
4. Click "Verify Domain" - it should succeed
5. If it fails, wait a bit longer and try again

Testing DNS Records Before Verification

Before clicking "Verify Domain", you should test if your DNS record is visible using DNS lookup tools. This helps you avoid unnecessary verification attempts.

Using Command Line Tools

Using dig (Linux/Mac)

1dig TXT _zopay.yourdomain.com @8.8.8.8

Using nslookup (Windows)

1nslookup -type=TXT _zopay.yourdomain.com 8.8.8.8

Expected Output

If the DNS record is visible, you should see output like:

1_zopay.yourdomain.com. 3600 IN TXT "0dea454d6af1a00004168147aa683ab6"

If you see your verification token in the output, the DNS record is visible and you can click "Verify Domain".

Using Online DNS Tools

You can also use online DNS lookup tools to check if your record is visible:

• DNS Checker: https://dnschecker.org/
  • Enter: _zopay.yourdomain.com
  • Select "TXT" record type
  • Shows propagation status across multiple DNS servers worldwide
• MXToolbox: https://mxtoolbox.com/TXTLookup.aspx
  • Enter: _zopay.yourdomain.com
  • Shows TXT records for your domain
• Google DNS: https://dns.google/query
  • Enter: _zopay.yourdomain.com
  • Select "TXT" type

Domain Verification for Vercel-Hosted Sites

Solution: Use a Custom Domain

To verify a domain for a Vercel-hosted site, you must:

1. Use your own custom domain (e.g., api.yourstore.com, yourstore.com)
2. Add the domain to Vercel (in Vercel dashboard → Settings → Domains)
3. Add the TXT record to your domain's DNS provider (not Vercel)
4. Wait for DNS propagation
5. Verify in ZoPay

Step-by-Step: Verifying a Custom Domain on Vercel

Step 1: Add Custom Domain to Vercel

1. Go to your Vercel project dashboard
2. Navigate to Settings → Domains
3. Click Add Domain
4. Enter your custom domain (e.g., api.yourstore.com)
5. Follow Vercel's instructions to configure DNS

Note: Vercel will provide DNS records to add (usually an A record or CNAME record pointing to Vercel). Add these to your domain's DNS provider (e.g., Namecheap, GoDaddy, Cloudflare), not in Vercel.

Step 2: Get Verification Token from ZoPay

1. Log in to ZoPay dashboard
2. Go to Settings → Domains
3. Click Add Domain
4. Enter your custom domain (e.g., api.yourstore.com)
5. Copy the verification token shown

Example:

1Verification Token: 0dea454d6af1a00004168147aa683ab6

Step 3: Add TXT Record to Your Domain's DNS

Important: Add the TXT record to your domain's DNS provider (the same place where you manage your domain's DNS), NOT in Vercel.

TXT Record Details

Full DNS Record Name: The complete DNS record will be: _zopay.api.yourstore.com

Step 4: Wait for DNS Propagation

• Wait 15-30 minutes for DNS propagation
• You can check if the record is visible using online DNS lookup tools:
  • https://dnschecker.org/ - Enter: _zopay.api.yourstore.com
  • https://mxtoolbox.com/TXTLookup.aspx - Enter: _zopay.api.yourstore.com

Step 5: Test DNS Record (Recommended)

Before clicking "Verify Domain", test if your DNS record is visible:

1# Using dig (Linux/Mac)
2dig TXT _zopay.api.yourstore.com @8.8.8.8
3
4# Using nslookup (Windows)
5nslookup -type=TXT _zopay.api.yourstore.com 8.8.8.8

If you see your verification token in the output, the DNS record is visible and you can proceed to verification.

Step 6: Verify Domain in ZoPay

1. Go back to ZoPay dashboard
2. Find your domain in the list
3. Click "Verify Domain" button
4. If successful, the domain will show as "Verified"
5. If it fails, wait a bit longer and try again

Common DNS Providers: Where to Add TXT Records

Namecheap

1. Log in to Namecheap
2. Go to Domain List
3. Click Manage next to your domain
4. Go to Advanced DNS tab
5. Click Add New Record
6. Select TXT Record
7. Enter:
   • Host: _zopay
   • Value: your-verification-token
   • TTL: Automatic (or 3600)
8. Click Save

GoDaddy

1. Log in to GoDaddy
2. Go to My Products
3. Click DNS next to your domain
4. Scroll to Records section
5. Click Add → TXT
6. Enter:
   • Name: _zopay
   • Value: your-verification-token
   • TTL: 1 Hour (or 3600)
7. Click Save

Cloudflare

1. Log in to Cloudflare
2. Select your domain
3. Go to DNS → Records
4. Click Add record
5. Enter:
   • Type: TXT
   • Name: _zopay
   • Content: your-verification-token
   • TTL: Auto (or 3600)
6. Click Save

Google Domains

1. Log in to Google Domains
2. Select your domain
3. Go to DNS tab
4. Scroll to Custom resource records
5. Click Add custom record
6. Enter:
   • Name: _zopay
   • Type: TXT
   • Data: your-verification-token
   • TTL: 3600
7. Click Add

AWS Route 53

1. Log in to AWS Console
2. Go to Route 53 → Hosted zones
3. Select your domain
4. Click Create record
5. Enter:
   • Record name: _zopay
   • Record type: TXT
   • Value: your-verification-token
   • TTL: 3600
6. Click Create records

Troubleshooting

"DNS TXT record not found" Error

Possible Causes:

• DNS hasn't propagated yet - Wait 15-30 minutes and try again
• TXT record not added correctly - Double-check the record in your DNS provider
• Wrong record name - Must be exactly _zopay (not zopay or _zopay.)
• Wrong domain - Ensure you're adding the record for the exact domain you registered

Solutions:

1. Check DNS propagation:

   1# Using dig (Linux/Mac)
   2dig TXT _zopay.yourdomain.com
   3
   4# Using nslookup (Windows)
   5nslookup -type=TXT _zopay.yourdomain.com

2. Verify record in DNS provider:
   • Log in to your DNS provider
   • Check that the TXT record exists
   • Verify the name is exactly _zopay
   • Verify the value matches your verification token exactly
3. Wait longer:
   • DNS propagation can take up to 48 hours in rare cases
   • Try again after waiting

"DNS lookup timeout" Error

Possible Causes:

• DNS server issues - Temporary DNS server problems
• Network connectivity issues

Solutions:

• Try again - Usually resolves itself
• Check your domain's DNS settings - Ensure DNS is configured correctly
• Contact support if the issue persists

Vercel Domain Verification Issues

Problem: Can't verify *.vercel.app domain

Solution:

• You cannot verify Vercel preview domains
• You must use a custom domain
• Add your custom domain to Vercel first
• Then add the TXT record to your domain's DNS provider (not Vercel)

Quick Reference

TXT Record Format

1Type: TXT
2Name: _zopay
3Value: [your-verification-token]
4TTL: 3600 (or default)

Full DNS Record Name

1_zopay.yourdomain.com

Verification Steps

1. ✅ Add domain in ZoPay dashboard
2. ✅ Copy verification token
3. ✅ Add TXT record to your DNS provider
4. ✅ Test DNS record using online tools (recommended)
5. ✅ Wait 15-30 minutes for propagation
6. ✅ Click "Verify Domain" in ZoPay
7. ✅ Domain is verified!

FAQ

Q: Can I verify a Vercel preview domain (e.g., `app.vercel.app`)?

A: No. Vercel preview domains cannot be verified because you don't have DNS control. You must use a custom domain.

Q: How long do I need to wait after adding the TXT record?

A: Typically 15-30 minutes, but can take up to 48 hours. You can try verifying immediately, but it may fail until DNS propagates. We recommend testing the DNS record first using online tools before clicking verify.

Q: Can I click "Verify Domain" multiple times?

A: Yes! It's safe to retry. Once DNS propagates, verification will succeed.

Q: Where do I add the TXT record for a Vercel site?

A: Add it to your domain's DNS provider (where you registered the domain), NOT in Vercel. Vercel only handles A/CNAME records for routing.

Q: What if verification keeps failing?

A:

1. Check that the TXT record exists in your DNS provider
2. Verify the record name is exactly _zopay
3. Verify the value matches your token exactly
4. Test DNS propagation using online tools (dnschecker.org, mxtoolbox.com)
5. Wait longer (up to 48 hours)
6. Contact ZoPay support if still failing

Q: Should I test the DNS record before clicking verify?

A: Yes, highly recommended! Use online tools like dnschecker.org or command-line tools to verify the record is visible before clicking "Verify Domain". This saves time and avoids unnecessary verification attempts.

Next Steps

• Learn about Gateway Configuration
• View Using the API guide
• Check the FAQ for more answers