# Libellés de relevé bancaire Comprendre le fonctionnement des libellés de relevé bancaire. Pour en savoir plus sur la configuration des libellés de relevé bancaire pour les comptes connectés, consultez la section [Configuration des libellés de relevé bancaire pour les comptes connectés](https://docs.stripe.com/connect/statement-descriptors.md). Les libellés de relevé bancaire expliquent les débits ou les paiements figurant sur les relevés bancaires. L’utilisation de libellés clairs et précis peut réduire les contestations de paiement et les litiges. Les banques et les réseaux de cartes bancaires exigent l’inclusion de certains types d’informations qui aident les clients à comprendre leurs relevés, et les libellés de relevé bancaire fournissent ces informations. Lorsque vous [configurez votre compte Stripe](https://docs.stripe.com/get-started/account/set-up.md#public-business-information), vous pouvez définir un libellé de relevé bancaire unique (libellé statique) qui apparaît sur tous les relevés bancaires des clients. Pour les paiements par carte bancaire, vous pouvez également créer un libellé de relevé bancaire contenant un préfixe statique associé à votre compte auquel vous ajoutez un suffixe dynamique associé à chaque paiement. Cela vous permet de préciser les informations concernant le produit, le service ou le paiement sur les relevés de comptes ou de cartes bancaires. La plupart des banques affichent ces informations de manière cohérente, mais certaines peuvent les afficher de manière incorrecte voire ne pas les afficher du tout. ## Conditions requises pour le libellé de relevé bancaire Un libellé de relevé bancaire complet, qu’il s’agisse d’un libellé statique unique ou de la combinaison d’un préfixe et d’un suffixe, doit remplir les conditions suivantes : - Contenir uniquement des caractères latins. - Comporter entre 5 et 22 caractères. - Contenir au moins une lettre (si vous utilisez un préfixe et un suffixe, chacun exige au moins une lettre). - Ne pas contenir les caractères spéciaux suivants : `<`, `>`, `\`, `'` `"` `*`. - Refléter le nom commercial de votre entreprise. - Contenir plus d’un seul terme commun ou l’URL d’un site Web commun. L’URL d’un site Web n’est acceptable que si elle fournit une description claire et précise d’une transaction sur le relevé bancaire d’un client. Un préfixe statique, également appelé libellé abrégé dans le Dashboard, doit contenir entre 2 et 10 caractères. Les caractères restants sont réservés au suffixe dynamique. ## Définir le libellé ou le préfixe de relevé bancaire statique Vous définissez un libellé de relevé bancaire statique ou un libellé abrégé (préfixe) dans le [Dashboard](https://dashboard.stripe.com/settings/business-details). Cette valeur apparaît sur tous les relevés de clients pour les débits ou les paiements non effectués par carte. Un libellé de relevé bancaire statique est suffisant si : - Votre entreprise vend un seul produit ou service. - Vos clients comprennent une valeur statique pour toutes les transactions avec votre entreprise. - Vous préférez fournir le même libellé de relevé bancaire pour toutes les transactions. Pour les paiements par carte bancaire, envisagez un préfixe statique avec un suffixe dynamique si : - Vous fournissez de multiples produits ou services. - Vos clients risquent de ne pas comprendre une même valeur pour toutes leurs transactions avec votre entreprise. - Vous préférez fournir des informations spécifiques à chaque transaction dans le libellé de relevé bancaire. Vous pouvez définir à la fois le libellé de relevé bancaire standard pour les paiements non effectués par carte et le préfixe de libellé abrégé pour les paiements par carte. Si vous définissez le libellé de relevé bancaire statique, mais pas de préfixe, Stripe utilise alors le libellé de relevé bancaire statique comme préfixe pour les paiements par carte bancaire. S’il dépasse 10 caractères, nous le tronquons pour respecter la limite de caractères. ## Définir un suffixe dynamique Les suffixes dynamiques ne sont pris en charge que pour les paiements par carte bancaire. Utilisez le suffixe pour préciser les détails de la transaction afin que votre client puisse la reconnaître clairement sur son relevé. Le suffixe est concaténé avec le préfixe, le symbole `*` et une espace pour former le libellé complet du relevé bancaire que voit votre client. Assurez-vous que l’intégralité du libellé ne dépasse pas 22 caractères, y compris le symbole `*` et l’espace. Si le préfixe est `RUNCLUB` (7 caractères), le suffixe dynamique peut contenir jusqu’à 13 caractères : `9-22-19 10K` (11 caractères) ou `OCT MARATHON` (12 caractères), par exemple. Le libellé de relevé bancaire généré est alors `RUNCLUB* 9-22-19 10K` ou `RUNCLUB* OCT MARATHON`. Spécifiez le suffixe dans le paramètre [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-statement_descriptor_suffix) du `PaymentIntent` : ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=example descriptor" ``` Si vous utilisez *Checkout* (A low-code payment integration that creates a customizable form for collecting payments. You can embed Checkout directly in your website, redirect customers to a Stripe-hosted payment page, or create a customized checkout page with Stripe Elements), spécifiez le suffixe dans le paramètre [payment_intent_data.statement_descriptor_suffix](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-statement_descriptor_suffix) de la `CheckoutSession`. ## Remplacez le libellé de relevé bancaire par défaut ### Paiements ponctuels Vous pouvez remplacer le libellé de relevé bancaire statique pour un paiement qui n’est pas effectué par carte bancaire en spécifiant une valeur pour [statement_descriptor](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-statement_descriptor) lors de la création du `PaymentIntent`. Pour les paiements par carte bancaire, vous ne pouvez pas spécifier le paramètre `statement_descriptor`. Vous pouvez uniquement spécifier le paramètre `statement_descriptor_suffix`. ### Abonnements et factures Stripe crée automatiquement les paiements d’abonnement, vous ne pouvez donc pas configurer les paramètres `statement_descriptor` ou `statement_descriptor_suffix` sur le `PaymentIntent` associé. Pour remplacer le libellé de relevé bancaire par défaut d’un abonnement ou du paiement d’une facture, vous pouvez procéder de l’une des manières suivantes : - Mettez à jour l’`Invoice` pour spécifier le [statement_descriptor](https://docs.stripe.com/api/invoices/update.md#update_invoice-statement_descriptor). - Spécifiez le paramètre `statement_descriptor` lorsque vous [créez](https://docs.stripe.com/api/products/create.md#create_product-statement_descriptor) ou [mettez à jour](https://docs.stripe.com/api/products/update.md#update_product-statement_descriptor) un `Product`. > #### Mise à jour des factures > > Normalement, vous ne pouvez pas modifier les [factures d’abonnement](https://docs.stripe.com/billing/invoices/subscription.md) finalisées. Si vous souhaitez ajouter un libellé de relevé bancaire personnalisé à une facture d’abonnement, définissez le paramètre [collection_method](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-collection_method) de l’objet `Subscription` sur `send_invoice`. Vous devrez peut-être également définir le paramètre [auto_advance](https://docs.stripe.com/api/invoices/update.md#update_invoice-auto_advance) de l’`Invoice` sur false. Lors de la création du paiement d’un abonnement, Stripe sélectionne le libellé de relevé bancaire dans l’ordre de priorité suivant : 1. Défini sur l’`Invoice`. 1. Défini sur le `Product`, y compris un `Product` associé à un `Plan` ou un `Price` inclus dans la facture. Si un objet `Subscription` contient plusieurs éléments, Stripe utilise le premier de son tableau [items.data](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data) (et non le tableau `lines.data` de l’`Invoice`) qui possède un libellé de relevé bancaire personnalisé. 1. Le libellé de relevé bancaire par défaut pour le type de paiement. ## Définir des libellés de relevé bancaire japonais Les entreprises japonaises peuvent définir des libellés de relevé bancaire en kanji et en kana. Il est important que ces libellés soient clairs et faciles à comprendre de façon à limiter les erreurs d’interprétation et les contestations de paiement. Nous recommandons de définir des libellés de relevé bancaire dans les trois écritures prises en charge (kanji, kana et caractères latins). Vous pouvez modifier les libellés de relevé bancaire de votre compte [statique](https://docs.stripe.com/get-started/account/statement-descriptors.md#static) kanji et kana et les libellés abrégés (préfixe) dans le [Dashboard](https://dashboard.stripe.com/settings/business-details). Pour les paiements par carte, vous pouvez définir des [suffixes dynamiques](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic) en kanji et en kana sur `PaymentIntents` et `CheckoutSessions`. Nous calculons le libellé complet que les titulaires de cartes voient en concaténant le préfixe abrégé et les séparateurs, de la même manière que `statement_descriptor_suffix`. L’exemple suivant montre comment définir des suffixes en kanji et en kana sur un `PaymentIntent`. ```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]=カナサフィックス" ``` ### Conditions requises Si certaines exigences applicables aux libellés de relevé bancaire japonais sont similaires aux [exigences anglaises](https://docs.stripe.com/get-started/account/statement-descriptors.md#requirements), le tableau suivant présente les exigences supplémentaires pour les libellés en kanji et en kana. | | Kanji | Kana | | -------------------------------- | ----------------------------------------- | --------------------------------------------------------------------- | | Longueur totale maximale | 17 | 22 | | Longueur de préfixe minimale | 1 | 2 | | Longueur de préfixe maximale | 10 | 10 | | Type de caractère pris en charge | Kanji, kana et latin | Kana | | Règle de validation | Les `< > \ ' " * ＊` ne sont pas autorisés | Seuls les kana, les espaces, les tirets et les points sont autorisés. | > La longueur totale est la longueur du libellé statique ou du libellé concaténé (préfixe + séparateur + suffixe). Les libellés dépassant la longueur maximale sont tronqués. ### Comportement de l’émetteur Les libellés de relevé bancaire en caractères japonais ne sont disponibles que lorsque les deux conditions suivantes sont remplies : - La carte est une Visa ou une Mastercard émise au Japon. - Le paiement est traité par une entreprise japonaise ou pour le compte d’une entreprise japonaise. Pour les paiements applicables, la plupart des émetteurs utilisent un libellé de relevé bancaire en japonais plutôt qu’en latin. Toutefois, c’est à l’émetteur qu’il appartient en dernier ressort de décider si les caractères kanji, kana ou latins doivent figurer sur le relevé du titulaire de la carte. Dans les réponses de l’API, le [calculated_statement_descriptor](https://docs.stripe.com/api/charges/object.md#charge_object-calculated_statement_descriptor) correspond toujours au libellé de relevé bancaire en caractères latins, mais cela n’empêche pas l’émetteur d’utiliser un libellé de relevé bancaire en japonais. ### Délai d’affichage des libellés de relevé bancaire Les libellés de relevé bancaire en kanji et en kana sont envoyés aux émetteurs au moment de la capture du paiement. Par conséquent, ils mettent généralement quelques jours à apparaître sur les relevés des titulaires de carte. Pendant ce laps de temps, les titulaires de carte peuvent voir un libellé temporaire : - **Visa, Mastercard :** le libellé de relevé bancaire en anglais. - **JCB, Diners Club et Discover :** le libellé de relevé bancaire par défaut du compte