カード保有者の管理

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 フィールドには、カード保有者がオーソリを承認する前に入力する必要がある情報が含まれています。

これらのエラーが発生した場合は、カード保有者オブジェクトの 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] で以下の値 123 Fake Street を使用します。

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

カード会員のステータス

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

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

カード会員を更新することで、status を inactive に変更することができます。Cardholder が inactive ということは、紐付けられたカードについて、cardholder_inactive という理由ですべての承認が拒否されるということです。

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

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