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

# 本番決済を受け付けるまでに何をしなければなりませんか？

> 本番環境までの道筋全体を 1 ページに：本番決済の前提となるステージ、サンドボックスから切り替えたときに実際に変わること、連携受け入れテストで求められることと簡易テンプレートを使えるタイミング、貴社側の技術準備、そしてすでに本番稼働した後に国や決済手段を追加する方法。

このページは地図です。各ステージにはそれぞれ専用のページがあります。欠けていたのは、どのステージが存在し、どの順序で進み、そのうちどれを貴社自身が推進するのかを示すものでした。

## 本番決済の前提となるステージはどれですか？

4 つあり、順番に進みます。Portal のホームページには、最初の 3 つが順に解放されるカードとして表示されます：

| ステージ | 推進者 | 説明ページ |
| - | - | - |
| 1. アカウント認証 | 貴社 | [セルフサービス登録、サンドボックス、アカウント認証](/docs/ja/support/getting-started-self-serve-faq) |
| 2. 提出内容の審査 | Waffo | 同じページ — 申請が返却された場合の意味を含む |
| 3. Payment Enrollment — 決済手段の登録 | Waffo、決済手段ごと | [Payment Enrollment](/docs/ja/support/payment-enrollment-faq) |
| 4. 連携受け入れテスト | 貴社、Waffo が確認 | 公開済みの[受け入れ基準](/docs/ja/developer-docs/tools-and-references/references/acceptance-criteria) |

この順序から 2 つのことが導かれます：

* \*\*審査が承認される前に Payment Enrollment を開始することはできません。\*\*ホームのカードはロックされたままで、そのことが表示されます。認証が未完了の状態で有効化を催促しても、進むことはありません。
* **連携受け入れテストはサンドボックスで実行される**ため、ステージ 3 が進行中でもステージ 4 のすべてを行えます。待っている間に手が空くことはありません。

認証を通過することと決済を受け付けられることは同じではありません。その違いと、各決済手段の有効化状態の読み方については、
[Payment Enrollment](/docs/ja/support/payment-enrollment-faq)の最初のセクションをご覧ください。

## 本番環境に切り替えると、実際に何が変わりますか？

| 項目 | サンドボックス | 本番環境 |
| - | - | - |
| API ドメイン | サンドボックスドメイン | 本番ドメイン |
| SDK 環境 | `Environment.SANDBOX` | `Environment.PRODUCTION` |
| API キー | サンドボックスキー | **別の**本番キー |
| 署名キー | 事前生成されたペアで、秘密鍵側は Portal で確認可能 | **貴社**が生成するペア。秘密鍵側は貴社に表示されることも、Waffo に送信されることもありません |
| 決済手段 | サンドボックス設定で有効化したもの | Payin 契約で定められたもの — 別のリストです |
| 上限と返金ルール | サンドボックス設定 | 契約値 — 改めて読み取ってください |
| 決済の挙動 | シミュレーターのボタン、実チャネルなし | 実際の決済手段、実際の資金 |
| Merchant ID | 独自のサンドボックス加盟店 ID | 別の ID — Integration ページに、サインインしている ID が表示されます |

2 つの環境がどのように分離されているか、およびその他サンドボックス固有の事項はすべて
[サンドボックス環境とアクセス](/docs/ja/support/sandbox-environment-and-access-faq)にあります。

特に意識すべきは、キーに関する 2 行です。\*\*サンドボックスの認証情報やサンドボックスのキーペアを本番環境に持ち込まないでください。\*\*それらは互換性がなく、誤った環境のキーは権限の問題ではなく無効なキーとして失敗します。本番キーペアを生成するコマンドを含む項目ごとの完全なチェックリストは、公開済みの
[本番稼働チェックリスト](/docs/ja/developer-docs/getting-started/go-live)です。なぜそのように失敗するのかは
[注文が拒否されたとき](/docs/ja/support/order-rejection-self-diagnosis-faq)にあります。

## 貴社側にはどのような技術準備が求められますか？

公開済みの[本番稼働チェックリスト](/docs/ja/developer-docs/getting-started/go-live)が権威ある情報源であり、切り替え当日に発見するのではなくスプリントに計画できるよう、ここで挙げる価値のある 4 つの事項を網羅しています：

* **タイムアウト** — 推奨される呼び出しタイムアウトと、その下限。
* **DNS** — 推奨 TTL と、アドレスを固定しないこと。
* **ログとアラート** — 特に注文作成、注文照会、Webhook 処理について。本番稼働時の問題が最初に現れるのはこの 3 か所だからです。
* **デプロイ先** — リージョンとレイテンシに関する推奨事項と、中国本土にデプロイする場合の追加ステップ。

アプリ内で連携する場合、WebView が許可しなければならないことに関する 5 つ目のグループがあります。いくつかの決済手段は、外部アプリの起動、QR 画像のダウンロード、リダイレクト間でのクエリパラメータの保持に依存しています。公開済みの
[決済手段連携ノート](/docs/ja/developer-docs/tools-and-references/references/payment-method-integration-notes)をご覧ください。

## 連携受け入れテストでは何が求められますか？

サンドボックスで一連のケースを実行し、結果をテンプレートに記録し、そのテンプレートを Waffo テクニカルサポートグループに提出すると、グループがそれを確認します。確認される内容：決済の成功パスと失敗パス、Webhook 処理**および Webhook の冪等性**、連携している場合は返金とサブスクリプション、例外シナリオの処理、パラメータの品質、そして正しい識別子を永続化しているかどうかです。

見落とされがちな実務上の 2 点：

* \*\*一部のケースは、予約されたサンドボックス金額で再現します。\*\*それらは意図的に対応するエラーを返します。金額を自分で考えるのではなく、公開済みのリストを使用してください。
  [サンドボックスシミュレーター](/docs/ja/developer-docs/tools-and-references/developer-tools/sandbox-simulator)をご覧ください。
* \*\*すべての決済手段をテストする必要はありません。\*\*カバレッジは代表による方式です：少なくとも 1 つのカード、国ごと・タイプごとに少なくとも 1 つの決済手段、特別なパラメータを必要とする決済手段すべて、そしてウォレットネイティブの決済手段は実機でテストします。

## 以前に連携済みで、今回は決済手段を 1 つ追加するだけです。全部やり直す必要がありますか？

いいえ。**後続のワンタイム決済連携向けの簡易テンプレート**があり、まさにこのケースのために存在します。すでに少なくとも 1 回受け入れテストに合格している場合にのみ使用してください。初回の連携では完全版テンプレートを使用します。

このテンプレートでは、最初にスコープ（加盟店 ID、契約製品、この連携がカバーする決済手段と API）を明記し、次に実際にスコープ内のケースを実行するよう求められます：注文決済の成功と失敗、決済通知、キャンセル、返金と返金通知。ただし、キャンセルと返金はこの連携に含まれる場合のみです。両方のテンプレートと選択ルールは、公開済みの
[受け入れ基準](/docs/ja/developer-docs/tools-and-references/references/acceptance-criteria)ページにあります。

## すでにワンタイム決済を運用しており、これからサブスクリプションを始めたいです。これは 2 回目の本番稼働になりますか？

2 つ目のアカウントではありませんが、2 つ目の連携であり、独自の受け入れテストの経路があります：ワンタイム決済用テンプレートとは別に、サブスクリプション受け入れテンプレートがあり、独自のケース — サブスクリプションを有効化する初回期間の決済、シミュレートされた更新、キャンセル — を含みます。

2 つの帰結：

* 2 つの製品は契約上別々であるため、ワンタイム決済で契約した決済手段が自動的にサブスクリプションでも契約済みになるわけではありません。Service → Payin の `Product` 列と、決済手段設定レスポンスの product フィールドを確認してください。
* サンドボックスでは、実際の請求サイクルを待たずに更新をシミュレートできます。更新ケースはこの方法で実行します。[サンドボックステスト](/docs/ja/support/sandbox-testing-faq)をご覧ください。

サブスクリプション契約自体に関するすべて — サイクル、リトライ、通知 — は
[サブスクリプション FAQ](/docs/ja/support/subscription-faq)から始まります。

## 本番トラフィックの初日には何を監視すべきですか？

4 つあり、いずれも誰かに聞くことなく貴社自身で確認できます：

| 監視対象 | 場所 |
| - | - |
| Webhook が届き、確認応答されているか？ | Portal の Webhook ログ — [Webhook ログ](/docs/ja/support/portal-webhook-log-faq)をご覧ください |
| 注文が拒否されているか、何が原因か？ | エラーコード、次に[注文が拒否されたとき](/docs/ja/support/order-rejection-self-diagnosis-faq) |
| 作成後に決済が失敗しているか、なぜか？ | 取引レコード上の失敗コードと説明 — [取引フィールドリファレンス](/docs/ja/support/transaction-field-reference-faq)をご覧ください |
| 注文作成、照会、Webhook 処理について貴社自身のアラートが発火するか？ | 貴社側 — これは公開済みチェックリストのログ項目です |

初日に身につける価値のある 1 つの習慣：\*\*決済結果の権威として Webhook または照会を扱い、顧客が貴社サイトに戻ってくるリダイレクトを決して権威として扱わないこと。\*\*その理由と、リダイレクトが何を証明し何を証明しないかは、[決済結果](/docs/ja/support/payment-results-faq)にあります。

## 本番稼働後もテストを続けられますか？

はい。サンドボックスは消えることなく、実際の資金を動かさずに問題を再現する場所として引き続き利用できます。設定内で 2 組の認証情報を明確に分離してください。ある認証情報がどの環境に属するかを判断する最速のセルフチェックは
[自分で変更できるものは何ですか？](/docs/ja/support/self-service-boundaries-faq)にあります。

## 本番稼働後、国や決済手段を追加するにはどうすればよいですか？

仕組みは最初の決済手段を得たときと同じです：Waffo 側で契約行が作成され、それが **Service → Payin** と決済手段設定レスポンスに表示されます。貴社が何かを再設定する必要はなく、ダウンタイムもありません。既存の行は変更されず、連携の変更が必要かどうかは、決済手段を明示的に指定しているかどうかによります。この点と、国とリージョンの問題については
[通貨と決済手段の有効化](/docs/ja/support/currency-and-method-enablement-faq)にあります。

新しい決済手段に独自の登録が必要な場合、その状態は Payment Enrollment の詳細で決済手段ごとに確認できます。最初の本番稼働前に使ったのと同じビューです。

## 次にどこを見ればよいですか？

| 質問 | ページ |
| - | - |
| 項目ごとの本番前チェックリスト | 公開済みの[本番稼働チェックリスト](/docs/ja/developer-docs/getting-started/go-live) |
| 登録経路の各ステージで求められること | [セルフサービス登録、サンドボックス、アカウント認証](/docs/ja/support/getting-started-self-serve-faq) |
| 決済手段の有効化状態の意味 | [Payment Enrollment](/docs/ja/support/payment-enrollment-faq) |
| 契約内容、上限と返金ルール | [Payin 契約と取引上限](/docs/ja/support/payin-agreements-and-limits-faq) |
| 自分で変更できる設定はどれか | [自分で変更できるものは何ですか？](/docs/ja/support/self-service-boundaries-faq) |
| サンドボックスで各シナリオをテストする方法 | [サンドボックステスト](/docs/ja/support/sandbox-testing-faq) |


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