すべてをテスト、何も壊さない。
実際の取引なしで統合全体を構築・テスト。実際の課金なし、実際の出金なし、安全な実験のみ。安全
実際の資金は動きません。
フル機能
本番モードと同じすべての機能。
テスト vs 本番
| テストモード | 本番モード | |
|---|---|---|
| 取引 | シミュレーション | 実際の課金 |
| 資金 | 仮想 | 実際の資金 |
| API 動作 | 完全に同じ | 完全に同じ |
| データ | 分離 | 本番環境 |
| Webhooks | 完全に動作 | 完全に動作 |
X-Environment ヘッダー。
| ヘッダー値 | モード |
|---|---|
X-Environment: test | テストモード |
X-Environment: prod | 本番モード |
テストカード番号
成功する支払い
| カード番号 | ブランド |
|---|---|
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 | 認証失敗 |
有効期限は任意の将来の日付、CVCは任意の3桁の数字で可。
テスト用支払い方法
デジタルウォレット
テストモードではシミュレーションUIを表示:- Apple Pay — Safari/iOS
- Google Pay — Chrome/Android
ローカル支払い方法
Alipay、PIX、iDEAL — 実際の体験を模倣したシミュレーションフロー。Webhooksのテスト
テストモードでWebhooksは通常通り発火します。 Webhook エンドポイントをテストするには:- ダッシュボード —> 開発者で Webhook エンドポイントを登録
- テストモードに切り替え
- イベントをトリガーするアクション(注文作成、支払い完了)を実行
- エンドポイントが本番モードと同じように Webhook イベントを受信
サブスクリプションのテスト
完全なライフサイクルをテスト:- 作成 — テストチェックアウトでサブスクリプション
- 請求 — スケジュールに従って請求(短い間隔でテストを高速化)
- 更新 — プランを変更
- キャンセル — キャンセルをテスト
- 期限切れ — 期限切れの動作を確認
テストデータ
分離
テストデータは完全に独立:- テストプロダクトは本番モードに表示されない
- テスト顧客は別管理
- テスト取引はレポートに影響しない
環境同期
本番公開の準備ができたら、テストから本番にプロダクトを同期:publish-product エンドポイントはテストから本番への一方向の操作です。
X-Environment ヘッダーは不要です。本番公開チェックリスト
実際の支払いを受け入れる前に:- エンドツーエンドテスト完了
- エッジケースをテスト(拒否されたカード、失敗)
- Webhook処理を検証
- モバイルデバイスでテスト
- 銀行口座を接続(財務 —> 出金設定)
- ビジネス詳細を完成(設定 —> ビジネス詳細)
- プロダクトの価格を確認
- publish-product でテストから本番にプロダクトを同期
クイックスタート
完全な本番公開チェックリスト。