为什么需要验证域名
你的官网是产品对外的门面。在我们批准 KYB 并启用生产支付之前，需要确认产品官网 字段填写的域名确实属于你。每个店铺只需完成一次域名验证，KYB 通过后绑定关系会保留。
有两个入口可以完成验证 —— 两者写入同一份后端状态，只需在任意一处验证一次：
- Settings → General —— 任何时候都可以独立完成（或重新）验证，不必走 KYB 流程。
- Settings → Business Details → 第 8 步（Website URL） —— 在提交 KYB 时内联完成。该步骤中域名未验证时，“Submit for review” 按钮会保持禁用。
四种验证方式
Pancake 提供四种等价的验证方式，按你已有的能力选一种即可。任选其一。任意一种验证成功后，其他方式即不再需要。
方式 1 — 邮箱域名自动匹配（推荐）
如果你在 第 7 步（Contact Email） 验证过的客服邮箱与官网同一域名，Pancake 会自动识别并展示一键 Verify domain 按钮。 示例：客服邮箱support@acme.com（已验证） + 官网 https://acme.com → 自动匹配可用。
- 点击 Verify domain。
- Pancake 在服务端校验邮箱/域名匹配关系，立刻完成验证。
team@gmail.com 而官网为 acme.com），该选项会被隐藏，请使用下面的手动方式。
方式 2 — DNS TXT 记录
最稳定的方式，在域名 DNS 区域中添加一条 TXT 记录。- 在仪表盘点击 Use another method → DNS TXT。
- Pancake 展示三项：
- 类型（Type）：
TXT - 主机/名称（Host / Name）：
_waffo-challenge（仪表盘已自动去掉.your-domain.com后缀，多数 DNS 服务商会自动补上） - 值（Value）：以
waffo-domain-verify=…开头的一次性挑战字符串
- 类型（Type）：
- 在 DNS 服务商的控制台按上述内容添加记录，TTL 留默认值即可。
- 等待 DNS 传播。多数服务商分钟级生效（Cloudflare、Route 53 几乎是即时的）。
- 回到 Pancake，点击 I’ve added the record。我们会查询公开 DNS 中的 TXT 值，匹配成功即完成验证。
验证成功后可以保留这条 TXT 记录。即便后续删除也不会影响已建立的绑定 —— 我们只在验证时刻进行检查。
各服务商添加 TXT 的位置
如果你的服务商要求填完整记录名，请使用
_waffo-challenge.your-domain.com 而不是只填 _waffo-challenge。
方式 3 — HTML <meta> 标签
适合无法修改 DNS、但能修改站点代码的场景。
- 在仪表盘点击 Use another method → HTML meta tag。
- Pancake 展示如下代码片段：
- 把它加到官网首页（
https://your-domain.com/）的<head>中。 - 部署。检查浏览器 view-source 中能看到该标签 —— 如果只在 JS 执行后注入，我们的爬取请求可能在水合前就已发出。纯客户端 SPA 建议改用方式 2 或方式 4。
- 回到 Pancake，点击 I’ve added the tag。
方式 4 — .well-known 文件
把一个静态文件放到约定路径下，适合任何能托管静态资源的环境。
- 在仪表盘点击 Use another method → .well-known file。
- Pancake 展示：
- 文件 URL：
https://your-domain.com/.well-known/waffo-verify.txt - 文件内容：一行
waffo-domain-verify=…字符串
- 文件 URL：
- 将文件部署到完全一致的路径，确保返回
200 OK、Content-Type: text/plain（或任意文本类型），文件内容只有挑战值，不要带额外空白。 - 在浏览器中访问该 URL，确认返回的内容正确。
- 回到 Pancake，点击 I’ve uploaded the file。
常见错误：把文件部署成
/.well-known/waffo-verify（缺扩展名），或返回 301 跳转到 www.your-domain.com，这两种都会失败。请使用 Pancake 给出的完整 URL，并保证文件由你在表单中填写的”主域 / 标准主机”提供服务。故障排查
“找不到记录 / 标签 / 文件”
请重新核对值。每次发起验证生成的挑战都是独立的；只要在 Pancake 点击 Refresh，旧值即失效。请确认你贴的是最新值。TXT 已添加但仍然验证失败
DNS 缓存。可以用dig TXT _waffo-challenge.your-domain.com（Linux/macOS）或 nslookup -type=TXT _waffo-challenge.your-domain.com（Windows）排查。如果还看不到记录，等 5–10 分钟再重试。
挑战已过期
每个挑战的有效期较短（仪表盘按钮下方会显示精确时间）。过期后在 Pancake 点击 Refresh 生成新挑战，再用新值更新 DNS / meta / 文件。之后想要更换官网域名
KYB 通过前，直接在 第 8 步（Website URL） 解绑当前域名、验证新域名即可，随时可改。 KYB 通过后，换域名需要经过审核，但整个流程仍在仪表盘自助完成，不需要联系客服。见下方开通生产后更换域名。开通生产后更换域名
官网域名是 KYB 审核过的信息之一，所以开通生产后换域名是一次「需要审核的变更」，而不是随手可改的字段。入口在 设置 → 通用，从发起到生效都在仪表盘里完成。只有门店 owner 和受邀的 admin 可以发起换域名，而且只能在仪表盘操作，API 不开放这个流程。
流程
- 打开 设置 → 通用，在网站字段旁点击 更换域名。
- 输入新域名。Pancake 会立刻检查能不能用，不能用时会告诉你原因：格式不对或填了 IP、是公共邮箱的域名、和当前域名相同、已被你名下另一家店验证（会告诉你是哪家）、已被其他商户占用、还有一张申请在处理中、或者还在等待期内。
- 用上面四种方式中的任意一种证明新域名归你。验证凭证 24 小时内有效；同一家店再次发起会让之前的凭证失效。
- 验证通过后，页面显示 已验证，尚未生效。此时一切照旧：当前域名正常收款，网站字段没变，新域名也还没绑定。我们会访问一次
https://<新域名>，打不开的话会给出醒目提示，但不会拦着你提交。 - 需要的话补充一段说明（这个域名之前被拒过时必须填写），二次确认后提交。请在验证通过后 7 天内提交，超过要重新验证。
审核期间
换域名申请和 KYB 进件走同一条审核队列，处理方式也一样。- 审核期间，当前域名一直正常收款。
- 提交后的申请不能撤回，目标域名也不能再改。填错了请等审核结果出来再重新发起。
- 申请受理和出结果时各会收到一封邮件。
可能的结果
切换之后
切换后有 7 天过渡期：这期间仍然从旧域名发起的交易不会被当作违规。仪表盘会显示截止日期和倒计时，第 5 天我们还会发一封提醒邮件。请在过渡期结束前把收银链接、跳转和各项集成都改到新域名。例外：上线时还没有已验证域名的门店。 这类门店是第一次绑定域名，没有旧域名需要过渡，所以没有过渡期、没有倒计时，也不会发第 5 天的提醒邮件，
store.domain_changed 里的 oldDomain 为 null。这次绑定也不会触发 30 天等待期（见下方「限制」）。限制
- 每家门店同一时间只能有一张换域名申请在处理中。
- 换成功后要等 30 天 才能再次发起。上线时没有已验证域名的门店，第一次绑定不算换域名，不开启等待期，可以马上再发起。
- 被拒、切换失败或验证过期后，下一次发起会被延后，依次是 5 分钟、30 分钟、2 小时、24 小时。仪表盘会告诉你什么时候可以再试。
- 一家门店始终只有一个已验证域名，不会同时保留两个。
程序化 / API 接入
如果你在自动化引导流程中需要调用域名验证，对应接口为：
均需商户 JWT（或 API Key）和标准的
X-Environment 请求头。