模擬決済ゲートウェイ サンドボックス
決済 API がどのように応答するかを学べます。公開テストカードで承認、拒否、3-D Secure を完全オフラインでシミュレーションします。
🔒 教育用シミュレーターです。銀行、カードネットワーク、決済事業者に接続することはありません。公開テストカード番号のみ受け付けます。
公開テストカード番号
| カード番号 | ネットワーク | シミュレーション結果 | |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | 決済成功 | |
| 4000 0000 0000 0002 | Visa | 拒否:generic_decline | |
| 4000 0000 0000 9995 | Visa | 拒否:insufficient_funds | |
| 4000 0000 0000 0069 | Visa | 拒否:expired_card | |
| 4000 0000 0000 0127 | Visa | 拒否:incorrect_cvc | |
| 4000 0000 0000 0119 | Visa | エラー:processing_error | |
| 4000 0025 0000 3155 | Visa | 3-D Secure 認証が必要 | |
| 5555 5555 5555 4444 | Mastercard | 決済成功 | |
| 3782 822463 10005 | American Express | 決済成功 |
決済フローの仕組み
サーバーが支払いインテントを作成・確定し、ゲートウェイがステータスを返し、その後 Webhook がバックエンドに最終結果を通知します。注文の処理は、ブラウザのリダイレクトではなく Webhook に基づいて行ってください。
{
"method": "POST",
"path": "/v1/payment_intents",
"body": {
"amount": 2000,
"currency": "usd",
"confirm": true,
"payment_method_data": {
"type": "card",
"card": {
"number": "4242424242424242",
"exp_month": 12,
"exp_year": 2030,
"cvc": "123"
}
}
}
}{
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"object": "payment_intent",
"livemode": false,
"amount": 2000,
"currency": "usd",
"status": "succeeded",
"payment_method": {
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2030
}
},
"latest_charge": {
"id": "ch_test_8h2j4k6l1m3n5p7q9r0s2t4u",
"authorization_code": "T4K2Q9",
"outcome": {
"network_status": "approved_by_network",
"type": "authorized"
}
}
}{
"id": "evt_test_1a2b3c4d5e6f7g8h9i0j1k2l",
"object": "event",
"type": "payment_intent.succeeded",
"livemode": false,
"data": {
"object": {
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"status": "succeeded",
"amount": 2000,
"currency": "usd"
}
}
}{
"id": "evt_test_9z8y7x6w5v4u3t2s1r0q9p8o",
"object": "event",
"type": "payment_intent.payment_failed",
"livemode": false,
"data": {
"object": {
"id": "pi_test_7f6e5d4c3b2a1z0y9x8w7v6u",
"status": "requires_payment_method",
"last_payment_error": {
"type": "card_error",
"code": "card_declined",
"decline_code": "insufficient_funds",
"message": "Your card has insufficient funds."
}
}
}
}模擬決済ゲートウェイ サンドボックスについて
この模擬決済ゲートウェイ サンドボックスを使うと、開発者は実際のお金を動かすことなく、カード決済 API の応答の仕組みを学べます。公開されているテストカード番号を1つ選び、将来の任意の有効期限、CVC、金額を入力して「決済をシミュレーション」を押してください。ページは典型的な支払いインテントの形をした JSON オブジェクトを返します。ID、ステータス、カードネットワークと下4桁、失敗時の拒否コードとメッセージ、承認時の架空の承認コードが含まれます。3-D Secure カードでは模擬チャレンジが表示されるため、requires_action ステータスの処理を練習できます。また、すべての結果には対応する Webhook イベントが含まれます。シミュレーターは完全にブラウザ内で動作し、銀行、カードネットワーク、決済事業者に接続することはなく、表に記載された公開テスト番号のみを受け付けます。実際のカード番号はローカルで拒否され、どこにも送信されません。
FAQ
サンドボックスでカードに請求したり銀行に接続したりしますか?
いいえ。すべてブラウザ内でシミュレーションされます。Visatk、銀行、カードネットワーク、決済事業者にリクエストが送信されることはなく、お金が動くこともありません。
カード番号が拒否されるのはなぜですか?
サンドボックスは表に記載された公開テスト番号のみを受け付けます。実際のカードを含むそれ以外の番号はローカルで拒否されるため、承認済みとして扱われることはありません。
これらの番号を実際の決済事業者で使用できますか?
これらは決済事業者のテストモードで使われる、広く公開されたテスト番号です。決済事業者のサンドボックスでテスト用 API キーを使用した場合にのみ機能し、本番モードでは常に拒否されます。