サンドボックスの概要
Waffo Pancake は、開発とテストのための完全なサンドボックス環境を提供しています。実際のお金は動きません。全ての機能が本番環境と同様に動作します。
テストと本番の比較
| サンドボックス（テスト） | 本番（ライブ） |
|---|
| トランザクション | シミュレーション | 実際の課金 |
| お金 | テスト用 | 実際の資金 |
| データ | 隔離済み | 本番データ |
| Webhooks | 完全に動作 | 完全に動作 |
| API の動作 | 同一 | 同一 |
環境の切り替え
ダッシュボードでの切り替え
ダッシュボードヘッダーのテスト/ライブモードを切り替えます。
API コールでの切り替え
X-Environment ヘッダーを使用します：
| ヘッダーの値 | モード |
|---|
X-Environment: test | サンドボックス |
X-Environment: prod | 本番 |
決済リンクの共有やデプロイの前に、正しい環境にいることを必ず確認してください。
API キー
API キーは特定の環境用に作成されます。API キー認証を使用する場合、環境はキーによって決まるため、X-Environment ヘッダーは不要です。
テストカード
成功する決済
| カード番号 | ブランド |
|---|
4242 4242 4242 4242 | Visa |
5555 5555 5555 4444 | Mastercard |
3782 822463 10005 | Amex |
拒否される決済
| カード番号 | エラー |
|---|
4000 0000 0000 0002 | 拒否 |
4000 0000 0000 9995 | 残高不足 |
4000 0000 0000 0069 | 有効期限切れのカード |
3D セキュア
| カード番号 | 動作 |
|---|
4000 0027 6000 3184 | 認証が必要 |
4000 0000 0000 3220 | 認証に失敗 |
テストカードでは、未来の有効期限と任意の 3 桁の CVC が使用できます。
テスト Webhooks
サンドボックスでも Webhook は通常通り発火します。テスト方法：
- ダッシュボード > 開発者で Webhook エンドポイントを登録する
- テストモードに切り替える
- イベントをトリガーするアクション（オーダー作成、決済完了）を実行する
- 本番環境と同様に Webhook イベントがエンドポイントに届く
テストサブスクリプション
サブスクリプションのライフサイクル全体をテストできます：
- 作成 — テストチェックアウトでサブスクリプションを開始
- 請求 — スケジュールに従って請求が発生
- 更新 — カスタマーポータルまたは API でプラン変更
- キャンセル — キャンセルフローのテスト（期間終了時に適用）
データの隔離
テストデータは完全に分離されています：
- テスト商品はライブモードに表示されません
- テストカスタマーは分離されています
- テストトランザクションはライブレポートに影響しません
本番稼働
本番稼働の準備ができたら、テストから本番に商品を同期します：
curl -X POST https://waffo-pancake-auth-service.vercel.app/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 ヘッダーは不要です。
本番稼働チェックリスト
