なぜドメイン認証が必要か
サイトはプロダクトの公の顔です。KYB を承認し本番決済を有効化する前に、Product website に登録するドメインがあなたのものであることを確認する必要があります。ドメイン認証はストアごとに 1 回のみで、KYB 承認後もバインディングは保持されます。
入口は2つあります — どちらも同じバックエンド状態を更新するため、いずれか1箇所で認証すれば十分です:
- Settings → General — KYB の流れとは独立して、任意のタイミングでドメインを認証（または再認証）できます。
- Settings → Business Details → ステップ 8 (Website URL) — KYB 提出時にインラインで完了させます。このステップでドメインが未認証の場合、「Submit for review」ボタンは無効のままになります。
4 つの認証方法
Pancake は 4 つの同等な認証方法を提供します。既存のスタックに合うものを 1 つ選んでください。いずれか 1 つを選びます。1 つでも認証が成功すれば、他の方法は不要です。
方法 1 — メールドメイン自動マッチ（推奨）
ステップ 7 (Contact Email) で認証済みのサポートメールがサイトと同じドメインの場合、Pancake が自動で検知し、ワンクリックの Verify domain ボタンを表示します。 例：サポートメールsupport@acme.com（認証済み） + サイト https://acme.com → 自動マッチ可能。
- Verify domain をクリック。
- Pancake がサーバ側でメール／ドメインの一致を検証し、即座に認証完了。
acme.com でメールが team@gmail.com）の場合、このオプションは表示されません。下の手動方法のいずれかを使ってください。
方法 2 — DNS TXT レコード
最も確実な方法です。ドメインの DNS ゾーンに TXT レコードを追加します。- ダッシュボードで Use another method → DNS TXT をクリック。
- Pancake が 3 つの値を表示します：
- Type：
TXT - Host / Name：
_waffo-challenge（ダッシュボード側で.your-domain.comのサフィックスを除去済み — 多くのプロバイダで自動的に補完されます） - Value：
waffo-domain-verify=…で始まる一回限りのチャレンジ文字列
- Type：
- DNS プロバイダの管理画面で表示通りにレコードを追加。TTL はデフォルトで構いません。
- 伝播を待ちます。多くは数分以内（Cloudflare、Route 53 はほぼ即時）。
- Pancake に戻り I’ve added the record をクリック。公開 DNS の TXT 値を照合し、一致すれば認証完了。
認証後も TXT レコードはそのまま残しておけます。後から削除しても既存のバインディングには影響しません — 検証は認証時点でのみ行います。
主要プロバイダの TXT 追加先
プロバイダがフルレコード名を要求する場合、
_waffo-challenge ではなく _waffo-challenge.your-domain.com を入力してください。
方法 3 — HTML <meta> タグ
DNS は変更できないが、サイトのコードはデプロイできる場合に便利です。
- ダッシュボードで Use another method → HTML meta tag をクリック。
- 表示されるスニペット：
- サイトのトップページ（
https://your-domain.com/）の<head>内に追加。 - デプロイし、ブラウザの「ページのソースを表示」でタグが含まれていることを確認します。JS 実行後にのみ挿入されるタグだと、当社のクローラがハイドレート前にアクセスした場合に失敗する可能性があります。完全クライアント側レンダリング SPA の場合は方法 2 か方法 4 を推奨します。
- Pancake に戻り I’ve added the tag をクリック。
方法 4 — .well-known ファイル
固定パスに静的ファイルを配置します。静的ファイルを配信できる環境ならどこでも使えます。
- ダッシュボードで Use another method → .well-known file をクリック。
- Pancake が表示する内容：
- File URL：
https://your-domain.com/.well-known/waffo-verify.txt - File contents：
waffo-domain-verify=…の 1 行
- File URL：
- ファイルを完全に同じパスに配置。レスポンスが
200 OK、Content-Type: text/plain（または任意のテキスト系）、本文がチャレンジ値のみ（余計な空白なし）であることを確認。 - ブラウザでその URL を開き、内容が正しいことを確認。
- Pancake に戻り I’ve uploaded the file をクリック。
よくあるミス：
/.well-known/waffo-verify（拡張子なし）に配置する、または www.your-domain.com への 301 リダイレクトを返す。どちらも失敗します。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 アドレス、フリーメールのドメイン、現在と同じドメイン、ご自身の別ストアが認証済み（ストア名を表示）、既に使用中、申請が進行中、待機期間中）。
- 上記 4 つのいずれかの方法で新しいドメインの所有を証明します。チャレンジの有効期限は 24 時間で、同じストアで新しく発行すると以前のものは失効します。
- 認証に成功すると 認証済み（未反映） と表示されます。この時点では何も変わりません。現在のドメインで決済は継続し、ウェブサイト欄も変わらず、新しいバインディングもまだありません。あわせて
https://<新しいドメイン>へ 1 回だけ到達性を確認し、応答がない場合は警告を表示しますが提出はできます。 - 必要に応じて補足説明を入力し（同じドメインが過去に却下されている場合は必須）、確認のうえ提出します。認証から 7 日以内に提出してください。過ぎた場合は再認証が必要です。
審査中について
申請は事業審査と同じキューに入り、同じ手順で処理されます。- 審査中も現在のドメインで決済を継続できます。
- 提出済みの申請は取り下げできません。対象ドメインの変更もできません。誤ったドメインを選んだ場合は、結果が出てから新しい申請を作成してください。
- 申請の受付時と結果確定時にメールをお送りします。
想定される結果
切り替え後
7 日間の移行期間 があります。この期間に旧ドメインへ届いた取引は無許可の再販とはみなしません。ダッシュボードに期限とカウントダウンを表示し、5 日目にリマインドメールをお送りします。期間が終わる前に、チェックアウトリンク・リダイレクト・各種連携を新しいドメインへ切り替えてください。例外 — 認証済みドメインがないまま本番を開始した店舗。 この初回バインドには受け続ける旧ドメインがないため、移行期間もカウントダウンも 5 日目のリマインドもありません。
store.domain_changed の oldDomain は null になります。待機期間も開始しません（下記「制限」を参照）。制限
- 1 ストアにつき進行中のドメイン変更申請は 1 件までです。
- 変更が成功した後、次の申請までに 30 日間 お待ちいただきます。認証済みドメインがなかった店舗の初回バインドはここでの変更に数えません —— 待機期間は始まらないため、すぐに次の申請ができます。
- 却下・切り替え失敗・認証の期限切れのあとは、次回の申請までに待ち時間が入ります（5 分 → 30 分 → 2 時間 → 24 時間）。再試行できる時刻はダッシュボードに表示されます。
- ストアが保持する認証済みドメインは常に 1 つだけで、2 つを同時に保持することはありません。
プログラム／API での利用
オンボーディングを自動化する場合、対応エンドポイントは：
いずれもマーチャント JWT（または API キー）と標準の
X-Environment ヘッダーが必要です。