カード保有者の管理

カード保有者の管理が更新されました

Stripe は、カード保有者の番地を必須にし、許可されないカード保有者名のリストを拡張します。これらの検証要件は、2024 年 10 月 31 日以降に作成される新しいカード保有者と、更新される既存のカード保有者に適用されます。

API を使用したカード保有者の作成

実装システムがこれらの更新内容を順守するように、個々のカード保有者のアカウント登録フローを変更する必要があります。

新しいカード保有者の名、姓、生年月日、または請求先住所の送信に対する応答で次のタイプのエラーを処理できるようにしてください。

カード保有者が審査中です

カード保有者の審査中に、以下のエラーが表示されることがあります。

• 審査中のカード保有者の名前を更新することはできません。Stripe を決定して、disabled_reason フィールドを更新します。
• 審査中のカード保有者の生年月日を更新することはできません。Stripe を決定して、disabled_reason フィールドを更新します。

これらのエラーは、Stripe がカード保有者の審査を実施していることを示しています。お客様の側で早急に必要なご対応はありません。 cardholder.updated Webhook イベントを待機してください。このイベントは、審査による決定と必要な次のステップを通知します。このイベントを受け取るまで、API リクエストを再試行しないでください。

追加の情報が必要です

Stripe が審査を完了するために追加情報を必要とする場合、次のエラーが表示されることがあります。

• 審査中のカード保有者の名前を更新することはできません。past_due フィールドには、カード保有者がオーソリを承認する前に入力する必要がある情報が含まれています。
• 審査中のカード保有者の生年月日を更新することはできません。past_due フィールドには、カード保有者がオーソリを承認する前に入力する必要がある情報が含まれています。

これらのエラーが発生した場合は、カード保有者オブジェクトの past_due フィールドで必須情報の詳細を確認してください。カード保有者からこの情報を収集し、Update Cardholder API を使用して送信します。リクエストされた情報を含めずに、元のリクエストを再送信しないでください。

カード保有者の名前が無効です

指定されたカード保有者の名前が無効な場合、次のエラーを受信します。

• 指定されたカード保有者の名前が無効です。これが誤りであるとお考えの場合は、support-issuing@stripe.com まで詳細をお問い合わせください。

このエラーを受け取った場合は、カード保有者の名前を顧客に確認してください。指定された名前が正しいことを確認した場合は、support-issuing@stripe.com までお問い合わせください。

カード保有者の名前にビジネス名が指定されています

Stripe には、ビジネス名ではなく、実際のカード保有者の名前が必要です。カード保有者の名前がビジネス名である場合、次のエラーが表示されます。

• カード保有者の名前をビジネス名にすることはできません。これが誤りであるとお考えの場合は、support-issuing@stripe.com まで詳細をお問い合わせください。

このエラーが表示された場合は、ビジネス名ではなく、個人のカード保有者の名前を使用していることを確認してください。個人事業主または特定のユースケース (後払い、B2B 決済、フリート、保険の入金など) には、例外が適用される場合があります。お客様のケースが例外に該当すると思われる場合は、support-issuing@stripe.com にお問い合わせください。

住所が無効です

Stripe にはカード保有者の有効な実在住所が必要です。住所が無効な場合、以下のエラーが表示されることがあります。

• 住所が無効です。請求先住所は有効な実在住所である必要があり、私書箱は指定できません。カードの配送先住所には、私書箱を使用できます。
• 住所が無効です。請求先住所は有効な実在住所である必要があり、高速道路契約ボックスは指定できません。カードの配送先住所には、高速道路契約ボックスを使用できます。
• 住所が無効です。請求先住所は有効な実在住所である必要があり、私設郵便受けは指定できません。カードの配送先住所には、私設郵便受けを使用できます。
• 住所が無効です。お客様の請求先住所には配達できません。これが誤りであるとお考えの場合は、support-issuing@stripe.com まで詳細をお問い合わせください。

これらのエラーが発生した場合は、カード保有者から有効な実在住所を収集してください。私書箱、Highway Contract Box、私設私書箱は請求先住所として受け付けていません。カード保有者について提供する番地が、正確で検証可能であることを確認してください。丁目、番地、その他の詳細をカード保有者に確認してください。住所が正しいと思われるのに引き続きエラーが表示される場合は、support-issuing@stripe.com にお問い合わせください。

場合によっては、特定の住所が最初の検証に合格しても、後で Stripe によって無効とみなされることがあります。この場合、cardholder.updated Webhook イベントを受け取ります。これは、住所が無効であることを通知するものです。

配達不可な住所をテスト

テスト環境で配信不能な状態をトリガーするには、billing[address][line1] で次の値を使用します。

他のすべての値は、テスト環境で成果物ステータスになります。

Stripe ダッシュボードを使用したカード保有者の作成

Stripe ダッシュボードを使用して新しいカード保有者を作成する場合、ご対応は不要です。新しいカード保有者要件を反映するために更新されたフローが自動的に適用されます。