# Configurer des libellés de relevé bancaire avec Connect Découvrez comment les libellés de relevé bancaire fonctionnent pour les paiements effectués avec Connect. Les libellés de relevé bancaire permettent de fournir des explications concernant les paiements et contiennent des informations dont les banques et les réseaux de cartes ont besoin pour aider les clients à comprendre leurs relevés bancaires. Prenez connaissance des [exigences relatives aux libellés de relevé bancaire](https://docs.stripe.com/get-started/account/statement-descriptors.md). ## Configurer la composante statique d’un compte connecté Les libellés de relevé bancaire contiennent au moins un composant statique et parfois un composant dynamique. Le composant statique peut signifier que : - L’ensemble du libellé de relevé bancaire est statique ([settings.payments.statement_descriptor](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor)). - La première moitié du libellé de relevé bancaire est statique ([settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-card_payments-statement_descriptor_prefix)), tandis que la seconde est définie de manière dynamique à partir du paiement. Votre plateforme et les comptes connectés dotés de la fonctionnalité `card_payments` doivent avoir un libellé de relevé bancaire et, éventuellement, un préfixe de libellé de relevé bancaire. Ces deux valeurs doivent comporter au moins 5 caractères. Pour un paiement donné, le libellé de relevé bancaire de la plateforme ou du compte connecté s’applique en fonction du [type de paiement](https://docs.stripe.com/connect/charges.md). Le libellé de relevé bancaire est défini de l’une des manières suivantes : - Avec un appel à l’API de [création ou modification de compte](https://docs.stripe.com/api/accounts.md) - Lors de l’inscription hébergée ou intégrée par Stripe - Via le tableau Dashboard Stripe complet ou le Dashboard Express Les comptes connectés ayant *accès à un Dashboard hébergé par Stripe* (Platforms can provide connected accounts with access to the full Stripe Dashboard or the Express Dashboard. Otherwise, platforms build an interface for connected accounts using embedded components or the Stripe API) peuvent modifier eux-mêmes leurs paramètres de libellés de relevé bancaire. Vous pouvez pré-remplir le descripteur de relevé et le préfixe d’un compte lorsque vous appelez le point de terminaison [create account](https://docs.stripe.com/api/accounts/create.md). Pendant l’inscription hébergée par Stripe ou intégré, si `settings.payments.statement_descriptor` n’est pas défini, Stripe le génère en concaténant les chaînes de caractères suivantes : 1. `business_profile.name` 1. Secteur d’activité 1. `business_profile.url` 1. le nom de l’entité juridique (soit `individual.first_name` + `individual.last_name` ou `company.name`). Si `settings.payments.statement_descriptor_prefix` n’est pas pré-rempli, Stripe le définit en utilisant les 10 premiers caractères du descripteur de la déclaration. Si les informations requises ne sont pas disponibles, l’inscription hébergée ou intégrée par Stripe invite le compte à définir son propre descripteur de relevé et son propre préfixe. Après l’inscription d’un compte qui n’a pas accès à l’intégralité du Dashboard Stripe, vous pouvez modifier ses attributs `settings.payments.statement_descriptor` et `settings.card_payments.statement_descriptor_prefix` en appelant l’endpoint [de modification de compte](https://docs.stripe.com/api/accounts/update.md). Vous devez configurer le libellé de relevé bancaire des comptes dont l’inscription des utilisateurs est gérée par la plateforme. #### Avec les propriétés du contrôleur ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=company \ -d "business_profile[name]=Runners Club" \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[payments][statement_descriptor]=RUNNERS CLUB" ``` #### Avec le type de compte ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=company \ -d "business_profile[name]=Runners Club" \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[payments][statement_descriptor]=RUNNERS CLUB" ``` Si vous modifiez les attributs `business_profile.name` ou `business_profile.url` d’un compte, ou le nom de l’entreprise ou du particulier titulaire du compte, et que le libellé de relevé bancaire existant repose sur des données de priorité inférieure, Stripe réinitialise automatiquement le libellé pour le faire correspondre à la valeur de priorité la plus élevée. Par exemple, si le libellé est automatiquement défini en fonction de l’URL et que vous définissez ou modifiez l’attribut `business_profile.name`, Stripe réinitialise le libellé pour qu’il corresponde au nom du profil de l’entreprise. Si le libellé est automatiquement défini en fonction de `business_profile.name` et que vous définissez ou modifiez le nom de l’entreprise ou de la personne titulaire du compte, le libellé de relevé bancaire n’est pas réinitialisé, car `business_profile.name` a une priorité plus élevée. L’ordre de priorité est `business_profile.name`, `business_profile.url`, puis le nom de l’entreprise ou de la personne physique titulaire du compte. En cas de modification du libellé de relevé bancaire complet d’un compte, Stripe définit automatiquement le préfixe du libellé de relevé bancaire sur une version abrégée du libellé mis à jour, même si le préfixe précédent a été défini manuellement. ## Utilisation de libellés de relevé bancaire Le libellé de relevé bancaire complet est fourni à la banque ou au réseau de cartes qui traite le paiement. Seuls les 22 premiers caractères du libellé sont transmis pour les paiements par carte bancaire. Le relevé du client utilise le [composant statique](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account) du compte de la plateforme pour les types de paiement suivants : - Paiements indirects sans `on_behalf_of` - Paiements et transferts distincts sans `on_behalf_of` Le relevé du client utilise le [composant statique](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account) du compte connecté pour les types de paiement suivants : - Paiements directs - Paiements indirects avec `on_behalf_of` - Paiements et transferts distincts avec `on_behalf_of` L’utilisation du composant statique à partir d’un compte connecté nécessite que le compte dispose de la fonctionnalité `card_payments`. > Pour les versions de l’API du `2019-02-19` et ultérieures, le paramètre [`statement_descriptor`](https://docs.stripe.com/api/charges/create.md#create_charge-statement_descriptor) de `/v1/charges` est traité comme le composant dynamique et équivaut à fournir `statement_descriptor_suffix`. > > Si les paramètres `statement_descriptor_suffix` et `statement_descriptor`sont fournis, seul `statement_descriptor_suffix` est utilisé. > > Pour les versions de l’API antérieures au `2019-02-19`, les paramètres du libellé de relevé bancaire sur `/v1/charges` sont ignorés et le libellé de relevé bancaire statique de la plateforme est utilisé. En plus d’un libellé de relevé bancaire, des informations supplémentaires sur l’entreprise sont envoyées pour être affichées sur le relevé du client (par exemple, adresse, adresse e-mail, numéro de téléphone et URL). Les informations supplémentaires sont définies par défaut sur les propriétés de support de [business_profile](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile). Si aucun champ support n’est fourni, le champ support de la plateforme est utilisé. Si le champ support de la plateforme n’est pas disponible, les informations d’identité du compte sont fournies à la place. ### Comportements de on_behalf_of Pour les paiements pour lesquels le paramètre `on_behalf_of` est défini, Stripe recherche d’abord le libellé du relevé bancaire et les informations sur l’entreprise à partir du compte indiqué. Si ces informations ne sont pas définies, les informations de la plateforme sont utilisées. - Si le paiement comporte un composant dynamique, le composant statique [settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor_prefix) du compte connecté est utilisé. Si aucun préfixe de libellé de relevé bancaire n’est défini pour le compte connecté, c’est le préfixe de libellé de relevé bancaire de la plateforme qui est utilisé à la place. - Si les informations sur le profil d’entreprise du compte connecté ne sont pas définies, ce sont les informations de la plateforme qui sont utilisées à la place (d’abord le profil d’entreprise de la plateforme, puis les informations d’identité de la plateforme). Par exemple, si le paramètre `support_phone` n’est pas défini pour le compte connecté, le numéro de téléphone `support_phone` ou le numéro de téléphone d’identité de la plateforme est fourni. Si vous utilisez un suffixe dynamique pour un paiement qui utilise le libellé statique du compte connecté, nous vous recommandons de définir un préfixe sur le compte connecté afin que le libellé de relevé bancaire complet apparaisse comme prévu. #### Avec les propriétés du contrôleur ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB" ``` #### Avec le type de compte ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB" ``` Le préfixe statique doit contenir entre 2 et 10 caractères. Les réseaux de cartes ne reçoivent que les 22 premiers caractères du libellé de relevé bancaire, dont le symbole `*` et l’espace qui concatène le préfixe statique et le suffixe dynamique. Définissez à la fois le libellé et le préfixe pour plus de flexibilité dans la définition des libellés de relevé bancaire pour les frais. Si le libellé de relevé bancaire est défini sur des paiements par carte bancaire et qu’aucun préfixe n’est défini, Stripe tronque le libellé de relevé de compte si nécessaire pour définir la valeur du préfixe. ## Définir un suffixe dynamique pour les paiements effectués sur un compte connecté Les suffixes dynamiques sont pris en charge uniquement pour les paiements effectués par carte bancaire à l’aide du paramètre de PaymentIntent [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/object.md?api-version=preview). Pour en savoir plus sur les [suffixes dynamiques](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic) ou voir les libellés de relevé bancaire concaténés, rendez-vous dans le [Dashboard](https://dashboard.stripe.com/settings/public). ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=1000 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=Custom suffix" ``` ## Définir des libellés de relevé bancaire japonais Pour les comptes connectés japonais, nous recommandons de définir les composantes statiques des libellés de relevé bancaire en kanji et en kana. Lorsque vous créez un compte connecté japonais, vous pouvez définir tous les libellés et leurs préfixes respectifs comme suit : #### Avec les propriétés du contrôleur ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=JP \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \ -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \ -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \ -d "settings[payments][statement_descriptor]=example descriptor" \ -d "settings[payments][statement_descriptor_kanji]=漢字明細" \ -d "settings[payments][statement_descriptor_kana]=カナメイサイ" ``` #### Avec le type de compte ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=JP \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \ -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \ -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \ -d "settings[payments][statement_descriptor]=example descriptor" \ -d "settings[payments][statement_descriptor_kanji]=漢字明細" \ -d "settings[payments][statement_descriptor_kana]=カナメイサイ" ``` Lorsque vous créez des paiements par carte bancaire avec [payment_method_options[card][statement_descriptor_suffix_kanji]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kanji) et [payment_method_options[card][statement_descriptor_suffix_kana]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kana), vous pouvez définir des suffixes dynamiques en kanji et en kana. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=jpy \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=example descriptor" \ -d "payment_method_options[card][statement_descriptor_suffix_kanji]=漢字サフィックス" \ -d "payment_method_options[card][statement_descriptor_suffix_kana]=カナサフィックス" ``` Pour en savoir plus, veuillez consulter la page [libellés de relevé bancaire japonais](https://docs.stripe.com/get-started/account/statement-descriptors.md#set-japanese-statement-descriptors).