> ## 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.

# サンドボックス環境とアクセス FAQ

> Waffo のサンドボックスがどのように払い出されるのか、どの URL と加盟店 ID がサンドボックスのものか、サンドボックス設定ウィザードの動作と各回答が何を変えるのか、サンドボックスの鍵はどこから来るのか、そしてサンドボックスが本番環境からどう分離されているのかを説明します。

サンドボックス作業については 4 つのページがあり、それぞれ異なる問いに答えます。

| 質問 | ページ |
| - | - |
| どの URL、どのテストカードを使い、結果をどうシミュレートするのか？ | [サンドボックスとテスト](/docs/ja/developer-docs/getting-started/sandbox) と [サンドボックスシミュレーター](/docs/ja/developer-docs/tools-and-references/developer-tools/sandbox-simulator) |
| どうやってアクセスするのか、サンドボックスの加盟店 ID は何か、設定ウィザードは何を変えるのか、本番環境から何が分離されているのか？ | **このページ** |
| 何がシミュレートでき、何ができないのか、予約された金額はそれぞれ何をするのか？ | [サンドボックスのシミュレーション制限 FAQ](/docs/ja/support/sandbox-simulation-limits-faq) |
| 本番稼働の前に何を終えておく必要があるのか？ | [本番稼働チェックリスト](/docs/ja/developer-docs/getting-started/go-live) と [インテグレーションの受け入れ基準](/docs/ja/developer-docs/tools-and-references/references/acceptance-criteria) |

## サンドボックスを開設してもらうよう Waffo に依頼する必要がありますか？

いいえ。サンドボックスはセルフサービスで、自動的に作成されます。登録して事業情報を送信すると、追加の依頼も
Waffo スタッフの関与もなく、アカウントにデフォルトのサンドボックスが払い出されます。サンドボックスを*依頼する*ための
フォームはありません。

その後に行うのは任意の調整です。設定ウィザードでは、どのプロダクト、料金モデル、マーケット、決済手段を
サンドボックスに反映させたいかを Waffo に伝えられるため、サンドボックスが実際に構築しているインテグレーションを反映します。

## どの URL がサンドボックスで、どれが本番環境ですか？

これらは別々のホスト名を持つ別々の環境です。Portal 上でこれらを切り替えるものはありません — どちらか一方にサインインします。

| 対象 | サンドボックス | 本番環境 |
| - | - | - |
| 加盟店 Portal | `https://dashboard-sandbox.waffo.com` | `https://dashboard.waffo.com` |
| API | `https://api-sandbox.waffo.com` | `https://api.waffo.com` |
| ホスト型チェックアウト | `https://checkout-sandbox.waffo.com` | `https://checkout.waffo.com` |
| チェックアウト / サブスクリプション管理ページ | `https://cashier-sandbox.waffo.com` | `https://cashier.waffo.com` |
| 静的アセット | `https://cdn.waffo.com` | `https://cdn.waffo.com` |

サインイン中の環境の API アドレスは **加盟店 Portal → Integration** にも表示されるため、資料ではなく Portal の中から
いつでも確認できます。

Waffo の SDK を使う場合は、URL を手で編集するのではなく `Environment.SANDBOX` または `Environment.PRODUCTION` を設定してください。

## ファイアウォールや CSP でどのドメインを許可する必要がありますか？

自社のページと自社のネットワークポリシーについては、上記のドメインが顧客に面する完全な集合です。実務上は次のとおりです。

| 設定する対象 | 許可するもの |
| - | - |
| Waffo へのサーバー側アウトバウンド呼び出し | その環境の API ホスト |
| Waffo のチェックアウトを開く、またはフレーム表示するページ | その環境のチェックアウトおよび cashier ホスト |
| Waffo から表示される画像やロゴ | 静的アセットのホスト |

最初から組み込んでおくべき注意が 2 つあります。

* **IP ではなくホスト名を許可してください。** 本番稼働チェックリストは DNS TTL を 60 秒にすることを推奨し、
  Waffo の IP アドレスを固定することを明確に警告しています。それらは安定しておらず、公開もされていません。
* **サンドボックスと本番環境ではホスト名が異なります。** そのため、一方の環境を前提に書かれたポリシーは、
  もう一方を黙ってブロックします。ホストをハードコードせず、環境ごとにパラメーター化してください。

## サンドボックスの加盟店 ID は本番環境と同じですか？

いいえ — サンドボックスには独自の加盟店 ID があり、サンドボックス環境にいる間、お客様のユーザーアカウントは
そのサンドボックス加盟店 ID に紐づきます。

どちらを見ているかを推測する必要はありません。**加盟店 Portal → Integration** には、サインイン中の環境の加盟店 ID が、
認証情報の表の真上に、その環境の API アドレスとともに表示されます。サンドボックスの Portal セッションには、
サンドボックスにいることとすべてのデータがテストデータであることを示す固定バナーも表示されます。

インテグレーションにおける帰結：サンドボックスの認証情報はサンドボックスのデータに対してのみ、本番の認証情報は本番のデータに
対してのみ作用します。一方の環境の API キーで他方の環境のホストに認証したリクエストは、ビジネスロジックではなく
認証情報のチェックで失敗します — 正確なエラーコードは [認証と署名 FAQ](/docs/ja/support/auth-signature-faq) を参照してください。

## サンドボックス設定ウィザードは実際に何を変えるのですか？

6 ステップあり、各回答はサンドボックスに何が許可されるかではなく、サンドボックスがどう見えるかを形づくります。

| ステップ | 入力するもの | 影響するもの |
| - | - | - |
| 1 | 会社の法的名称、公式ウェブサイト、事業タイプ、設立国 | サンドボックスに表示される加盟店の identity（チェックアウト画面に表示される加盟店名を含む） |
| 2 | プロダクト：ワンタイム決済、サブスクリプション、またはその両方 | サンドボックスがどのプロダクトのフロー用に設定されるか |
| 3 | 料金戦略：`GLOBAL_USD` または `LOCAL_CURRENCY` | サンドボックスが単一の精算通貨を提示する構成か、マーケットごとの現地通貨価格の構成か |
| 4 | 対象マーケット | 決済手段の候補一覧がどの国から抽出されるか |
| 5 | 決済手段 | サンドボックスでどの決済手段が有効になるか |
| 6 | サンドボックス準備完了 | サンドボックスの API キーとキーペアを表示 |

ステップ 3 と 4 が合わさってステップ 5 を決めます：決済手段の候補一覧は、選択したプロダクト、料金戦略、マーケットから
導かれます。期待した決済手段がステップ 5 で表示されない場合、原因はほぼ常に 2 つ前のステップでのマーケットや料金の選択であり、
権限の不足ではありません。

## サンドボックスの設定を後から変更できますか？編集は追加ですか置き換えですか？

変更できます。そして編集は**選択セット全体を置き換えます** — 追加ではありません。再送信すると、送った選択内容が
完全な設定になります：含めなかったものは設定の一部ではなくなります。

実務上の帰結：編集する前に現在の設定を開き、頭の中にある差分だけを送るのではなく、すでに選択されている内容から始めてください。
「新しい決済手段だけ」を送ると、他のすべてが削除されます。

## 「Clear all」または「Reset」を押しました。取り消せますか？

はい — どちらも保存するまでは保存済みの設定に影響しません。

| 操作 | 何をするか |
| - | - |
| **Clear all** | 進行中の編集において、現在表示しているマーケットのすべての決済手段の選択を解除します |
| **Reset** | 保存していないマーケットと決済手段の変更を破棄し、最後に保存した設定を復元します |

つまり `Reset` は `Clear all` の取り消し*です*。また、保存せずに画面を離れた場合も、保存済みの設定は変わりません。
どちらの操作も先に確認を求めます。未保存の編集の中では、進行中の選択を破壊する操作だからです。

同じウィザードには、ボタン以上に人を驚かせる関連する挙動が 2 つあります。**プロダクト**や**料金戦略**を変更すると、
その下の決済手段と通貨の選択がクリアされます。以前の選択が新しい選択の下では有効でない可能性があるためです。
また、有効な決済手段が 1 つもないマーケットは、空のマーケットとして残るのではなく、マーケット一覧から除外されます。

## サンドボックスのステータスが PROCESSING のまま止まっています。各ステータスは何を意味しますか？

設定は 3 つの状態を経て進み、サンドボックスが利用可能になったことを意味するのは最後の 1 つだけです。

| ステータス | 意味 |
| - | - |
| `PROCESSING` | 送信済み。Waffo が非同期に適用中 |
| `COMPLETED` | 適用済み。アカウントがサンドボックス加盟店 ID に紐づけられ、鍵の生成が完了しつつある |
| `ACTIVE` | 有効。Portal セッションがサンドボックスで動作している |

非同期に適用されるため、短い `PROCESSING` の期間は正常であり、ウィザードの最終ステップは更新を求める代わりに
鍵が生成されるまでポーリングします。進行しない場合、設定レコードには Portal が表示するエラーメッセージが付き、
失敗は Waffo 側でもアラートを発します — そのため、繰り返し再送信するのではなく、サンドボックスの加盟店 ID を添えて
インテグレーションサポートに連絡するのが有効な行動です。

## サンドボックスの鍵はどこから来ますか？公開鍵を提出するのですか？

Waffo がサンドボックスのキーペアを生成します。ウィザードの最終ステップと **加盟店 Portal → Integration** に、
サンドボックスの API キー、公開鍵、秘密鍵が表示されるため、すぐに署名を始められます。

これは本番環境とは意図的に異なります。

| | サンドボックス | 本番環境 |
| - | - | - |
| キーペア | Waffo が生成し、秘密鍵を含めて表示される | お客様が生成し、Waffo が秘密鍵を保持することはない |
| 公開鍵の提出 | 提出するものがないため、機能自体がない | Integration ページから提出し、審査される |
| 鍵のローテーションとバージョン履歴 | 該当なし | Integration ページで利用可能 |

ここから 2 つのルールが導かれ、どちらも [本番稼働チェックリスト](/docs/ja/developer-docs/getting-started/go-live) に記載されています。

* **サンドボックスの鍵情報を本番環境に持ち込まないでください。** 本番用のペアを新たに生成してください。
  秘密鍵の側がブラウザに表示された鍵は、本番のシークレットではありません。
* **ホストと認証情報は一緒に切り替えてください。** これらはセットです。片方だけを変えると、コードのバグに見える署名の失敗が起きます。

本番環境の鍵の提出、項目が受け付ける正確な形式、ローテーションの仕組みは
[本番環境の公開鍵と API オペレーションタイプ](/docs/ja/support/production-api-key-and-public-key-faq) で説明しています。

## サンドボックスのレート、精算サイクル、出金のしきい値、上限は、実際の商用条件ですか？

いいえ。サンドボックスの設定は、フローが端から端まで動くようにデフォルト値から払い出されたものであり、商用契約の写しではありません。
サンドボックスで目にする数値を見積もりや、本番環境で適用される数値として読まないでください。サンドボックスの金額、サイクル、
しきい値は*仕組み*をテストするための足場 — 項目が埋まる、計算が走る、ステータスが遷移する — として扱い、本番稼働後に
実際の値を本番環境の設定で確認してください。

## サンドボックスは実際の決済チャネルに接続していますか？

いいえ。サンドボックスは実際の決済チャネルに接続しておらず、実際の資金は動きません。実際の決済手段の選択の代わりに、
サンドボックスのチェックアウト画面には結果を直接決められるシミュレーション用の操作が用意されています。
シミュレーションのフローはすべての決済手段で同じです。

これがサンドボックスの結果について最も重要な理解です：サンドボックスが証明するのは、**お客様の**インテグレーションが
各結果を正しく処理することです。特定の決済手段が実際のエンドユーザーに対してどう振る舞うかについては何も証明しません。
何が再現でき、何ができないかは [サンドボックスのシミュレーション制限 FAQ](/docs/ja/support/sandbox-simulation-limits-faq) に
列挙されています。

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

いいえ。どちらの方向にも同期しません。サンドボックスの設定と本番環境の設定は独立しています：サンドボックス設定ウィザードは
サンドボックスの Portal にのみ存在し、本番環境からはまったくアクセスできません。また、本番環境の設定変更がサンドボックスに
反映されることもありません。

つまり、ある決済手段で取引できるサンドボックスは、コードの経路が動作することを示すだけで、権限を示すものではありません。
本番環境での利用可否は契約に従い、本番環境で決済手段を有効にするのは別のステップです。
[決済手段の登録](/docs/ja/support/payment-enrollment-faq) を参照してください。

## サンドボックスの取引は、実際の精算・請求・消込ファイルに現れますか？

いいえ。サンドボックスは独自のデータを持つ別環境です。サンドボックスの活動はサンドボックス側のレコードのみを生成し、
サンドボックスのエクスポートはサンドボックススコープの場所に書き出されます。サンドボックスで行ったことが本番の精算バッチ、
本番の明細書、本番の消込ファイルに届くことはありません。

この分離の裏面も計画に入れる価値があります：サンドボックスの精算レコードはファイル解析やレポートのテストのために存在し、
契約ではなくデフォルト値から導かれたサンドボックスの金額を持ちます。

## サンドボックスで実在の顧客のメールアドレスや電話番号を使えますか？

使わないでください。受け入れ基準はすでに、`test` のようなプレースホルダーではなく現実的に見えるパラメーター値を求めており、
顧客メールアドレスの推奨形式はテストユーザーごとに一意な `userId@examples.com` 形式のアドレスです — これは実在の受信箱に
届くことなく、両方の要件を同時に満たします。パラメーターの要件は
[インテグレーションの受け入れ基準](/docs/ja/developer-docs/tools-and-references/references/acceptance-criteria) を参照してください。

これが礼儀以上に重要な理由が 2 つあります：サンドボックスのフローも通知を生成しますし、お客様が管理していないアドレスは、
通知が生成されたことを証明する必要があるときに確認できません。自分が所有するアドレスを使ってください。

## 認証情報や設定の変更が有効になるまで、どれくらいかかりますか？

対象によって異なり、どちらも即時ではありません。

| 変更 | 有効になるタイミング |
| - | - |
| 公開鍵が `Active` になること | 有効化の少し後。署名を検証できるのは `Active` な鍵のみで、リクエストパスで使われる参照は即時ではなく短い間隔で更新されます |
| IP ホワイトリストの編集 | ほぼ即時。保存時にキャッシュされた参照も無効化されます |

そのため、認証情報の変更直後のテスト実行が、古い設定のせいで正当に失敗することがあります。何かをローテーションまたは
有効化した直後にリクエストが失敗した場合は、署名コードのデバッグを始める前に、上記の時間を待ってから同一のリクエストを
再試行してください。

## チームの誰がサンドボックスの認証情報を見られますか？

Integration ページ — API キー、Waffo の公開鍵、そしてサンドボックスでは生成された秘密鍵 — には **Dev** または **Admin**
ロールが必要です。本番環境の鍵情報はそのページで表示/非表示の操作によりマスクされ、マスクを解除せずに使えるコピー操作が
用意されています。共有画面や録画された通話で値を表示するのではなく、コピー操作を使ってください。

サンドボックスの秘密鍵情報は設計上表示されるため、サンドボックスの認証情報はチームで共有するテスト用の素材として、
本番環境の認証情報は異なる取り扱い基準のシークレットとして扱ってください。これらは同じ種類のものではありません。

***

アクセスではなく結果をテストする準備ができましたか？再現できる内容については
[サンドボックスのシミュレーション制限 FAQ](/docs/ja/support/sandbox-simulation-limits-faq) へ、シミュレーターの操作手順については
[サンドボックステスト FAQ](/docs/ja/support/sandbox-testing-faq) へお進みください。


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