決済のテスト

本番公開前に購入フロー全体をテストしましょう。組み込みのテストモード切り替えは近日公開予定です。現時点では、公開済みのプレビュー上で低額商品を使った実際のカードによるテストをお勧めします。

Proyecta Commerce は現在、本番環境専用です。テストモードと本番モードを切り替えるビルダー内トグルは存在しません。現時点で推奨する方法は、アプリを公開し、低額商品で実際に決済を行い、すぐに返金することです。

現時点での推奨テストフロー

1. Dashboard > Commerce で $1（または最小通貨単位）のテスト商品を作成する
2. アプリを公開して *.proyecta.live サブドメインに割り当てる
3. 公開済みURLを別のブラウザタブで開き、自分のカードを使ってチェックアウトフロー全体を実行する
4. 副作用を確認する — webhookハンドラーが実行されたか、顧客が作成されたか、エンタイトルメントが付与されたか
5. Dashboard > Commerce > Payments タブからトランザクションを返金する

これにより、実際の決済パスのエンドツーエンドカバレッジが得られます。これがインテグレーションの動作を100%確認できる唯一の方法です。

Stripe のテストモードを使わない理由

現在、Proyecta の Stripe との接続は本番モードでのみ動作します。Commerce を Stripe のテスト環境に向け、4242 4242 4242 4242 のようなダミーカードを使用できるテストモード切り替え機能はロードマップに含まれています。

ヒント

• 異常系のパスをテストする — カード拒否、チェックアウトの中断、ネットワークエラー
• webhookをエンドツーエンドでテストする — Stripe イベントが発火したときにサブスクリプションの状態が正しく更新されるか確認する
• キャンセルをテストする — at_billing_period_end のフローは見落としがちです
• 機能ゲートをテストする — 動作を前提にせず、UIフローから commerce.check() を呼び出して確認する

近日公開予定

• Dashboard > Commerce のテストモード切り替え — Payment Account を Stripe のテストモードに切り替えてダミーカードを使用可能に
• プレビューモードチェックアウト — 公開せずにビルダー内でチェックアウトフローを実行
• Webhookイベントシミュレーター — ランタイムに対してフェイクの Stripe イベントを発火