Kontrollen Karteninhaber/in
Erfahren Sie, wie sich die Karteninhaberkontrollen auf Ihre Integration auswirken können.
Aktualisierte Kontrollen für Karteninhaber/innen
Stripe benötigt Postanschriften für Karteninhaber/innen und erweitert die Liste der unzulässigen Namen von Karteninhabern und -inhaberinnen. Diese Validierungsanforderungen gelten für alle neuen Karteninhaber/innen, die nach dem 31. Oktober 2024 erstellt werden, und für alle bereits bestehenden Karteninhaber/innen, die nach dem 31. Oktober 2024 aktualisiert werden.
Karteninhaber/in mit der API erstellen
Um sicherzustellen, dass Ihre Integration diesen Aktualisierungen entspricht, müssen Sie Ihren individuellen Onboarding-Ablauf für Karteninhaber/innen ändern.
Stellen Sie sicher, dass Sie in der Lage sind, mit den folgenden Arten von Fehlern als Reaktion auf die Übermittlung des Vornamens, des Nachnamens, des Geburtsdatums oder der Rechnungsadresse eines neuen Karteninhabers/einer neuen Karteninhaberin umzugehen.
Karteninhaber/in wird geprüft
Wenn ein/e Karteninhaber/in überprüft wird, können folgende Fehler auftreten:
- Sie können den Namen für eine/n Karteninhaber/in, der/die gerade überprüft wird, nicht aktualisieren. Stripe trifft eine Entscheidung und aktualisiert das Feld disabled_reason.
- Sie können das Geburtsdatum für eine/n Karteninhaber/in, der/die gerade überprüft wird, nicht aktualisieren. Stripe trifft eine Entscheidung und aktualisiert das Feld disabled_reason.
Diese Fehler weisen darauf hin, dass Stripe eine Überprüfung des Karteninhabers/der Karteninhaberin durchführt und keine sofortigen Maßnahmen von Ihnen erforderlich sind. Warten Sie auf Webhook-Ereignis cardholder.updated, das Sie über die Überprüfungsentscheidung und alle erforderlichen nächsten Schritte informiert. Versuchen Sie nicht, die API-Anfrage zu wiederholen, bis Sie dieses Ereignis erhalten haben.
Weitere erforderliche Informationen
Wenn Stripe weitere Informationen benötigt, um eine Überprüfung abzuschließen, werden möglicherweise folgende Fehler angezeigt:
- Sie können den Namen für eine/n Karteninhaber/in, der/die gerade überprüft wird, nicht aktualisieren. Das Feld past_due enthält Informationen, die Sie angeben müssen, bevor der/die Karteninhaber/in Autorisierungen genehmigen kann.
- Sie können das Geburtsdatum für eine/n Karteninhaber/in, der/die gerade überprüft wird, nicht aktualisieren. Das Feld past_due enthält Informationen, die Sie angeben müssen, bevor der/die Karteninhaber/in Autorisierungen genehmigen kann.
Wenn Sie diese Fehler sehen, überprüfen Sie das Feld past_due im Karteninhaberobjekt auf Details zu den erforderlichen Informationen. Erfassen Sie diese Informationen von Ihrem Karteninhaber/Ihrer Karteninhaberin und übermitteln Sie sie über die Update Cardholder API. Übermitteln Sie die ursprüngliche Anfrage nicht erneut, ohne die angeforderten Informationen anzugeben.
Ungültiger Name des Karteninhabers/der Karteninhaberin
Wenn der angegebene Name des Karteninhabers/der Karteninhaberin ungültig ist, erhalten Sie diese Fehlermeldung:
- Der angegebene Name des Karteninhabers/der Karteninhaberin ist ungültig. Wenn Sie das für einen Fehler halten, kontaktieren Sie bitte support-issuing@stripe.com, um weitere Informationen zu erhalten.
Wenn Sie diese Fehlermeldung erhalten, lassen Sie sich von Ihrem Kunden/Ihrer Kundin den Namen des Karteninhabers/der Karteninhaberin bestätigen. Wenn Sie überprüft haben, ob der angegebene Name korrekt ist, wenden Sie sich an support-issuing@stripe.com, um Unterstützung zu erhalten.
Unternehmensname als Name des Karteninhabers/der Karteninhaberin
Stripe benötigt den Namen des tatsächlichen Karteninhabers/der tatsächlichen Karteninhaberin, keinen Unternehmensnamen. Wenn der Name des Karteninhabers/der Karteninhaberin der Unternehmensname ist, erhalten Sie die folgende Fehlermeldung:
- Der Name Ihres Karteninhabers/Ihrer Karteninhaberin darf nicht Ihr Unternehmensname sein. Wenn Sie dies für einen Fehler halten, wenden Sie sich bitte an support-issuing@stripe.com, um weitere Informationen zu erhalten.
Wenn dieser Fehler angezeigt wird, stellen Sie sicher, dass Sie den Namen des einzelnen Karteninhabers/der einzelnen Karteninhaberin und nicht den Unternehmens verwenden. Ausnahmen können für Einzelunternehmer/innen oder bestimmte Use cases wie „Jetzt kaufen, später bezahlen“, B2B-Zahlungen, Flotten und Versicherungsauszahlungen gelten. Wenn Sie der Meinung sind, dass es sich bei Ihrem Fall um eine Ausnahme handelt, wenden Sie sich an support-issuing@stripe.com.
Ungültige Adresse
Stripe verlangt eine gültige physische Adresse für Karteninhaber/innen. Wenn die Adresse ungültig ist, werden möglicherweise diese Fehler angezeigt:
- Ungültige Adresse. Ihre Rechnungsadresse muss eine gültige physische Adresse sein und darf kein Postfach sein. Sie können ein Postfach als Versandadresse für Ihre Karte angeben.
- Ungültige Adresse. Ihre Rechnungsadresse muss eine gültige physische Adresse sein und darf keine Highway Contract Box sein. Sie können eine Highway Contract Box als Versandadresse für Ihre Karte angeben.
- Ungültige Adresse. Ihre Rechnungsadresse muss eine gültige physische Adresse sein und darf kein privates Postfach sein. Sie können ein privates Postfach als Versandadresse für Ihre Karte angeben.
- Ungültige Adresse. Eine Zustellung an Ihre Rechnungsadresse ist nicht möglich. Wenn Sie das für einen Fehler halten, kontaktieren Sie bitte support-issuing@stripe.com, um weitere Informationen zu erhalten.
Wenn Sie diese Fehler sehen, erfassen Sie eine gültige physische Adresse von Ihrem/Ihrer Karteninhaber/in. Postfächer, Autobahn-Vertragsboxen (Highway Contract Boxes) und private Postfächer werden nicht als Rechnungsadressen akzeptiert. Stellen Sie sicher, dass die für Karteninhaber/innen angegebene Adresse korrekt und überprüfbar ist. Gleichen Sie den Straßennamen, die Hausnummer und andere Details mit Ihrem/Ihrer Karteninhaber/in ab. Wenn Sie der Meinung sind, dass die Adresse korrekt ist, aber immer noch eine Fehlermeldung angezeigt wird, wenden Sie sich an support-issuing@stripe.com.
In einigen Fällen können bestimmte Adressen die anfängliche Validierung bestehen, werden aber später von Stripe für ungültig erklärt. In diesem Fall erhalten Sie das aktualisierte Webhook-Ereignis cardholder.updated webhook event, das Sie über die Ungültigkeit der Adresse informiert.
Testen Sie eine nicht zustellbare Adresse
Verwenden Sie den folgenden Wert in billing[address][line1]
, um in Testumgebungen eine nicht zustellbare Bedingung auszulösen.
lin1 |
---|
123 Fake Street |
Alle anderen Werte führen zu einem zustellbaren Status in Testumgebungen.
Erstellen von Karteninhaber/in mit dem Stripe-Dashboard
Wenn Sie das Stripe-Dashboard verwenden, um neue Karteninhaber/innen zu erstellen, sind keine Maßnahmen erforderlich. Ein aktualisierter Ablauf, der die neuen Karteninhaberanforderungen widerspiegelt, wird automatisch angewendet.