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

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

4 つあり、順番に進みます。Portal のホームページには、最初の 3 つが順に解放されるカードとして表示されます: この順序から 2 つのことが導かれます:
  • **審査が承認される前に Payment Enrollment を開始することはできません。**ホームのカードはロックされたままで、そのことが表示されます。認証が未完了の状態で有効化を催促しても、進むことはありません。
  • 連携受け入れテストはサンドボックスで実行されるため、ステージ 3 が進行中でもステージ 4 のすべてを行えます。待っている間に手が空くことはありません。
認証を通過することと決済を受け付けられることは同じではありません。その違いと、各決済手段の有効化状態の読み方については、 Payment Enrollmentの最初のセクションをご覧ください。

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

2 つの環境がどのように分離されているか、およびその他サンドボックス固有の事項はすべて サンドボックス環境とアクセスにあります。 特に意識すべきは、キーに関する 2 行です。**サンドボックスの認証情報やサンドボックスのキーペアを本番環境に持ち込まないでください。**それらは互換性がなく、誤った環境のキーは権限の問題ではなく無効なキーとして失敗します。本番キーペアを生成するコマンドを含む項目ごとの完全なチェックリストは、公開済みの 本番稼働チェックリストです。なぜそのように失敗するのかは 注文が拒否されたときにあります。

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

公開済みの本番稼働チェックリストが権威ある情報源であり、切り替え当日に発見するのではなくスプリントに計画できるよう、ここで挙げる価値のある 4 つの事項を網羅しています:
  • タイムアウト — 推奨される呼び出しタイムアウトと、その下限。
  • DNS — 推奨 TTL と、アドレスを固定しないこと。
  • ログとアラート — 特に注文作成、注文照会、Webhook 処理について。本番稼働時の問題が最初に現れるのはこの 3 か所だからです。
  • デプロイ先 — リージョンとレイテンシに関する推奨事項と、中国本土にデプロイする場合の追加ステップ。
アプリ内で連携する場合、WebView が許可しなければならないことに関する 5 つ目のグループがあります。いくつかの決済手段は、外部アプリの起動、QR 画像のダウンロード、リダイレクト間でのクエリパラメータの保持に依存しています。公開済みの 決済手段連携ノートをご覧ください。

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

サンドボックスで一連のケースを実行し、結果をテンプレートに記録し、そのテンプレートを Waffo テクニカルサポートグループに提出すると、グループがそれを確認します。確認される内容:決済の成功パスと失敗パス、Webhook 処理および Webhook の冪等性、連携している場合は返金とサブスクリプション、例外シナリオの処理、パラメータの品質、そして正しい識別子を永続化しているかどうかです。 見落とされがちな実務上の 2 点:
  • **一部のケースは、予約されたサンドボックス金額で再現します。**それらは意図的に対応するエラーを返します。金額を自分で考えるのではなく、公開済みのリストを使用してください。 サンドボックスシミュレーターをご覧ください。
  • **すべての決済手段をテストする必要はありません。**カバレッジは代表による方式です:少なくとも 1 つのカード、国ごと・タイプごとに少なくとも 1 つの決済手段、特別なパラメータを必要とする決済手段すべて、そしてウォレットネイティブの決済手段は実機でテストします。

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

いいえ。後続のワンタイム決済連携向けの簡易テンプレートがあり、まさにこのケースのために存在します。すでに少なくとも 1 回受け入れテストに合格している場合にのみ使用してください。初回の連携では完全版テンプレートを使用します。 このテンプレートでは、最初にスコープ(加盟店 ID、契約製品、この連携がカバーする決済手段と API)を明記し、次に実際にスコープ内のケースを実行するよう求められます:注文決済の成功と失敗、決済通知、キャンセル、返金と返金通知。ただし、キャンセルと返金はこの連携に含まれる場合のみです。両方のテンプレートと選択ルールは、公開済みの 受け入れ基準ページにあります。

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

2 つ目のアカウントではありませんが、2 つ目の連携であり、独自の受け入れテストの経路があります:ワンタイム決済用テンプレートとは別に、サブスクリプション受け入れテンプレートがあり、独自のケース — サブスクリプションを有効化する初回期間の決済、シミュレートされた更新、キャンセル — を含みます。 2 つの帰結:
  • 2 つの製品は契約上別々であるため、ワンタイム決済で契約した決済手段が自動的にサブスクリプションでも契約済みになるわけではありません。Service → Payin の Product 列と、決済手段設定レスポンスの product フィールドを確認してください。
  • サンドボックスでは、実際の請求サイクルを待たずに更新をシミュレートできます。更新ケースはこの方法で実行します。サンドボックステストをご覧ください。
サブスクリプション契約自体に関するすべて — サイクル、リトライ、通知 — は サブスクリプション FAQから始まります。

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

4 つあり、いずれも誰かに聞くことなく貴社自身で確認できます: 初日に身につける価値のある 1 つの習慣:**決済結果の権威として Webhook または照会を扱い、顧客が貴社サイトに戻ってくるリダイレクトを決して権威として扱わないこと。**その理由と、リダイレクトが何を証明し何を証明しないかは、決済結果にあります。

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

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

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

仕組みは最初の決済手段を得たときと同じです:Waffo 側で契約行が作成され、それが Service → Payin と決済手段設定レスポンスに表示されます。貴社が何かを再設定する必要はなく、ダウンタイムもありません。既存の行は変更されず、連携の変更が必要かどうかは、決済手段を明示的に指定しているかどうかによります。この点と、国とリージョンの問題については 通貨と決済手段の有効化にあります。 新しい決済手段に独自の登録が必要な場合、その状態は Payment Enrollment の詳細で決済手段ごとに確認できます。最初の本番稼働前に使ったのと同じビューです。

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