メインコンテンツへスキップ

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

注文の作成

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 に変わります。

​
テストカード番号

​
クレジットカード

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 鍵ペアを使用します。混在させないでください。