サンドボックスを開設してもらうよう Waffo に依頼する必要がありますか？
いいえ。サンドボックスはセルフサービスで、自動的に作成されます。登録して事業情報を送信すると、追加の依頼も Waffo スタッフの関与もなく、アカウントにデフォルトのサンドボックスが払い出されます。サンドボックスを依頼するための フォームはありません。 その後に行うのは任意の調整です。設定ウィザードでは、どのプロダクト、料金モデル、マーケット、決済手段を サンドボックスに反映させたいかを Waffo に伝えられるため、サンドボックスが実際に構築しているインテグレーションを反映します。どの URL がサンドボックスで、どれが本番環境ですか？
これらは別々のホスト名を持つ別々の環境です。Portal 上でこれらを切り替えるものはありません — どちらか一方にサインインします。
サインイン中の環境の API アドレスは 加盟店 Portal → Integration にも表示されるため、資料ではなく Portal の中から
いつでも確認できます。
Waffo の SDK を使う場合は、URL を手で編集するのではなく
Environment.SANDBOX または Environment.PRODUCTION を設定してください。
ファイアウォールや CSP でどのドメインを許可する必要がありますか？
自社のページと自社のネットワークポリシーについては、上記のドメインが顧客に面する完全な集合です。実務上は次のとおりです。
最初から組み込んでおくべき注意が 2 つあります。
- IP ではなくホスト名を許可してください。 本番稼働チェックリストは DNS TTL を 60 秒にすることを推奨し、 Waffo の IP アドレスを固定することを明確に警告しています。それらは安定しておらず、公開もされていません。
- サンドボックスと本番環境ではホスト名が異なります。 そのため、一方の環境を前提に書かれたポリシーは、 もう一方を黙ってブロックします。ホストをハードコードせず、環境ごとにパラメーター化してください。
サンドボックスの加盟店 ID は本番環境と同じですか？
いいえ — サンドボックスには独自の加盟店 ID があり、サンドボックス環境にいる間、お客様のユーザーアカウントは そのサンドボックス加盟店 ID に紐づきます。 どちらを見ているかを推測する必要はありません。加盟店 Portal → Integration には、サインイン中の環境の加盟店 ID が、 認証情報の表の真上に、その環境の API アドレスとともに表示されます。サンドボックスの Portal セッションには、 サンドボックスにいることとすべてのデータがテストデータであることを示す固定バナーも表示されます。 インテグレーションにおける帰結：サンドボックスの認証情報はサンドボックスのデータに対してのみ、本番の認証情報は本番のデータに 対してのみ作用します。一方の環境の API キーで他方の環境のホストに認証したリクエストは、ビジネスロジックではなく 認証情報のチェックで失敗します — 正確なエラーコードは 認証と署名 FAQ を参照してください。サンドボックス設定ウィザードは実際に何を変えるのですか？
6 ステップあり、各回答はサンドボックスに何が許可されるかではなく、サンドボックスがどう見えるかを形づくります。
ステップ 3 と 4 が合わさってステップ 5 を決めます：決済手段の候補一覧は、選択したプロダクト、料金戦略、マーケットから
導かれます。期待した決済手段がステップ 5 で表示されない場合、原因はほぼ常に 2 つ前のステップでのマーケットや料金の選択であり、
権限の不足ではありません。
サンドボックスの設定を後から変更できますか？編集は追加ですか置き換えですか？
変更できます。そして編集は選択セット全体を置き換えます — 追加ではありません。再送信すると、送った選択内容が 完全な設定になります：含めなかったものは設定の一部ではなくなります。 実務上の帰結：編集する前に現在の設定を開き、頭の中にある差分だけを送るのではなく、すでに選択されている内容から始めてください。 「新しい決済手段だけ」を送ると、他のすべてが削除されます。「Clear all」または「Reset」を押しました。取り消せますか？
はい — どちらも保存するまでは保存済みの設定に影響しません。
つまり
Reset は Clear all の取り消しです。また、保存せずに画面を離れた場合も、保存済みの設定は変わりません。
どちらの操作も先に確認を求めます。未保存の編集の中では、進行中の選択を破壊する操作だからです。
同じウィザードには、ボタン以上に人を驚かせる関連する挙動が 2 つあります。プロダクトや料金戦略を変更すると、
その下の決済手段と通貨の選択がクリアされます。以前の選択が新しい選択の下では有効でない可能性があるためです。
また、有効な決済手段が 1 つもないマーケットは、空のマーケットとして残るのではなく、マーケット一覧から除外されます。
サンドボックスのステータスが PROCESSING のまま止まっています。各ステータスは何を意味しますか？
設定は 3 つの状態を経て進み、サンドボックスが利用可能になったことを意味するのは最後の 1 つだけです。
非同期に適用されるため、短い
PROCESSING の期間は正常であり、ウィザードの最終ステップは更新を求める代わりに
鍵が生成されるまでポーリングします。進行しない場合、設定レコードには Portal が表示するエラーメッセージが付き、
失敗は Waffo 側でもアラートを発します — そのため、繰り返し再送信するのではなく、サンドボックスの加盟店 ID を添えて
インテグレーションサポートに連絡するのが有効な行動です。
サンドボックスの鍵はどこから来ますか？公開鍵を提出するのですか？
Waffo がサンドボックスのキーペアを生成します。ウィザードの最終ステップと 加盟店 Portal → Integration に、 サンドボックスの API キー、公開鍵、秘密鍵が表示されるため、すぐに署名を始められます。 これは本番環境とは意図的に異なります。
ここから 2 つのルールが導かれ、どちらも 本番稼働チェックリスト に記載されています。
- サンドボックスの鍵情報を本番環境に持ち込まないでください。 本番用のペアを新たに生成してください。 秘密鍵の側がブラウザに表示された鍵は、本番のシークレットではありません。
- ホストと認証情報は一緒に切り替えてください。 これらはセットです。片方だけを変えると、コードのバグに見える署名の失敗が起きます。
サンドボックスのレート、精算サイクル、出金のしきい値、上限は、実際の商用条件ですか？
いいえ。サンドボックスの設定は、フローが端から端まで動くようにデフォルト値から払い出されたものであり、商用契約の写しではありません。 サンドボックスで目にする数値を見積もりや、本番環境で適用される数値として読まないでください。サンドボックスの金額、サイクル、 しきい値は仕組みをテストするための足場 — 項目が埋まる、計算が走る、ステータスが遷移する — として扱い、本番稼働後に 実際の値を本番環境の設定で確認してください。サンドボックスは実際の決済チャネルに接続していますか？
いいえ。サンドボックスは実際の決済チャネルに接続しておらず、実際の資金は動きません。実際の決済手段の選択の代わりに、 サンドボックスのチェックアウト画面には結果を直接決められるシミュレーション用の操作が用意されています。 シミュレーションのフローはすべての決済手段で同じです。 これがサンドボックスの結果について最も重要な理解です：サンドボックスが証明するのは、お客様のインテグレーションが 各結果を正しく処理することです。特定の決済手段が実際のエンドユーザーに対してどう振る舞うかについては何も証明しません。 何が再現でき、何ができないかは サンドボックスのシミュレーション制限 FAQ に 列挙されています。サンドボックスで決済手段を有効にすると、本番環境でも有効になりますか？
いいえ。どちらの方向にも同期しません。サンドボックスの設定と本番環境の設定は独立しています：サンドボックス設定ウィザードは サンドボックスの Portal にのみ存在し、本番環境からはまったくアクセスできません。また、本番環境の設定変更がサンドボックスに 反映されることもありません。 つまり、ある決済手段で取引できるサンドボックスは、コードの経路が動作することを示すだけで、権限を示すものではありません。 本番環境での利用可否は契約に従い、本番環境で決済手段を有効にするのは別のステップです。 決済手段の登録 を参照してください。サンドボックスの取引は、実際の精算・請求・消込ファイルに現れますか？
いいえ。サンドボックスは独自のデータを持つ別環境です。サンドボックスの活動はサンドボックス側のレコードのみを生成し、 サンドボックスのエクスポートはサンドボックススコープの場所に書き出されます。サンドボックスで行ったことが本番の精算バッチ、 本番の明細書、本番の消込ファイルに届くことはありません。 この分離の裏面も計画に入れる価値があります：サンドボックスの精算レコードはファイル解析やレポートのテストのために存在し、 契約ではなくデフォルト値から導かれたサンドボックスの金額を持ちます。サンドボックスで実在の顧客のメールアドレスや電話番号を使えますか？
使わないでください。受け入れ基準はすでに、test のようなプレースホルダーではなく現実的に見えるパラメーター値を求めており、
顧客メールアドレスの推奨形式はテストユーザーごとに一意な userId@examples.com 形式のアドレスです — これは実在の受信箱に
届くことなく、両方の要件を同時に満たします。パラメーターの要件は
インテグレーションの受け入れ基準 を参照してください。
これが礼儀以上に重要な理由が 2 つあります：サンドボックスのフローも通知を生成しますし、お客様が管理していないアドレスは、
通知が生成されたことを証明する必要があるときに確認できません。自分が所有するアドレスを使ってください。
認証情報や設定の変更が有効になるまで、どれくらいかかりますか？
対象によって異なり、どちらも即時ではありません。
そのため、認証情報の変更直後のテスト実行が、古い設定のせいで正当に失敗することがあります。何かをローテーションまたは
有効化した直後にリクエストが失敗した場合は、署名コードのデバッグを始める前に、上記の時間を待ってから同一のリクエストを
再試行してください。
チームの誰がサンドボックスの認証情報を見られますか？
Integration ページ — API キー、Waffo の公開鍵、そしてサンドボックスでは生成された秘密鍵 — には Dev または Admin ロールが必要です。本番環境の鍵情報はそのページで表示/非表示の操作によりマスクされ、マスクを解除せずに使えるコピー操作が 用意されています。共有画面や録画された通話で値を表示するのではなく、コピー操作を使ってください。 サンドボックスの秘密鍵情報は設計上表示されるため、サンドボックスの認証情報はチームで共有するテスト用の素材として、 本番環境の認証情報は異なる取り扱い基準のシークレットとして扱ってください。これらは同じ種類のものではありません。アクセスではなく結果をテストする準備ができましたか？再現できる内容については サンドボックスのシミュレーション制限 FAQ へ、シミュレーターの操作手順については サンドボックステスト FAQ へお進みください。