Erfahren Sie, wie Sie Adressinformationen übermitteln, die den Validierungsstandards von Stripe entsprechen.
Alle derzeitigen und zukünftigen Issuing-, Treasury-, Opal- und Corporate Card-Konten müssen eine erweiterte Validierung für Geschäfts- und Kontovertreteradressen durchlaufen. Diese Kontrollen erkennen und verhindern Adressen, die mit der Nutzung von registrierten Vertretungen, physischen Postfachdiensten und virtuellen Adressdiensten in Verbindung stehen.
Notiz
Die Corporate Card ist mit Opal vernetzt. Opal ist das Geldverwaltungskonto in der privaten Vorschau von Stripe, das es Unternehmen ermöglicht, Geld bei Stripe zu speichern, Geld per ACH und Überweisung in den USA zu senden und zu empfangen, Empfänger/innen zu speichern, um Geld zu bezahlen und Zahlungen auf ein Opal-Guthaben zu leisten.
Arten von Adressen, die validiert werden müssen
Adressen registrierter Vertretungen: Bestimmte Orte, an denen Dritte im Namen eines Unternehmens Rechtsdokumente und behördliche Mitteilungen entgegennehmen. Viele Unternehmen nutzen die Dienste registrierter Vertreter/innen, insbesondere wenn sie in Bundesstaaten tätig sind, in denen sie keine physische Präsenz haben.
Adressen von Empfangsagenturen für Geschäftspost: Private Unternehmen, die Postfachvermietungs- und Postweiterleitungsdienste anbieten, wie z. B. UPS Stores, FedEx Office-Standorte oder virtuelle Postdienste.
Anforderungen an physische Adressen
Um die Anforderungen der Finanzpartner zu erfüllen, überprüft Stripe, ob alle Konten eine physische Präsenz in den USA haben. Dies bedeutet, dass Stripe keine Adressen für registrierte Vertreter/innen, Mailbox-Dienste oder virtuelle Adressdienste mehr zulassen kann. Diese Anforderungen gelten für:
Die Adresse der Geschäftseinheit, unabhängig vom Unternehmenstyp.
Die Adresse der/des Kontoverantwortlichen.
Adressvalidierung
Stripe erzwingt verschiedene Arten der Adressvalidierung für Issuing, Treasury, Opal und Corporate Card.
Bestehende Validierungen
Stripe validiert und erzwingt bereits Folgendes für Adressen:
Gültige und zustellbare US-Adressen.
Keine Postfächer, Highway Contract Boxes oder private Postfächer.
Neue Validierungen
Stripe erzwingt zwei zusätzliche Anforderungen an die Adressvalidierung:
Keine CMRA-Adresse (Commercial Mail Receiving Agency)
Keine registrierte Vertretungsadresse
Diese neuen Validierungen konzentrieren sich auf Adressen, die zwar technisch gültig sind, aber keine echte physische Geschäftspräsenz darstellen.
Adressvalidierungsprozess
Neue Unternehmen, die das Onboarding für Issuing, Treasury, Opal oder Corporate Card durchführen, müssen eine konforme physische Adresse angeben, die alle Validierungskriterien erfüllt. Stripe blockiert das Onboarding, bis Sie eine gültige physische Adresse angeben.
Bestehende Unternehmen
Bestehende Unternehmen, die Issuing, Treasury, Opal oder Corporate Card verwenden und Adressen haben, die Stripe als „Registrierte Vertretung“ oder CMRA identifiziert hat, sind:
Benachrichtigung über das Problem mit der Adressvalidierung.
Einräumung einer Nachfrist von 30 Tagen, um die Anforderung zu erfüllen.
Wenn Sie die Adresse nicht innerhalb dieses Zeitraums aktualisieren, deaktiviert Stripe die Kontofunktionen, bis Sie eine gültige Adresse angeben.
Adressvalidierung integrieren
Wenn die Adressvalidierung fehlschlägt, benachrichtigt Stripe Sie auf folgende Weise:
Sie erhalten eine E-Mail von Stripe, in der die unvollständigen Anforderungen aufgeführt sind.
In Ihrem Dashboard werden eine Nutzeraufgabe und ein Banner mit Anweisungen zum Aktualisieren der Adresse oder Einreichen von Nachweisen angezeigt.
Für verbundene Konten listet Stripe die unvollständigen Anforderungen auf der Seite Connect-Konten auf.
Wenn Sie eine Webhook-Integration haben, erhalten Sie account.updated und capability.updated Webhook-Ereignisse mit Details im Objekt requirements.
Neue Fehlercodes unter Anforderungen zusammenfassen
Sie können die folgenden Fehlercodes verwenden, um zu überprüfen, ob Ihre Adresse für diese Kontrolle markiert ist:
invalid_address_cmra_address
invalid_address_registered_agent_address Um diese neuen Fehlercodes zu verarbeiten, müssen Sie registered_agent_cmra_preview=v1 in der Stripe-Versionheader hinzufügen. Wenn Sie zum Beispiel die API-Version 2025-05-28.basil verwenden, müssen Sie die Stripe-Version auf 2025-05-28.basil; registered_agent_cmra_preview=v1; setzen, um auf die Fehlercodes zugreifen zu können. Wenn Sie den Header nicht setzen, erhalten Sie aus Gründen der Rückwärtskompatibilität stattdessen den Fehlercode invalid_address.
Nachfolgend finden Sie Beispiele für den Abschnitt Anforderungen im Accounts API oder relevante Webhook-Ereignisse, wenn Ihre Adresse gekennzeichnet ist.
CMRA-Adressen
Für eine Geschäftsadresse:
{"requirements":{"current_deadline":null,"currently_due":["company.address.line1","company.address.city","company.address.postal_code","company.address.state"],"errors":[{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"company.address.line1"},{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"company.address.city"},{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"company.address.state"},{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"company.address.postal_code"}],"eventually_due":["company.address.line1","company.address.city","company.address.postal_code","company.address.state"],"past_due":["company.address.line1","company.address.city","company.address.postal_code","company.address.state"],"pending_verification":[]}}
Für die Adresse eines/einer Verantwortlichen:
{"requirements":{"current_deadline":null,"currently_due":["person_123.address.line1","person_123.address.city","person_123.address.postal_code","person_123.address.state"],"errors":[{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"person_123.address.line1"},{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"person_123.address.city"},{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"person_123.address.state"},{"code":"invalid_address_cmra_address","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"person_123.address.postal_code"}],"eventually_due":["person_123.address.line1","person_123.address.city","person_123.address.postal_code","person_123.address.state"],"past_due":["person_123.address.line1","person_123.address.city","person_123.address.postal_code","person_123.address.state"],"pending_verification":[]}}
Um dieses Problem zu beheben, aktualisieren Sie Ihre Adresse auf einen physischen Standort, an dem Sie tätig sind. Wenn die Adresse, die Sie zuvor angegeben haben, Ihren aktuellen Standort korrekt zeigt, können Sie im Rahmen Ihres Einspruchs einen Adressnachweis einreichen. In einigen Fällen wie etwa bei professionellen Dienstleistungsunternehmen wie Anwaltskanzleien, kann die Adresse einer registrierten Vertreterin oder eines registrierten Vertreters den Standort des Unternehmens rechtmäßig wiedergeben.
Anschriften offizieller Vertreter/innen
Für eine Geschäftsadresse:
{"requirements":{"current_deadline":null,"currently_due":["company.address.line1","company.address.city","company.address.postal_code","company.address.state"],"errors":[{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"company.address.line1"},{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"company.address.city"},{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"company.address.state"},{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"company.address.postal_code"}],"eventually_due":["company.address.line1","company.address.city","company.address.postal_code","company.address.state"],"past_due":["company.address.line1","company.address.city","company.address.postal_code","company.address.state"],"pending_verification":[]}}
Für die Adresse eines/einer Verantwortlichen:
{"requirements":{"current_deadline":null,"currently_due":["person_123.address.line1","person_123.address.city","person_123.address.postal_code","person_123.address.state"],"errors":[{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"person_123.address.line1"},{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"person_123.address.city"},{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"person_123.address.state"},{"code":"invalid_address_registered_agent_address","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed. If you believe this is an error, you can submit a proof of address document for review.","requirement":"person_123.address.postal_code"}],"eventually_due":["person_123.address.line1","person_123.address.city","person_123.address.postal_code","person_123.address.state"],"past_due":["person_123.address.line1","person_123.address.city","person_123.address.postal_code","person_123.address.state"],"pending_verification":[]}}
Um dieses Problem zu beheben, aktualisieren Sie Ihre Adresse auf einen physischen Standort, an dem Sie tätig sind.
Integration testen
Verwenden Sie den folgenden Wert im Adressfeld line1 der Accounts API oder der Person API, um verschiedene Szenarien im Test-Modus auszulösen.
Beschreibung
Zeile 1
CMRA-Adresse. Die Validierung dieser Adresse schlägt fehl.
Address CMRA
RA-Adresse. Die Validierung dieser Adresse schlägt fehl.
Address RA
Normale Adresse. Diese Adresse besteht die Validierung.
Alle Nicht-Postfach-, HC-Postfach- oder PMB-Adressen.
