カード保有者の管理

Stripe には、カード会員の情報を法的、規制的ガイドラインに沿ってスクリーニングすることが義務付けられています。Stripe Issuing および Connect の統合はこれらのガイドラインに則っていなければなりません。

インテグレーションが法令に従っていることを確認するためには、新規カード会員のfirst name、last name、date of birth、billing address を提出する際に発生する以下の種類のエラーに対応する必要があります。

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

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

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

これらのエラーは、Stripe がカード会員のレビューを行っていることを示しており、お客様による即時の対応は不要です。cardholder.updated Webhook イベントをお待ちください。このイベントでレビューの決定と必要な次のステップが通知されます。このイベントを受信するまで、API リクエストを再試行しないでください。

追加の情報が必要です

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

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

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

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

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

• 指定されたカード会員名は無効です。これが誤りだと思われる場合は、Stripe サポートに詳細をお問い合わせください。

このエラーが発生した場合は、カード会員の名前を顧客に確認してください。指定された名前が正しいことを確認した場合は、Stripe サポートまでお問い合わせください。

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

Stripe では、法人名ではなく実際のカード会員名が必要です。カード会員名が法人名の場合、次のエラーが発生します。

• 「カード会員の名前を法人名にすることはできません。これが誤りであるとお考えの場合は、support-issuing@stripe.com まで詳細をお問い合わせください。」

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

住所が無効です

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

• 「住所が無効です。請求先住所は有効な実在住所でなければならず、私書箱は使用できません。私書箱はカードの配送先住所として使用できます。」
• 「住所が無効です。請求先住所は有効な実在住所でなければならず、Highway Contract Box は使用できません。Highway Contract Box はカードの配送先住所として使用できます。」
• 「住所が無効です。請求先住所は有効な実在住所でなければならず、私設私書箱は使用できません。私設私書箱はカードの配送先住所として使用できます。」
• 「住所が無効です。請求先住所に配達できません。これが誤りであるとお考えの場合は、support-issuing@stripe.com まで詳細をお問い合わせください。」

これらのエラーが発生した場合は、カード会員から有効な実在住所を取得してください。カード会員は私書箱、Highway Contract Box、私設私書箱を請求先住所として使用できません。カード会員に提供された番地が正確で検証可能であることを確認してください。町名、番地、その他の詳細をカード会員に確認してください。住所が正しいと思われるのに引き続きエラーが表示される場合は、Stripe サポートにお問い合わせください。

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

配達不可な住所をテスト

テスト環境で配達不能の状態をシュミレートするには、billing[address][line1] で以下の値 123 Fake Street を使用します。

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

カード会員のステータス

カード会員は、初期設定では active ステータスです。これは、プラットフォームがカード会員を有効化することを意味し、その結果、当該カード会員に紐付くすべてのカードがオーソリを承認できるようになります。

Stripe には、法務および規制ガイドラインに従ってカード会員の本人確認情報をスクリーニングする義務があります。これにより、カード保有者のステータスが active であっても、その会員の属性に基づく承認がブロックされる可能性があります。ウォッチリストレビューの詳細はこちらをご覧ください。

カード会員を更新することで、status を inactive に変更できます。カード会員の inactive ステータスは、紐付けられたカードについて、cardholder_inactive という理由ですべてのオーソリが拒否されることを意味します。

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

Stripe ダッシュボードを使用して新しいカード会員を作成する場合、現在のカード会員要件を反映した更新フローが Stripe によって自動的に適用されます。お客様による対応は不要です。