Valider des adresses pour des produits de gestion financière

Découvrez comment soumettre une adresse répondant aux normes de validation de Stripe.

Tous les comptes Issuing, Treasury, Opal et Corporate Card actuels et futurs devront satisfaire à une validation renforcée pour les adresses d’entreprise et de représentant de compte. Ces contrôles détectent et empêchent les adresses associées à l’utilisation d’agents agréés, de services de boîtes aux lettres physiques et de services d’adresses virtuelles.

Remarque

Corporate Card est intégrée à Opal. Opal est le compte de gestion financière en version bêta privée de Stripe qui permet aux entreprises de conserver des fonds sur Stripe, d’envoyer ou de recevoir des fonds par virement bancaire ou ACH aux États-Unis, d’enregistrer les bénéficiaires pour le paiement des factures et d’effectuer des virements sur un solde Opal.

Types d’adresses faisant l’objet d’une validation

Adresses d’agent agréé : endroits désignés où un tiers reçoit des documents juridiques et des avis gouvernementaux au nom d’une entreprise. De nombreuses entreprises utilisent les services d’un agent agréé, en particulier lorsqu’elles exercent leurs activités dans des États où elles n’ont pas de présence physique.
Adresses d’agence de réception du courrier commercial : entreprises privées qui fournissent des services de location de boîtes aux lettres et de transfert de courrier, telles que les magasins UPS, les bureaux FedEx ou les services de courrier virtuel.

Exigences relatives à l’adresse physique

Pour se conformer aux exigences des partenaires financiers, Stripe vérifie que tous les comptes ont une présence physique aux États-Unis. Cela signifie que Stripe ne peut plus autoriser les adresses d’agent agréé, les services de boîtes aux lettres ou les services d’adresses virtuelles. Ces exigences s’appliquent dans les deux cas suivants :

L’adresse de l’entreprise, quel que soit le type d’entreprise.
Adresse du représentant du compte.

Validation des adresses

Stripe applique plusieurs types de validation d’adresse pour Issuing, Treasury, Opal et Corporate Card.

Validations existantes

Stripe s’assure déjà que les adresses sont :

Adresses valides et acceptant les livraisons aux États-Unis.
Pas de boîte postale, de boîte « Highway Contract » (HC) ou de boîte aux lettres privée

Nouvelles validations

Stripe impose deux exigences supplémentaires en matière de validation des adresses :

Pas d’adresse d’agence de réception du courrier commercial
Pas d’adresse d’agent agréé

Ces nouvelles validations se concentrent sur les adresses qui peuvent être techniquement valides, mais qui ne correspondent pas une véritable présence physique de l’entreprise.

Processus de validation des adresses

Les nouvelles entreprises qui s’inscrivent à Issuing, Treasury, Opal ou Corporate Card devront fournir une adresse physique conforme qui répond à tous les critères de validation. Stripe bloque l’inscription tant que vous n’avez pas fourni une adresse physique valide.

Entreprises existantes

Les entreprises existantes qui utilisent Issuing, Treasury, Opal ou Corporate Card avec des adresses que Stripe a identifiées comme étant un agent agréé ou un CMRA (Commercial Mail Receiving Agent) sont les suivantes :

Nous vous avons été informés du problème de validation de l’adresse.
Un délai de grâce de 30 jours est accordé pour vous permettre de remplir cette exigence.

Si vous ne mettez pas à jour l’adresse dans ce délai, Stripe désactive les fonctionnalités du compte jusqu’à ce que vous fournissiez une adresse valide.

Intégrer la validation d’adresse

Si la validation de l’adresse échoue, Stripe vous avertit par les moyens suivants :

Vous recevez un e-mail de Stripe détaillant les exigences non satisfaites.
Une tâche utilisateur et une bannière s’affichent dans votre Dashboard avec des instructions pour mettre à jour l’adresse ou soumettre des pièces justificatives.
- En ce qui concerne les comptes connectés, Stripe répertorie les exigences incomplètes sur la page Comptes connectés.
Si vous avez une intégration de webhook, vous recevez account.updated et capability.updated événements de webhook avec des détails dans l’objet requirements.

Gérer les nouveaux codes d’erreur sur les exigences

Vous pouvez utiliser les codes d’erreur suivants pour confirmer si votre adresse est indiquée pour ce contrôle :

invalid_address_cmra_address
invalid_address_registered_agent_address Pour digérer ces nouveaux codes d’erreur, vous devez ajouter registered_agent_cmra_preview=v1 dans la Stripe-Version en-tête. Par exemple, si vous utilisez la version de l’API 2025-05-28.basil, vous devez définir la Stripe-Version à 2025-05-28.basil; registered_agent_cmra_preview=v1; pour accéder aux codes d’erreur. Si vous ne définissez pas l’en-tête, vous obtenez le code d’erreur invalid_address à la place pour la compatibilité ascendante.

Vous trouverez ci-dessous des exemples de la section exigences dans l’API Accounts ou des événements de webhook pertinents lorsque votre adresse est signalée.

Adresses d’agence de réception du courrier commercial

Pour l’adresse d’une entreprise :

{
  "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": []
  }
}

Pour l’adresse d’un représentant :

{
  "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": []
  }
}

Pour y remédier, mettez à jour votre adresse en fonction de l’emplacement physique où vous exercez vos activités. Si l’adresse que vous avez précédemment fournie reflète fidèlement votre emplacement physique actuel, vous pouvez soumettre une preuve d’adresse dans le cadre de votre appel. Dans certains cas, comme dans le cas de cabinets de services professionnels comme les cabinets d’avocats, une adresse d’agent enregistré peut légitimement refléter l’emplacement de l’entreprise.

Adresses d’agent agréé

Pour l’adresse d’une entreprise :

{
  "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": []
  }
}

Pour l’adresse d’un représentant :

{
  "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": []
  }
}

Pour résoudre ce problème, mettez à jour votre adresse en indiquant un lieu physique où vous exercez votre activité.

Tester l’intégration

Utilisez la valeur suivante dans le champ d’adresse line1 de l’API Accounts ou de l’API Person pour déclencher différents scénarios en mode test.

Description	line1
Adresse d’agence de réception du courrier commercial La validation de cette adresse échoue.	`Address CMRA`
Adresse d’agent agréé. La validation de cette adresse échoue.	`Address RA`
Adresse normale. Cette adresse est validée.	Toute adresse hors boîte postale, boîte « Highway Contract » (HC) ou boîte aux lettres privée

Voir aussi

FAQ sur les exigences en matière de présence physique