Skip to main content
カードは、対応しているすべての国と通貨において、すべての Dodo Payments checkout で利用できます。Dodo Payments は主要なカードネットワークに対応し、カード番号をトークンに置き換え、カード決済に必要なチェックを実行するため、生のカードデータを取り扱う必要はありません。

対応カードネットワーク

Dodo Payments はグローバルネットワークと複数の地域ネットワークに対応しています。

グローバルネットワーク

地域ネットワーク

設定

カードでは、allowed_payment_method_types 内で2つの値を使用します。 このセッションではカード決済のみ利用できます。
特別な理由がない限り、credit と debit の両方を含めてください。多くのお客様はデビットカードでの支払いを希望します。

3D Secure認証

3D Secure(3DS)は、カード会員の銀行に対して、ワンタイムコード、生体認証、銀行アプリでの承認などによってカード会員の本人確認を行うよう求めます。これにより、不正利用やチャージバックを減らせます。

3DSが実行されるタイミング

Dodo Paymentsは次の場合に3DSを要求します。
  • カードネットワークが要求する場合。
  • 欧州のPSD2など、地域の規制で要求される場合。
  • 取引が高リスクと判定された場合。

3DSを強制する

ビジネスで行うすべてのカード決済に3DSを必須にするには、Settings → Pricing で 3D Secure をオンにします。1つのチェックアウトセッションでこの設定を上書きするには、force_3ds を渡します。
すべての取引で3DSを必須にすると不正利用は減りますが、認証中にチェックアウトを中断するお客様がいるため、コンバージョンが低下する可能性があります。

認証失敗への対応

3DS認証が必要な決済は、成功または失敗するまでに中間状態を経ます。 認証が完了しない場合、決済は次のいずれかの拒否コードで失敗します。
  • AUTHENTICATION_FAILURE:お客様を認証できませんでした。
  • AUTHENTICATION_REQUIRED:認証が必要でしたが、実行されませんでした。
  • AUTHENTICATION_TIMEOUT:お客様が時間内に応答しませんでした。
Transaction Failuresのリファレンスには、各コードに推奨される対応が記載されています。

チェックアウト時と更新時の違い

  • チェックアウト時(お客様が操作中): 3DSチャレンジはチェックアウト中に表示されます。失敗した場合は、再試行するか別のカードを使用するようお客様に依頼してください。
  • サブスクリプション更新時(お客様が操作していない): 3DSチャレンジをリアルタイムで表示することはできません。更新に認証が必要で失敗した場合、サブスクリプションは on_hold に移行します。猶予期間を設定している場合は、まず past_due に移行します。復旧するには、お客様に戻ってきてもらい、決済手段を更新するよう促してください。決済失敗への対応とサブスクリプションの督促を参照してください。

保存済みの決済手段

リピーターのお客様は、以前のチェックアウトで保存したカードで支払えます。

Tokenized

元のカード番号が保存されることはありません。

PCI Compliant

Dodo PaymentsがPCIコンプライアンスに対応します。

Customer-Scoped

保存された各カードは、1人の顧客にのみ紐付けられます。

保存済みカードを有効にする

チェックアウトでリピーターのお客様の保存済みカードを表示するには、既存の customer_id とともに show_saved_payment_methods: true を渡します。デフォルトは false です。

ワンクリック購入

チェックアウトを表示せずに保存済みカードへ請求するには、その payment_method_id を confirm: true および既存の customer_id とともに渡します。セッションはカードに直接請求し、checkout_url を返さないため、決済結果を確認するにはwebhookを使用してください。

テスト

テストモードでは次のカードを使用してください。その他のテストデータについては、テストプロセスを参照してください。
テストカードはテストモードでのみ機能します。ライブモードでは、テストカードによる決済は失敗します。

セキュリティとコンプライアンス

Dodo Paymentsはカード決済に次の保護対策を適用しています。

ベストプラクティス

必要がない限り、カードの種類を制限しないでください。お客様は普段使っているカードが利用できることを期待しています。
信頼性を高めるため、サイトにVisa、Mastercard、Amexのロゴを表示してください。
わかりやすいエラーメッセージを表示してください。お客様に未加工のエラーコードを表示しないでください。
保存済みの決済手段により、リピーターのお客様は再購入をより迅速に行えます。

トラブルシューティング

原因: 残高不足、カードの有効期限切れ、CVVの誤り、または銀行の不正利用防止機能。解決策: お客様に入力内容を確認するか、別のカードを試すよう依頼してください。拒否のエラーコードと推奨される対応は、Transaction Failuresのリファレンスで確認できます。コードで拒否に対応する方法については、決済失敗への対応を参照してください。
原因: お客様がチャレンジを中断した、銀行のシステムを利用できなかった、またはチャレンジがタイムアウトした。解決策: 再試行するか、銀行に問い合わせるようお客様に依頼してください。関係する決済状態と拒否コードについては、認証失敗への対応を参照してください。
原因: 地域ネットワークがサポートされていない、またはカードが利用制限のあるプリペイドカードである。解決策: 主要ネットワークのカードを試すようお客様に依頼してください。

関連ページ

Payment Methods Overview

サポートされているすべての決済手段。

Upsells & Downsells

保存済みカードによるワンクリック購入。

Testing Process

すべての決済手段のテストデータ。

Subscriptions

カードによる定期請求。
最終更新日 2026年9月28日