Guides

Verified domains

Uncart's links may lead only to domains your shop has verified. Each domain gets a token, and you publish that token in one of two places. Uncart checks it, and keeps checking it every day. GET /v1/domains lists your domains and where each one stands.

You add a domain on the dashboard's Connection page. The page shows its token.

Which domains

Use the host your shoppers see, such as shop.example.com. Uncart writes it one way, in lower case, with an international name in its punycode form and no trailing dot. It must be a public name on HTTPS, with no port, path or user name.

Each host is verified on its own. Verifying example.com does not cover shop.example.com or www.example.com. Add every host your links should reach.

Uncart refuses some domains outright. IP addresses are out, in any spelling. So are internal or reserved names like localhost, .local, .internal and .test. A name that imitates another one with lookalike letters is refused too, such as a Cyrillic "а" in place of a Latin "a". The check uses Unicode's own confusables data. Real names in one script, like müller.example.com, still pass.

Proving it with a DNS record

Add a TXT record named _uncart-verification under your domain. Its value is uncart-verification= followed by your token.

DNS recordtxt-record.dns
; The TXT record, as a line of a DNS zone file. Your token is on your Connection page.
_uncart-verification.shop.example.com. 3600 IN TXT "uncart-verification=8fKq2ZtR0wLmV5nX7cJ3bY9hD1sA4gPe"

The value must be exactly that. A record with another token, or with your token inside a longer value, proves nothing. Records split into several strings are joined before the check, as DNS intends.

Proving it with a file

If you can't change DNS, serve a text file at https://<your domain>/.well-known/uncart-verification.txt. One of its lines must be exactly the same text as the record's value.

Textuncart-verification.txt
uncart-verification=8fKq2ZtR0wLmV5nX7cJ3bY9hD1sA4gPe

Uncart accepts the file only when all of these hold.

  • Over HTTPS, with a certificate that is valid for the domain.
  • Redirects are not followed. A 301 or 302 fails the check. Serve the file at that exact address.
  • The answer must arrive within 5 seconds and be at most 4 KB.
  • Every address the domain resolves to must be public. Uncart fetches nothing from a domain that points into a private network. It connects to the very address it checked, and a second DNS answer cannot send it elsewhere.

When Uncart checks

DomainChecked
Added, not verified yetEvery 15 minutes for 3 days, then only on request
VerifiedAgain every day
FailedEvery 6 hours, until its record or file is back

A verified domain fails at once when its record and file are both gone. Uncart then stops linking there, and the domain shows up under "Needs you" on your dashboard. A passing problem, like a DNS server that doesn't answer in time, fails it only on the third check in a row.

Keep the record or the file in place for as long as you use Uncart. It is checked every day, not only once.

Limits

A shop can have up to 20 domains and add up to 50 in a day, removed ones included.

An owner can ask for a check up to 12 times an hour. Only owners can add or remove a domain, after entering their second factor in the last ten minutes.