Skip to main content

すべてをテスト。何も壊さない。

実際の取引なしで統合全体を構築・テストできます。実際の課金なし。実際の出金なし。安全な実験のみ。

安全

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

フル機能

本番モードと同じすべての機能。

テスト vs 本番

モード切り替え: ダッシュボード上部のトグル、または API 呼び出しの X-Environment ヘッダー。
支払いリンクを共有する前に、正しいモードにいることを常に確認してください。

環境別の API キー

API キーは特定の環境(テストまたは本番)向けに作成されます。ダッシュボードで API キーを作成する際、キーが属する環境を選択します。
API キーはプレフィックス付きのシークレットキーではなく、キーペア認証を使用します。詳細は認証を参照してください。

テストカード

成功する支払い

拒否される支払い

任意の将来の有効期限、任意の3桁の CVC。

テスト用支払い方法

デジタルウォレット

テストモードではシミュレーション UI を表示:
  • Apple Pay — Safari/iOS
  • Google Pay — Chrome/Android

Webhooks のテスト

テストモードで Webhooks は通常通り発火します。Webhook エンドポイントをテストするには:
  1. ダッシュボード —> API と開発で Webhook エンドポイントを登録
  2. テストモードに切り替え
  3. イベントをトリガーするアクション(注文作成、支払い完了)を実行
  4. エンドポイントが本番モードと同じように Webhook イベントを受信

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

完全なライフサイクルをテスト:
  1. 作成 — テストチェックアウトでサブスクリプションを開始
  2. 請求 — 更新は実際のサイクルどおりに請求されます。下記のシミュレーションボタンで 1 期分を自分で進めることもできます
  3. 更新 — カスタマーポータルまたは API でプランを変更
  4. キャンセル — キャンセルフローをテスト
  5. 期限切れ — 期限切れサブスクリプションの動作を確認

更新のシミュレーション

Dashboard —> サブスクリプションでテストサブスクリプションを開き、詳細ドロワーの 2 つのボタンで実際の請求日を待たずに 1 請求期間を進められます:
  • 更新成功をシミュレート — 次回分を成功として請求します。成功した支払いが 1 件追加され、次回請求日が 1 期間先に移動し、エンドポイントは subscription.payment_succeeded(および subscription.renewed)を受け取ります。支払い遅延だったサブスクリプションでは復旧時に subscription.recovered も送信されます。
  • 更新失敗をシミュレート — 次回分を失敗として請求します。アクティブなサブスクリプションは支払い遅延になり、エンドポイントは subscription.past_due を受け取ります。
シミュレートした失敗は累積します:active —> past_due —> canceled。すでに支払い遅延のサブスクリプションでもう一度失敗すると、そのサブスクリプションは終了します —— キャンセル済みとなり subscription.canceled を送信し、復元できません。Dashboard は失敗のシミュレートのたびに確認を求めます。
どちらのボタンもテストモードでのみ表示され、API は UI の表示に関わらず本番サブスクリプションのリクエストを拒否します。1 回のクリックで進むのはちょうど 1 期間です —— 巻き戻し、リセット、複数期間の一括実行はありません。結果は決済プロバイダーから非同期で届きます:クリックの成功は「実行済み」ではなく「トリガー済み」を意味します。しばらくしてからページを更新して、新しい支払い、ステータス、webhook 配信を確認してください。
期限切れにはセルフサービスの手段がありません:フルサイクル待たずに確認したい場合は、テスト注文 ID をサポートに送ってください。サブスクリプションを手動で進めます。Dashboard → Webhooks の「テストイベントを送信」はサンプルペイロードを 1 件送るだけで、実際のテスト注文には紐付きません。

テストデータ

分離

テストデータは完全に独立:
  • テストプロダクトは本番モードに表示されない
  • テスト顧客は別管理
  • テスト取引は本番レポートに影響しない

環境同期

本番公開の準備ができたら、テストから本番にプロダクトを同期: 以下の例は API Key 認証(Bearer トークンではなく 3 つの署名ヘッダー)を使います。X-Signature の計算方法は API Key 認証 を参照するか、SDK に署名を任せてください。
publish-product エンドポイントはテストから本番への一方向の操作です。X-Environment ヘッダーは不要です。

本番公開チェックリスト

実際の支払いを受け入れる前に:
  • テストモードでエンドツーエンドテストを完了
  • エッジケースをテスト(拒否されたカード、失敗)
  • Webhook 処理を検証
  • モバイルデバイスでチェックアウトをテスト
  • 出金アカウントを追加(出金アカウント)
  • ビジネス詳細を完成(設定 —> ビジネス詳細)
  • プロダクトの価格を確認
  • publish-product でテストから本番にプロダクトを同期

クイックスタート

完全な本番公開チェックリスト。