Configurer des libellés de relevé bancaire 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.
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 varie selon que :
- L’ensemble du libellé de relevé bancaire est statique (settings.payments.statement_descriptor).
- La première moitié du libellé de relevé bancaire est statique (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.
Le libellé de relevé bancaire est défini de l’une des manières suivantes :
- Avec un appel de création ou modification de compte à l’API
- 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 à l’intégralité du Dashboard Stripe ou du Dashboard Express peuvent modifier eux-mêmes leurs paramètres de libellé de relevé bancaire.
Vous pouvez remplir automatiquement le libellé de relevé bancaire et le préfixe d’un compte lorsque vous appelez l’endpoint de création de compte. En cas d’inscription hébergée par Stripe ou d’inscription intégrée des utilisateurs, si les attributs settings.payments.statement_descriptor
ou settings.card_payments.statement_descriptor_prefix
ne sont pas définis, Stripe les spécifie à partir des informations fournies sur le compte lors de l’inscription. Si les informations disponibles ne sont pas suffisantes, Stripe invite les comptes connectés à définir leurs propres libellés de relevé lors de l’inscription des utilisateurs.
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.
Vous devez configurer le libellé de relevé bancaire des comptes dont l’inscription des utilisateurs est gérée par la plateforme.
Depuis la version du 16-10-2023 de l’API, il existe une nouvelle logique de mise à jour des libellés de relevé bancaire.
- Si vous modifiez les attributs
business_profile.name
oubusiness_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’attributbusiness_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 debusiness_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é, carbusiness_profile.name
a une priorité plus élevée. L’ordre de priorité estbusiness_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é bancaire du client utilise la composante statique du compte connecté pour les types de paiements suivants :
- Paiements directs
- Paiements indirects avec
on_behalf_of
- Paiements et transferts distincts avec
on_behalf_of
Mise en garde
La plateforme fournit la composante statique pour les requêtes /v1/charges
avec on_behalf_of
effectuées avec des versions de l’API antérieures à 2019-02-19
.
L’utilisation de la composante statique sur des comptes connectés requiert la fonctionnalité card_payments.
Le relevé bancaire du client utilise la composante statique de la plateforme pour les types de paiements suivants :
- Paiements indirects sans
on_behalf_of
- Paiements et transferts distincts sans
on_behalf_of
Les informations complémentaires affichées sur le relevé bancaire d’un client sont également fournies par le compte qui fournit la composante statique (par exemple, l’adresse ou le numéro de téléphone du service d’assistance). Si le compte connecté n’a pas communiqué ces informations, les paiements on_behalf_of
utilisent les informations du compte de la plateforme.
Si vous utilisez un suffixe dynamique sur un paiement qui utilise le libellé de relevé bancaire du compte connecté, vous pouvez définir un préfixe afin de garantir que le libellé de relevé bancaire complet s’affiche de la manière voulue.
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 le statement_descriptor
et le statement_descriptor_prefix
afin de gagner en flexibilité lors de la définition des libellés de relevés bancaires sur des paiements.
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 et comportant le paramètre statement_descriptor_suffix
. Pour en savoir plus sur les suffixes dynamiques ou voir les libellés de relevé bancaire concaténés (préfixe* suffixe), rendez-vous dans le Dashboard.
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é Custom japonais, vous pouvez définir tous les libellés et leurs préfixes respectifs comme suit :
Lorsque vous créez des paiements par carte bancaire avec payment_method_options[card][statement_descriptor_suffix_kanji]
et payment_method_options[card][statement_descriptor_suffix_kana]
, vous pouvez définir des suffixes dynamiques en kanji et en kana.
Pour en savoir plus, consultez la section consacrée aux libellés de relevé bancaire japonais.