Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
Aperçu
Utilisation pour votre entreprise
Cartes bancairesConversion instantanée de devises
Intégrez-le à votre plateforme
Émission de cartes

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, Financial Accounts pour les plateformes, Opal et Corporate Card actuels et futurs doivent satisfaire à des critères de validation renforcés pour les adresses commerciales et celles des représentants de compte. Ces contrôles détectent et empêchent l’utilisation d’adresses associées à des agents enregistrés, à des services de boîtes aux lettres physiques ou à des 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, Financial Accounts pour les plateformes, 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, Financial Accounts pour les plateformes Opal ou Corporate Card doivent fournir une adresse physique conforme répondant à tous les critères de validation. Stripe bloquera l’inscription des utilisateurs jusqu’à ce qu’ils fournissent une adresse physique valide.

Entreprises existantes

Les entreprises existantes utilisant Issuing, Financial Accounts pour les plateformes, Opal ou Corporate Card dont les adresses ont été identifiées par Stripe comme étant celles d’un agent enregistré ou d’un CMRA 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 :

  • Stripe répertorie les exigences incomplètes sur la page comptes Connect du Dashboard pour tous vos comptes connectés qui n’ont pas réussi la validation de l’adresse.
  • 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 dans l’API Stripe, vous devez ajouter registered_agent_cmra_preview=v1 dans l’en-tête Stripe-Version. Par exemple, si vous utilisez la version de l’API 2025-05-28.basil, vous devez définir la Stripe-Version sur 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 plutôt le code d’erreur invalid_address par souci de rétrocompatibilité. Pour digérer ces nouveaux codes d’erreur dans vos endpoints de webhook, vous devez créer une nouvelle configuration de webhook en suivant le guide de gestion des versions des webhooks et la documentation de l’API. Vous trouverez ci-dessous des exemples de la section Exigences dans l’API Accounts ou d’événements 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": {
    "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": []
  }
}

Pour l’adresse d’un représentant :

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

Pour résoudre ce problème, remplacez l’adresse par celle à laquelle vous exercez vos activités. Si l’adresse que vous avez indiquée précédemment reflète fidèlement votre emplacement physique actuel, vous pouvez soumettre un justificatif de domicile dans le cadre de votre appel. Dans certains cas, comme dans le cas des cabinets de services professionnels tels que les cabinets d’avocats, une adresse d’agent agréé peut légitimement refléter l’emplacement de l’entreprise.

Faire appel

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.

Si Stripe a signalé votre adresse, soumettez l’un des documents suivants. La documentation fournie doit indiquer clairement soit le nom de l’entreprise, soit celui du représentant de l’entreprise, ainsi que l’adresse professionnelle principale.

  • Contrats de location ou de location : Copie d’un contrat de bail ou d’un contrat de location qui identifie l’utilisateur comme locataire à cette adresse.
  • Relevés hypothécaires : un relevé hypothécaire datant des 6 derniers mois.
  • Polices d’assurance : Polices d’assurance responsabilité civile professionnelle, biens ou assurance accidents du travail.
  • Documents fiscaux : déclarations fiscales des derniers 24 mois incluant l’adresse d’exploitation (par exemple, formulaires fiscaux d’entreprise au niveau étatique). Ces documents doivent être des déclarations déposées.
  • Relevés de comptes financiers : relevés de compte bancaire, de carte de crédit ou autres relevés financiers datant des 6 derniers jours. Les relevés ne peuvent pas provenir de Stripe.
  • Facture d’eau et d’électricité : facture d’eau et d’électricité des 6 derniers mois qui inclut l’adresse d’exploitation.
  • Pièce d’identité officielle valide : pièce d’identité officielle valide, telle qu’un permis de conduire ou une carte de résident. Uniquement obligatoire pour les particuliers, les entrepreneurs individuels ou les personnes morales.
  • Documents de constitution de l’entreprise : statuts ou statuts constitutifs qui indiquent l’adresse principale de votre entreprise.

Exemple de flux d’intégration des recours

  1. Chargez un document à l’aide de l’API File. Stripe renvoie un ID de fichier :

    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

  2. Joignez le document à votre compte en transmettant l’ID du fichier à l’API Account Update :

    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

  3. Attendez la fin de la vérification du document. Vous recevez un webhook account.updated une fois que Stripe a terminé la vérification.

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.

Descriptionline1
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

Cette page vous a-t-elle été utile ?
OuiNon