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 à l’API de création ou modification de compte
• 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 peuvent modifier eux-mêmes leurs paramètres de libellés 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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

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 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 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 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.

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. 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 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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

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 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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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 :

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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]"="カナメイサイ"

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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.