Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
サンドボックスの概要

Waffo Pancake は、開発とテストのための完全なサンドボックス環境を提供しています。実際のお金は動きません。全ての機能が本番環境と同様に動作します。

安全

実際のお金は動きません。

全機能対応

本番環境と同様に動作します。

​
テストと本番の比較

サンドボックス（テスト）本番（ライブ）
トランザクションシミュレーション実際の課金
お金テスト用実際の資金
データ隔離済み本番データ
Webhooks完全に動作完全に動作
API の動作同一同一

​
環境の切り替え

​
ダッシュボードでの切り替え

ダッシュボードヘッダーのテスト/ライブモードを切り替えます。

​
API コールでの切り替え

X-Environment ヘッダーを使用します：
ヘッダーの値モード
X-Environment: testサンドボックス
X-Environment: prod本番
決済リンクの共有やデプロイの前に、正しい環境にいることを必ず確認してください。

​
API キー

API キーは特定の環境用に作成されます。API キー認証を使用する場合、環境はキーによって決まるため、X-Environment ヘッダーは不要です。

​
テストカード

​
成功する決済

カード番号タイプ
4576 7500 0000 0110Visa クレジット
2226 9000 0000 0110Mastercard クレジット
4001 7000 0000 0110Visa デビット
2226 9300 0000 0110Mastercard デビット

​
拒否される決済

カード番号タイプ
4576 7500 0000 0220Visa クレジット
2226 9000 0000 0220Mastercard クレジット
4001 7000 0000 0220Visa デビット
2226 9300 0000 0220Mastercard デビット
任意の将来の有効期限、任意の3桁のCVC。

​
テスト Webhooks

サンドボックスでも Webhook は通常通り発火します。テスト方法：
  1. ダッシュボード > 開発者で Webhook エンドポイントを登録する
  2. テストモードに切り替える
  3. イベントをトリガーするアクション（オーダー作成、決済完了）を実行する
  4. 本番環境と同様に Webhook イベントがエンドポイントに届く

​
テストサブスクリプション

サブスクリプションのライフサイクル全体をテストできます：
  1. 作成 — テストチェックアウトでサブスクリプションを開始
  2. 請求 — スケジュールに従って請求が発生
  3. 更新 — カスタマーポータルまたは API でプラン変更
  4. キャンセル — キャンセルフローのテスト（期間終了時に適用）

​
データの隔離

テストデータは完全に分離されています：
  • テスト商品はライブモードに表示されません
  • テストカスタマーは分離されています
  • テストトランザクションはライブレポートに影響しません

​
本番稼働

本番稼働の準備ができたら、テストから本番に商品を同期します： 
curl -X POST https://api.waffo.ai/v1/actions/onetime-product/publish-product \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -d '{
    "id": "product-uuid"
  }'
publish-product エンドポイントはテストから本番への一方向の操作です。X-Environment ヘッダーは不要です。

​
本番稼働チェックリスト

  • サンドボックスでエンドツーエンドのテストを完了
  • エッジケース（カード拒否、失敗）のテスト
  • Webhook の処理を検証
  • モバイルデバイスでチェックアウトをテスト
  • ビジネス情報を完了
  • 商品価格を確認
  • テストから本番に商品を同期