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

# セルフサーブ登録、サンドボックス、アカウント認証

> 自己登録した加盟店が実際に歩む道筋：アカウント作成、メールアドレスの確認、会社に関する質問への回答、6 ステップのセットアップウィザードによるサンドボックスの構成、サンドボックス認証情報の取得、そして 7 ステップのアカウント認証の完了（申請が返却された場合の対処を含む）。

[クイックスタート](/docs/ja/developer-docs/getting-started/quickstart)は、すでに認証情報を持っている段階から始まります。
このページはその前段階、つまり Portal が自己登録した加盟店に何をどの順序で求めるかをすべて説明します。セルフサーブ登録とサンドボックスセットアップウィザードはアカウントごとに有効化されます。**Portal 上でその画面が見えるなら、貴社で利用可能です**。入口が表示されていない場合は、
[support@waffo.com](mailto:support@waffo.com) に開放を依頼してください。

## 登録から本番決済までの全体の流れはどのようになっていますか？

| 段階 | 場所 | 得られるもの |
| - | - | - |
| 登録 | `/auth/sign-up` | アカウント（メールアドレス未確認） |
| メールアドレスの確認 | `/auth/sign-up/verify-email` | 利用可能なログイン |
| 会社の基本情報 | `/auth/get-started` | 最初のドラフトレコード。サンドボックスのプロビジョニングが開始されます |
| サンドボックスセットアップウィザード | `/sandbox-setup/step/1` … `/step/6` | 構成済みのサンドボックスと API 認証情報 |
| アカウント認証 | `/verify-account` | 提出済みの認証申請 |
| 本番稼働 | 認証が承認された後 | 実際の決済を受け付ける能力 |

ホームページにはこの一覧に対応した進捗パネルが表示されるため、どこで離れても再開できます。

## アカウントを作成してメールアドレスを確認するにはどうすればよいですか？

登録にはメールアドレスとパスワードが必要です。強度インジケーターは、大文字、小文字、数字、最小文字数をチェックします。代替手段として Google サインインも提供されています。確認は、アカウントの作成方法に応じて 2 つの形式のいずれかで届きます：確認画面に入力する**6 桁のコード**（貼り付けも可能で、6 つのボックスが自動的に埋まります）、またはメール内でクリックする**確認リンク**です。**Resend** が再び利用可能になるまでにはカウントダウンがあります。コードが届かない場合は、再登録するのではなく、カウントダウンが終了してから再送してください。2 回目の登録は新しいアカウントを開始してしまいます。

続く **Get started** 画面では、**会社の正式名称**と**設立国/地域**のみを求められます。これは最初のレコードを作成し、サンドボックスの準備を開始するのに十分な情報です。この画面は後のアカウント認証で、入力済みの状態で再度表示されます。

## サンドボックスセットアップの 6 つのステップでは何を求められますか？

| ステップ | 画面 | 入力する内容 |
| - | - | - |
| 1 | Tell us about your business | 会社の正式名称、公式ウェブサイト（任意）、主な事業タイプ、設立国 |
| 2 | Select your Waffo products | ワンタイム決済、サブスクリプション決済、またはその両方 |
| 3 | Choose pricing strategy | グローバル USD 価格設定、または現地通貨価格設定 |
| 4 | Select your target markets | 地域ごとにグループ化された国/地域、および **Global** オプション。ドラッグ選択と地域ごとの全選択に対応 |
| 5 | Manage your payment methods | 生成された各行の有効/無効を切り替え、その注文通貨を選択 |
| 6 | Sandbox Ready | 入力なし。ウィザードはプロビジョニングを待ち、その後、次のステップを案内します |

ステップは進捗によって制御されています。ウィザードは実際に完了した最も先のステップまで戻すため、未回答の質問を飛び越えてディープリンクすることはできません。**事業タイプ**は単一選択のカテゴリーリストです（AI/SaaS、ゲーム、EC、ストリーミング、教育、旅行、フィンテック、マーケットプレイス、ソーシャル・チャットアプリ、デジタルコンテンツなど）。ステップ 1 の**設立国**は短いカードリストです。該当する国がない場合は、最も近いものを選ぶのではなく、そのステップの *Contact us* リンクを使用してください。

## 製品、価格戦略、市場によって、テストできる内容はどのように変わりますか？

これらは見た目だけのものではなく、決済手段リストへの入力です。ステップ 4 を離れると、Portal は選択した組み合わせそのものに対する決済手段をプレビューし、ステップ 5 には返ってきたものだけが表示されます。

| フィールド | 値 |
| - | - |
| `productSolution` | `ONE_TIME_PAYMENT`、`SUBSCRIPTION`、`BOTH`（ステップ 2 で両方の製品を選択すると `BOTH` が送信されます） |
| `pricingStrategy` | `GLOBAL_USD`、`LOCAL_CURRENCY` |

選択前に知っておくべき 2 つの影響があります。**サブスクリプションのみ + グローバル USD 価格設定**では、選択可能なローカル市場はなく、Global オプションのみとなります。**サブスクリプションのみ + 現地通貨価格設定**では、ステップ 4 は現地通貨サブスクリプションが提供されている少数の市場に絞られ、残りの市場チップは非表示ではなくグレーアウトされます。製品選択や価格戦略を後から変更すると、**下流の選択は意図的にクリアされます**。以前のリストはもはや有効ではないためです。

ステップ 5 には Country/Region、Product、Payment method type、Payment method、Order currency、Status が一覧表示され、国、手段タイプ、有効/無効でフィルタリングできます。人気のある手段はあらかじめ有効化されています。有効のままにした各行には少なくとも 1 つの注文通貨を選択する必要があり、そうでない場合ステップは進みません。

## Global 市場と国の違いは何ですか？

**Global** は市場リストで国と並んでいますが、国ではありません。これはどの国にも属さないグローバルカードスキームを表しており、リスト内の他のすべての項目は、ローカル決済手段をテストしたい国または地域です。

この 2 つは**二者択一ではありません**。これがステップ 4 で最もよくある誤解です：

| 選択内容 | ステップ 5 で得られるもの |
| - | - |
| Global のみ | グローバルカード決済手段のみ。ローカルのものはなし |
| 国のみ | それらの国のローカル決済手段のみ。グローバルカードはなし |
| Global **と**国 | 両方。これが通常の選択です |

Global を選択しても国の選択はクリアされず、国を選択しても Global はクリアされません。世界中どこでもカード決済を受け付け、*かつ* 2 つの市場でローカル手段も受け付けたい場合は、3 つすべてを選択してください。ステップ 5 では、グローバルの行は **Global** という国ラベルの下にグループ化され先頭にソートされるため、国の行と一目で区別できます。

## 期待していた決済手段がステップ 5 に表示されないのはなぜですか？

ステップ 5 は何も照会しません。リストは**ステップ 4** を離れる際に、製品選択、価格戦略、市場というちょうど 3 つの入力から生成され、ステップ 5 は返ってきたものを表示します。したがって、入力をその順序で確認してください：

| 確認事項 | 影響する理由 |
| - | - |
| その手段の国はステップ 4 で選択されていますか？ | 選択した市場の外にあるものは提供されません。グローバルカードには、国ではなく **Global** の項目が必要です |
| ステップ 5 のフィルターはクリアされていますか？ | 国、決済手段タイプ、有効/無効は、すでに持っているリストに対する**表示フィルター**です。設定されたままのフィルターは、何も告げずに行を隠します |
| 製品選択はその手段をカバーしていますか？ | リストは製品ごとに生成されます。ワンタイム決済のみに提供される手段は、サブスクリプションのみのプレビューには表示されません |
| 価格戦略はその通貨を許可していますか？ | グローバル USD 価格設定では、注文通貨のセルは**読み取り専用**です。行を有効化できるのは、プレビューがその行に対して返した通貨のみです |

テーブルが完全に空で返ってきた場合、説明ではなく空のテーブルとして表示されます。ステップが壊れていると考えるのではなく、ステップ 4 に戻って市場を広げてください。

このステップが*そうではない*ものが 2 つあります。本番契約ではなく（下記参照）、Waffo の完全なカタログでもありません。稼働中のアカウントで受け付けられるものは
[Service → Payin](/docs/ja/support/payin-agreements-and-limits-faq) に、コードからは
`/api/v1/paymethodconfig/inquiry` で確認できます。
[決済手段の設定と限度額](/docs/ja/support/payment-method-config-and-limits-faq)をご覧ください。

## サンドボックスで決済手段をオフにすると、本番環境も変わりますか？

いいえ。ウィザードと **Settings → Sandbox Config** は、*サンドボックス*の構成のみを書き込みます。本番環境で受け付けられるものは貴社の Payin 契約であり、これは Waffo 側で設定され、**Service → Payin** で読み取れます。ウィザードがこれに書き込むことはありません。

この影響は双方向に及びます。本番稼働前に理解しておく価値があります：

| 状況 | 意味 |
| - | - |
| サンドボックスで有効、Service → Payin に存在しない | 本番環境では契約されていません。テスト用に有効化しても、実際には有効化されていません |
| サンドボックスで無効、Service → Payin で `Active` | 本番の決済には影響しません。テスト対象を狭めただけです |
| 両方に存在 | 今日エンドツーエンドで連携できるものです |

サンドボックスでは動作するが本番環境では失敗する手段は、最初の行の目に見える症状です。
[限度額、通貨、設定エラー](/docs/ja/support/error-codes-and-limits-supplement)ではその失敗がどのように見えるかを、
[サンドボックス環境とアクセス](/docs/ja/support/sandbox-environment-and-access-faq)では 2 つの環境がどのように互いに分離されているかを説明しています。

## ページに「Default configuration」と表示されています。何も設定しなくてもテストできますか？

はい。**Settings → Sandbox Config** には 2 つのバッジのいずれかが表示されます：

| バッジ | 意味 |
| - | - |
| `Default configuration` | セットアップウィザードを完了していません。すぐにテストを開始できるように、製品、価格戦略、市場、人気のある決済手段の初期選択が設定されています |
| `Configured` | 貴社自身が提出した構成が有効です |

実際のデフォルトセットは、いかなるドキュメントではなく、そのページから読み取ってください。それはページが表示するものであり、出発点であってコミットメントではありません。**Customize** は現在の値を初期値としてステップ 1 からウィザードに再度入ります。これらのコントロールはいずれも API 認証情報には影響しません。編集中の内容に対して **Reset** と **Clear all** が何をするか、また再提出が選択をパッチではなく置き換える仕組みについては、
[サンドボックス環境とアクセス](/docs/ja/support/sandbox-environment-and-access-faq)をご覧ください。

## 提出がエラーで返ってきました。どうすればよいですか？

提出はオール・オア・ナッシングであり、失敗はフィールド単位のエラーではなく単一のメッセージとして届くため、クリーンアップすべき部分的な状態はありません。回答はウィザードに残っています。メッセージが指摘する箇所を修正して再度提出してください。

提出前にローカルで強制されるルールが 1 つあります。**有効のままにしたすべての決済手段には、少なくとも 1 つの注文通貨が選択されていなければなりません**。そうでない場合、ステップは進行を拒否し、その旨を表示します。これが、提出をまったく試行できない最もよくある理由です。

最終ステップでサンドボックス構成が存在しないと報告された場合、ステップ 5 に戻されます。何も失われていません。提出は届いていないので、そこから再提出してください。

## サンドボックス認証情報はどこで取得できますか？

ステップ 6 は数秒ごとに認証情報の準備状況をポーリングし、それが存在するまで「setting up your sandbox」の状態を表示します。**ポーリングにはタイムアウトがない**ため、長時間回り続けているページは何かをカウントダウンしているわけではなく、まだ準備完了を待っているだけです。待ち続けるより問い合わせる価値があります。準備が完了すると、サンドボックスの MID、API キー、鍵情報は **Settings → Integration → API Keys** に、テストカードライブラリ（成功と拒否のシナリオのみ。3DS チャレンジのテストカードはありません）は **Settings → Integration → Test cards** に置かれます。ステップ 6 でサンドボックス構成が存在しないと報告された場合、ウィザードは提出のためにステップ 5 に戻します。提出は届いておらず、認証情報は失われていません。

その後、**Settings → Sandbox Config** で同じ 4 つの決定事項が編集可能なレビューフローとして公開されます。再提出は 1 行をパッチするのではなく選択したセット全体を置き換え、構成変更によって API 認証情報が影響を受けることはありません。

## アカウント認証では何を求められますか？

`/verify-account` は 7 ステップのウィザードです（追加書類を求められた場合は 8 ステップ）。続行するには各ステップを完了する必要があります：

| ステップ | 続行に必要なもの |
| - | - |
| Business type | 設立国、事業タイプ、法的構造 |
| Business details | 会社の正式名称、登記番号、公式ウェブサイト、登記住所（住所、市、国） |
| Products & channels | 製品カテゴリー、製品説明、チャネルタイプと URL の両方を持つ少なくとも 1 つの販売チャネル |
| Key people | 署名権限を持つ取締役（姓/名、ID タイプ、発行国、ID 番号）。さらに、「same as signing director」にチェックを入れない限り主要連絡担当者 |
| Ownership & control | 所有形態。個人所有または混合所有の場合、完全な個人情報、ID、居住住所の詳細を含む少なくとも 1 名の UBO。持分比率の合計は 100% 以下 |
| Documents | 以前の回答から導出されます。下記参照 |
| Additional Requirements | 追加書類を求められた場合のみ表示されます。要求されたすべてのファイルをアップロードする必要があります |
| Review & Submit | すべての前のステップが完了していること、および最終確認 |

**Documents** は固定のチェックリストではありません。常に設立証明書と署名権限を持つ取締役の ID 書類を求め、次に法人所有または混合所有の場合は株主構成図を、主要連絡担当者が別人の場合はその ID 書類を、そして UBO ごとの ID 書類と住所証明を追加します。すでに署名権限を持つ取締役または主要連絡担当者として記載されている人が、同じ ID を二度求められることはありません。受け付けられる形式は PDF、JPG、JPEG、PNG で、それぞれ保存前に暗号化されます。サイズ制限は Documents パネル自体に表示されます。アップローダーごとに強制されるため、このページではなくそこで確認してください。端が鮮明で完全なカラー画像をアップロードしてください。すべてのフィールドには参考例付きの *Guidelines* パネルがあります。

回答は続行するたびにドラフトとして保存され、`/verify-account` を再度開くと、アップロード済みファイルと到達したステップを含めて復元されます。提出は後戻りできないポイントです。申請は審査に入り、**返却されない限り編集できません**。

## 申請が Returned として返ってきました。何を修正すればよいですか？

| 表示されるステータス | ウィザードで可能な操作 |
| - | - |
| Draft | すべて編集可能 |
| In review | 読み取り専用 |
| Returned | フラグが付いた項目のみ編集可能 |
| Approved / verified | 読み取り専用 |
| Rejected | 読み取り専用 |

返却モードでは、ウィザードは範囲を厳密に示します。審査担当者のメモが上部に表示され、ステップインジケーターは返却項目を含むステップをマークし、個々のフィールドと書類はその項目に対するメモとともにその場でフラグ付けされ、それ以外はすべてロックされたままです。ステップの項目に対処するとフラグは消えるため、マークは To-Do リストとしても機能します。修正して再提出してください。再提出された申請は再び審査中として扱われます。

## Portal にはメールアドレスが表示され、連携にはサポートグループがあります。どちらを使えばよいですか？

これらはオンボーディングの異なる半分に対応しており、間違った方を使うことが質問が未回答のまま放置される通常の理由です：

| 質問内容 | 送り先 |
| - | - |
| ウィザードのステップ、Portal の画面、表示されない入口、認証申請 | 現在の画面に表示されているオンボーディング用アドレス |
| 連携の動作、エラーコード、サンドボックスのテスト結果、および**受け入れに関するすべて** | 貴社の Waffo テクニカルサポートグループ |

特に受け入れはグループのみです。完成した
[受け入れテンプレート](/docs/ja/developer-docs/tools-and-references/references/acceptance-criteria)はテクニカルサポートグループに提出され、そこで確認されます。同じ場所で終わる
[クイックスタート](/docs/ja/developer-docs/getting-started/quickstart)もご覧ください。

***

ステップで行き詰まっている、または Portal に入口が表示されていない場合は、現在の画面を添えて
[support@waffo.com](mailto:support@waffo.com) にメールしてください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.