Adressen für Geldmanagementprodukte validieren

Erfahren Sie, wie Sie Adressinformationen übermitteln, die den Validierungsstandards von Stripe entsprechen.

Alle aktuellen und zukünftigen Konten von Issuing, Finanzkonten für Plattformen, Opal und Corporate Card müssen die erweiterte Validierung von Adressen der Unternehmens- und Konto-Vertreter erfüllen. Diese Steuerelemente erkennen und verhindern Adressen, die mit der Verwendung von registrierten Agents, physischen Postfachdiensten und virtuellen Adressdiensten verbunden sind.

Hinweis

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, Finanzkonten für Plattformen, 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 ein Onboarding für Issuing, Finanzkonten für Plattformen, Opal oder Corporate Card durchlaufen, 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, Finanzkonten für Plattformen, Opal oder Corporate Card mit Adressen verwenden, die Stripe als registrierten Vertreter 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:

Stripe listet die unvollständigen Anforderungen im Dashboard auf der Seite Connect-Konten für alle Ihre verbundenen Konten auf, die die Adressvalidierung nicht bestanden haben.
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 in der Stripe-API zu verarbeiten, müssen Sie registered_agent_cmra_preview=v1 in der Stripe-Version Kopfzeile hinzufügen. Wenn Sie beispielsweise die 2025-05-28.basil-API-Version verwenden, müssen Sie die Stripe-Version auf 2025-05-28.basil; registered_agent_cmra_preview=v1; setzen, um auf die Fehlercodes zuzugreifen. Wenn Sie den Header nicht einrichten, erhalten Sie aus Gründen der Abwärtskompatibilität stattdessen den Fehlercode invalid_address. Um diese neuen Fehlercodes in Ihren Webhook Endpoints zu verarbeiten, müssen Sie eine neue Webhook-Konfiguration gemäß dem Leitfaden Umgang mit Webhook-Versioning und der API-Dokumentation erstellen. Nachfolgend finden Sie Beispiele für den Abschnitt Anforderungen in der Accounts API oder relevante Webhook-Ereignisse, wenn Ihre Adresse markiert 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": {
    "alternatives": [
      {
        "original_fields_due": [
          "company.address.line1",
          "company.address.city",
          "company.address.postal_code",
          "company.address.state"
        ],
        "alternative_fields_due": [
          "documents.proof_of_address.files"
        ]
      }
    ],
    "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": {
    "alternatives": [
      {
        "original_fields_due": [
          "person_123.address.line1",
          "person_123.address.city",
          "person_123.address.postal_code",
          "person_123.address.state"
        ],
        "alternative_fields_due": [
          "person_123.verification.additional_document"
        ]
      }
    ],
    "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": []
  }
}

Ändern Sie Ihre Adresse zur Abhilfe auf einen physischen Standort, an dem Sie tätig sind. Wenn die Adresse, die Sie zuvor angegeben haben, Ihren aktuellen physischen Standort genau wiedergibt, können Sie im Rahmen Ihres Einspruchs einen Adressnachweis einreichen. In einigen Fällen – z. B. bei professionellen Dienstleistungsunternehmen wie Anwaltskanzleien – kann die Adresse einer registrierten Vertretung den Standort des Unternehmens rechtmäßig widerspiegeln.

Einspruch einlegen

You can appeal an address that Stripe incorrectly flagged as belonging to a registered agent by providing documentation that proves your business operates at that address. To submit a proof of address document, you can use the API.

Wenn Stripe Ihre Adresse markiert hat, reichen Sie eines der folgenden Dokumente ein. Aus den eingereichten Unterlagen muss entweder der Name des Unternehmens oder der Name der Unternehmensvertreterin oder des Unternehmensvertreters sowie die Hauptgeschäftsadresse deutlich hervorgehen.

Miet- oder Pachtvereinbarungen: Eine Kopie einer Miet- oder Pachtvereinbarung, welche die Nutzerin oder den Nutzer als Mieter/in an diesem Standort ausweist.
Hypothekenauszüge: Hypothekenabrechnung der letzten 6 Monate.
Versicherungspolicen: Betriebshaftpflicht-, Sach- oder Arbeiterunfallversicherungen.
Steuerunterlagen: Steuererklärungen der letzten 24 Monate, die die Adresse des Unternehmens für seine Geschäftstätigkeit enthalten (z.B. staatliche Steuerformulare für Unternehmen). Diese Dokumente müssen eingereicht worden sein.
Finanzkontoauszüge: Konto-, Kreditkarten- oder sonstige Finanzauszüge aus den letzten 6 Monaten. Die Auszüge können nicht über Stripe eingereicht werden.
Rechnung eines Versorgungsunternehmens: Rechnung des Versorgungsunternehmens aus den letzten 6 Monaten, die die Adresse des Betriebs enthält.
Gültiger amtlicher Ausweis: Ein gültiger staatlicher Ausweis, wie z.B. ein Führerschein oder eine Einwohnerkarte. Nur erforderlich für Einzelpersonen, Einzelunternehmer oder eine einzelne juristische Person.
Unternehmensgründungsdokumente: Gesellschaftsvertrag, Satzung oder Gründungsurkunde, die die Hauptadresse Ihres Unternehmens angeben.

Beispiel für die Integration von Einsprüchen

Laden Sie ein Dokument mit der File API hoch. Stripe gibt eine Datei-ID zurück:

Command Line
curl https://api.stripe.com/v1/files \
    -u sk_test_your_key: \
    -F purpose=account_requirement \
    -F file=@/path/to/a/proof_of_address.pdf

Hängen Sie das Dokument an Ihr Konto an, indem Sie die Datei-ID an die Account Update API übergeben:

Command Line
curl https://api.stripe.com/v1/accounts/acct_123 \
    -u sk_test_your_key: \
    -d documents[proof_of_address][files][0]=file_123

Warten Sie, bis die Dokumentverifizierung abgeschlossen ist. Sie erhalten den Webhook account.updated, wenn Stripe die Prüfung abschließt.

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.

Siehe auch

Erfordernis der physischen Anwesenheit –FAQ