お支払いのテスト

本番運用前に購入フロー全体をテストします。テストモードの切り替え機能は近日実装予定です。現時点では、公開済みのプレビュー環境で少額の商品を使って実際のカードでテストしてください。

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

現在推奨されるテストフロー

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

これにより、実際の決済パスのエンドツーエンドカバレッジを確保でき、インテグレーションが確実に機能していることを100%保証できる唯一の方法です。

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

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

ヒント

• 異常系のパスもテストする — 決済の失敗、チェックアウトの中断、ネットワークエラー
• webhookをエンドツーエンドでテストする — Stripe のイベントが発火したときにサブスクリプションの状態が正しく更新されることを確認する
• 解約をテストする — at_billing_period_end のフローは見落とされがちです
• 機能ゲートをテストする — 動作を前提とする前に、UIでゲート付きルートを実際に操作して確認する

近日公開予定

• Admin > Commerce のテストモードトグル — Payment Account を Stripe テストモードに切り替え、ダミーカードを使用可能にする
• プレビューモードのチェックアウト — 公開せずにBuilder内でチェックアウトフローを操作できるようにする
• Webhookイベントシミュレーター — 偽のStripeイベントをruntimeに発火させる