メインコンテンツへスキップ
サンドボックス環境は実際の決済チャネルに接続されておらず、代わりに決済結果を直接コントロールし、連携ロジックを素早く検証できるシミュレーターが提供されています。

​
単発決済のシミュレーション

1

注文の作成

POST /api/v1/order/create を呼び出して注文を作成します。
2

チェックアウト URL の取得

応答の orderAction からチェックアウト URL を取得します。
3

チェックアウトページを開く

ブラウザでチェックアウトページを開きます。ページにシミュレーションボタンが表示されます。
4

決済結果を選択

対応するボタンをクリックして決済結果をシミュレートします。
  • 決済成功 — ユーザーが決済を完了したことをシミュレートします。注文ステータスは PAY_SUCCESS に変わります。
  • 決済失敗 — 決済が拒否されたことをシミュレートします。注文ステータスは ORDER_CLOSE に変わります。
クリック後、Waffo は自動的に PAYMENT_NOTIFICATION Webhook を notifyUrl に送信します。
サンドボックス決済シミュレーター画面
サンドボックスのチェックアウトはシミュレーター画面です。実際の決済手段選択やカード番号入力はありません。シミュレーションフローはすべての決済手段で共通です。
実際のカード番号入力フローをシミュレートする必要がある場合 (例: 3DS のテスト)、下記のテストカード番号 セクションのテストカード番号を使用できます。ほとんどのシナリオではシミュレーションボタンで十分です。

​
サブスクリプションのシミュレーション

​
初回決済

初回決済は単発決済と同じフローです。
1

サブスクリプションの作成

POST /api/v1/subscription/create を呼び出してサブスクリプションを作成します。
2

チェックアウトページを開く

応答からチェックアウト URL を取得し、ブラウザで開きます。
3

初回決済のシミュレーション

決済成功または決済失敗をクリックします。初回決済成功後、サブスクリプションステータスは ACTIVE に変わり、SUBSCRIPTION_STATUS_NOTIFICATION がトリガーされます。

​
更新決済のシミュレーション

サブスクリプションがアクティベートされた後、実際の請求サイクルが満了するのを待たずに更新を素早くテストできます。
1

管理ページ URL の取得

POST /api/v1/subscription/manage を呼び出して管理ページ URL を取得します。
{
  "subscriptionId": "SUB20260325000001"
}
2

管理ページを開く

managementUrl をブラウザで開きます。
3

更新結果のシミュレーション

管理ページには 2 つのシミュレーションボタンが表示されます。
  • 次回決済成功のシミュレート — 更新成功をトリガーします。PAYMENT_NOTIFICATION と SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION を送信します。
  • 次回決済失敗のシミュレート — 更新失敗をトリガーします。PAYMENT_NOTIFICATION (失敗) を送信します。
ボタンクリックごとに 1 つの更新期間がシミュレートされます。複数回クリックして複数期間のシナリオ (例: 2 期目が成功、3 期目が失敗) をテストできます。
サブスクリプション更新管理ページの例:
サブスクリプション更新シミュレーター管理ページの例

​
サブスクリプションキャンセルのシミュレーション

管理ページはユーザーによるキャンセルにも対応しており、SUBSCRIPTION_STATUS_NOTIFICATION がトリガーされ、ステータスが USER_CANCELLED に変わります。

​
特殊金額での例外再現

以下の金額はサンドボックスの受け入れテストと例外処理テスト専用です。サンドボックス環境でこれらの金額を渡すと、Waffo は対応するエラーコードを意図的に返します。これは本番環境のルールではありません。
以下の値は現在の受け入れテンプレートに基づいており、特定の例外を素早く再現できます。
シナリオ例の金額期待される結果
ワンタイム決済の注文作成でチャネル拒否90、990、1990、19990C0005 Payment Channel Rejection
サブスクリプション作成でチャネル拒否9、90、990、1990、19990C0005 Payment Channel Rejection
注文作成 / サブスクリプション作成のシステムエラー9.1、91、991、1991、19991C0001 System Error
注文作成 / サブスクリプション作成の Unknown Status9.2、92、992、1992、19992E0001 Unknown Status
キャンセル API のシステムエラー（注文キャンセル / サブスクリプションキャンセル）9.3、93、993、1993、19993C0001 System Error
キャンセル API の Unknown Status（注文キャンセル / サブスクリプションキャンセル）9.4、94、994、1994、19994E0001 Unknown Status
返金 API のシステムエラー9.5、95、995、1995、19995C0001 System Error
返金 API の Unknown Status9.6、96、996、1996、199996E0001 Unknown Status
  • 通常の成功 / 失敗フローだけを確認したい場合は、上記の金額を避けてください。
  • A0011 は特殊金額ではなく、同じリクエスト ID に異なる金額または通貨を組み合わせたときに発生します。
  • 返金 A0003 も特殊金額ではなく、返金額が元の支払額を超えたときに発生します。

​
テストカード番号

​
クレジットカード

payMethodName成功用カード番号失敗用カード番号
CC_VISA45767500000001104576750000000220
CC_MASTERCARD22269000000001102226900000000220
CC_JCB35280000000002143528000000120006
CC_AMEX3400000000000216340000000200027

​
デビットカード

payMethodName成功用カード番号失敗用カード番号
DC_VISA40017000000001104001700000000220
DC_MASTERCARD22269300000001102226930000000220
DC_JCB30888500000001163088850000200004
DC_AMEX340034000100009340034000400003

​
共通情報

  • 有効期限: 任意の将来の日付
  • CVV: 任意の 3 桁の数字 (AMEX は 4 桁)

​
サンドボックス環境情報

項目値
ベース URLhttps://api-sandbox.waffo.com
SDK 設定Environment.SANDBOX
サンドボックス環境は本番環境とは異なる API キーおよび RSA 鍵ペアを使用します。混在させないでください。