バージョン: 最新版

テスト

テストモードはすべてのOmiseアカウントでデフォルトで利用可能で、すべてのAPIバージョンと支払い方法で動作します。テストAPIキーを使用して、実際の支払いを処理せずにトランザクションをシミュレートできます。

テストAPIキー

テストキーはtestプレフィックスで識別されます：

キータイプ	フォーマット	用途
公開キー	`pkey_test_...`	クライアントサイド（Omise.js）
秘密キー	`skey_test_...`	サーバーサイドAPIコール

テストモードでダッシュボード → 設定 → APIキーからテストキーを取得してください。

テストカード

成功する課金

カード番号	ブランド
4242 4242 4242 4242	Visa
4111 1111 1111 1111	Visa
5555 5555 5555 4444	Mastercard
5454 5454 5454 5454	Mastercard
3530 1113 3330 0000	JCB
3566 1111 1111 1113	JCB
3782 8224 6310 005	Amex
6447 0324 0000 0000 001	Discover
3602 1042 0000 04	Diners
6250 9470 0000 0006	UnionPay

テストモードでは、すべてのテストカード番号は任意の有効期限とセキュリティコードで動作します。

失敗する課金

カード番号	失敗コード
4111 1111 1114 0011	`insufficient_fund`
4111 1111 1113 0012	`stolen_or_lost_card`
4111 1111 1112 0013	`failed_processing`
4111 1111 1111 0014	`payment_rejected`
4111 1111 1119 0016	`failed_fraud_check`
4111 1111 1118 0017	`invalid_account_number`

3Dセキュアテスト

3DSにはアカウントの有効化が必要です。有効化についてはsupport@omise.coまでお問い合わせください。

カード番号	3DS動作
4242 4242 4242 4242	フリクションレス（チャレンジなし）
4111 1111 1115 0002	エンロールメント失敗
4111 1111 1114 0003	認証失敗

代替支払い方法のテスト

インターネットバンキング、QR支払い、電子ウォレット、その他のリダイレクトベースの方法について：

テストモードでソースと課金を作成
ダッシュボード → 課金に移動
保留中の課金を見つける
アクションボタンをクリック
成功としてマークまたは失敗としてマークを選択

これにより、顧客が支払いを完了または放棄するシミュレーションができます。

Webhookのテスト

設定 → WebhookでダッシュボードにWebhookエンドポイントを設定してください。

Webhookテストの重要なポイント：

有効なSSL証明書を持つHTTPSエンドポイントを使用
受信確認としてHTTP 200ステータスを返す
セキュリティのために署名検証を実装
ローカル開発テストにはngrokなどのツールを使用

# ngrokでローカルでWebhook配信をテスト
ngrok http 3000
# ngrok URLをダッシュボードのWebhookに設定

テスト課金の例

curl https://api.omise.co/charges \
  -u $OMISE_SECRET_KEY: \
  -d "amount=100000" \
  -d "currency=THB" \
  -d "card=tokn_test_..."

本番環境移行チェックリスト

ライブモードに切り替える前に：

テストカードで成功する支払いをテスト
拒否された支払いとエラー処理をテスト
Webhook配信と処理を確認
返金フローをテスト
本番APIキーを設定
エンドポイントを本番キーに更新

FAQ

テストモードを統合開発に使用できますか？

はい、テストモードはすべての開発および統合作業に推奨されます。テストトランザクションは実際の支払いを処理せず、金銭的リスクなしにすべてのAPI機能を安全に試すことができます。

テストカードはすべての支払い機能で使用できますか？

テストカードは、3Dセキュア、返金、チャージバックなど、ほとんどのカード支払い機能をサポートしています。ただし、実際の銀行からの応答など、一部の機能はライブモードが必要です。各機能のテストモードの制限については、それぞれのドキュメントをご確認ください。

特定の失敗シナリオをシミュレートするにはどうすればよいですか？

上記で提供されている失敗テストカードを使用してください。各カード番号は特定のエラーコード（残高不足、盗難カードなど）をトリガーします。これにより、実際のトランザクションを処理せずにエラー処理をテストできます。

テストモードでWebhookは送信されますか？

はい、テストモードのイベントに対してもライブモードと同様にWebhookが送信されます。ダッシュボードでWebhookエンドポイントを設定し、ローカルテストにはngrokなどのツールを使用してください。

テストトランザクションはアカウントにどのくらいの期間残りますか？

テストトランザクションはアカウントに無期限で残ります。テストモードでダッシュボードから確認できます。これらはライブトランザクションの履歴やレポートには影響しません。

アカウントで3Dセキュアを有効にしなくてもテストできますか？

いいえ、3Dセキュアをテストするには、まずアカウントで有効にする必要があります。3Dセキュアを有効にするにはsupport@omise.coまでお問い合わせください。その後、上記で提供されている3DSテストカードを使用してテストできます。

テストAPIキー​

テストカード​

成功する課金​

失敗する課金​

3Dセキュアテスト​

代替支払い方法のテスト​

Webhookのテスト​

テスト課金の例​

本番環境移行チェックリスト​

FAQ​