# Reçus envoyés par e-mail Envoyez automatiquement les reçus et les factures payées. # API Checkout Sessions > This is a API Checkout Sessions for when payment-ui is embedded-components. View the full page at https://docs.stripe.com/payments/advanced/receipts?payment-ui=embedded-components. Vous pouvez envoyer des reçus par e-mail personnalisés ou des [factures payées](https://docs.stripe.com/payments/advanced/receipts.md#customizing-receipts-embedded-components), manuellement ou automatiquement. En savoir plus sur les [reçus de paiement](https://docs.stripe.com/receipts.md). ## Envoi automatique de reçus Pour activer les reçus automatiques, activez l’option **Paiements réussis** dans vos [paramètres d’e-mails clients](https://dashboard.stripe.com/settings/emails). Les reçus sont envoyés uniquement en cas de paiement réussi. Aucun reçu n’est envoyé pour les paiements échoués ou refusés. ## Personnaliser les reçus Modifiez l’apparence et les fonctionnalités de vos reçus à l’aide des options de personnalisation suivantes : - **Image de marque** : modifiez le logo et les couleurs dans vos [paramètres de marque](https://dashboard.stripe.com/settings/branding). La taille du fichier de votre logo personnalisé ne doit pas dépasser 512 Ko. Idéalement, le logo doit être une image carrée de plus de 128 x 128 pixels. Seuls les fichiers au format JPG, PNG et GIF sont pris en charge. - **Informations publiques** : spécifiez les informations publiques que vous souhaitez inclure, telles que votre numéro de téléphone ou l’adresse de votre site Web, dans vos [paramètres d’informations publiques](https://dashboard.stripe.com/settings/public). Pour afficher du texte personnalisé, utilisez l’attribut [payment_intent_data.description](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-description) de la [session Checkout](https://docs.stripe.com/api/checkout/sessions/object.md). En voici quelques exemples : - Description des biens ou services fournis - Code d’autorisation - Informations sur l’abonnement - Politiques d’annulation Vous pouvez voir un aperçu en temps réel de votre reçu par e-mail sur la page des paramètres de marque dans le Dashboard. Pour envoyer un reçu test, survolez l’image d’aperçu et cliquez sur **Envoyer le reçu test**, puis saisissez votre adresse e-mail. > Les reçus récupèrent les données de l’objet `Charge` généré à la confirmation du PaymentIntent. Pour mettre à jour les données des reçus comme la `description` une fois l’objet Charge généré, vous devez [mettre à jour le paiement](https://docs.stripe.com/api/charges/update.md). Les modifications apportées au PaymentIntent n’apparaissent pas sur le reçu. ## Envoyer automatiquement les factures payées Outre les reçus ordinaires, vous pouvez configurer la session Checkout pour qu’elle génère des factures payées comme preuve de paiement. Les factures contiennent plus d’informations que les reçus. Pour les abonnements, Stripe génère automatiquement des factures ; mais pour les paiements uniques, vous devez les activer. > La création de factures pour les paiements ponctuels via l’[API Checkout Sessions](https://docs.stripe.com/api/checkout/sessions.md) n’est pas une fonctionnalité d’[Invoicing](https://stripe.com/invoicing) et est facturée séparément. Consultez [cet article de support](https://support.stripe.com/questions/pricing-for-post-payment-invoices-for-one-time-purchases-via-checkout-and-payment-links) pour en savoir plus. Pour générer des factures, sélectionnez **Paiements réussis** sous **Envoyer un e-mail au client à propos de** dans vos [paramètres d’e-mails clients](https://dashboard.stripe.com/settings/emails). Ensuite, définissez [invoice_creation[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation-enabled) sur `true` lors de la création d’une session Checkout. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d "invoice_creation[enabled]=true" \ -d "line_items[0][price]={{ONE_TIME_PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d ui_mode=elements \ --data-urlencode "return_url=https://example.com" ``` Une fois le paiement effectué, Stripe envoie un récapitulatif de la facture avec des liens pour télécharger la facture au format PDF et le reçu de la facture à l’adresse e-mail fournie par votre client lors du paiement. > Les factures pour les moyens de paiement à notification différée peuvent prendre plus de temps à être envoyées car nous envoyons la facture après le paiement réussi, et non à la fin de la session de paiement. Ces moyens incluent : [prélèvement automatique Bacs](https://docs.stripe.com/payments/bacs-debit/accept-a-payment.md),[ virements bancaires](https://docs.stripe.com/payments/bank-transfers/accept-a-payment.md),[Boleto](https://docs.stripe.com/payments/boleto/accept-a-payment.md),[ débits préautorisés canadiens](https://docs.stripe.com/payments/acss-debit/accept-a-payment.md),[Konbini](https://docs.stripe.com/payments/konbini/accept-a-payment.md),[OXXO](https://docs.stripe.com/payments/oxxo/accept-a-payment.md),[Pay by Bank](https://docs.stripe.com/payments/pay-by-bank/accept-a-payment.md),[prélèvement automatique SEPA](https://docs.stripe.com/payments/sepa-debit/accept-a-payment.md), et[ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md). ![Capture d’écran de la facture au format PDF que les clients peuvent télécharger à partir de l’e-mail récapitulatif de la facture.](https://b.stripecdn.com/docs-statics-srv/assets/invoice.9e44668032383601eeec362f38293b7a.png) La facture PDF téléchargeable ![Capture d'écran du reçu de la facture que les clients peuvent télécharger à partir de l'e-mail récapitulatif de la facture](https://b.stripecdn.com/docs-statics-srv/assets/invoice_receipt.4f120ee7363f8e7728fa553a8a24aae3.png) Le reçu de la facture à télécharger ![Capture d'écran de l'e-mail récapitulatif de la facture envoyé par Stripe](https://b.stripecdn.com/docs-statics-srv/assets/email.560c2666905531b907f7fcd4f1a0a6dd.png) L’e-mail du client contenant des liens vers la facture au format PDF et le reçu Vous pouvez également afficher la facture dans le [Dashboard](https://dashboard.stripe.com/invoices) ou y accéder par voie programmatique en écoutant l’événement [invoice.paid](https://docs.stripe.com/api/events/types.md#event_types-invoice.paid) via une [destination d’événement](https://docs.stripe.com/event-destinations.md). Vous pouvez utiliser le hachage `invoice_data` dans `invoice_creation` pour personnaliser davantage la facture générée par la session Checkout. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d "invoice_creation[enabled]=true" \ -d "invoice_creation[invoice_data][description]=Invoice for Product X" \ -d "invoice_creation[invoice_data][metadata][order]=order-xyz" \ -d "invoice_creation[invoice_data][account_tax_ids][0]=DE123456789" \ -d "invoice_creation[invoice_data][custom_fields][0][name]=Purchase Order" \ -d "invoice_creation[invoice_data][custom_fields][0][value]=PO-XYZ" \ -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]=include_inclusive_tax" \ -d "invoice_creation[invoice_data][footer]=B2B Inc." \ -d "line_items[0][price]={{ONE_TIME_PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d ui_mode=elements \ --data-urlencode "return_url=https://example.com" ``` Vérifiez les [bonnes pratiques de facturation](https://docs.stripe.com/invoicing/customize.md) pour votre région afin de vous assurer que vous collectez les bonnes informations auprès de vos clients. Les informations, telles que l’adresse de facturation et de livraison du client, son numéro de téléphone et son numéro fiscal, apparaissent sur la facture. ## Localisation Lors de l’utilisation de sessions Checkout, la langue du reçu et de la facture est déterminée par plusieurs facteurs : > #### Utiliser l’API Accounts v2 pour représenter les clients > > L’API Accounts v2 est généralement disponible pour les utilisateurs de Connect et en aperçu public pour les autres utilisateurs de Stripe. Si vous avez accès à l’aperçu Accounts v2, vous devez [spécifier une version d’aperçu](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) dans votre code. > > Pour demander l’accès à l’aperçu Accounts v2, > > Dans la plupart des cas d’usage, nous vous recommandons de [modéliser vos clients en tant qu’objets Account configurés par le client](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), plutôt que d’utiliser des objets [Customer](https://docs.stripe.com/api/customers.md). - Si vous définissez un client, nous utilisons la langue spécifiée dans l’attribut [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) d’un `Account` configuré par le client ou dans l’attribut [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) d’un `Customer`, si disponible. - Si vous définissez un client sans préférences de langue, nous appliquons le [paramètre de langue](https://dashboard.stripe.com/settings/emails) du Dashboard. - Si vous ne définissez aucun client, la langue par défaut correspond à la langue du navigateur de l’utilisateur ouvrant l’URL de la Checkout Session. # API Payment Intents > This is a API Payment Intents for when payment-ui is elements. View the full page at https://docs.stripe.com/payments/advanced/receipts?payment-ui=elements. Avec les paiements utilisant *Elements* (A set of UI components for building a web checkout flow. They adapt to your customer's locale, validate input, and use tokenization, keeping sensitive customer data from touching your server) et l’[API Payment Intents](https://docs.stripe.com/api/payment_intents.md), vous pouvez envoyer manuellement ou automatiquement des reçus personnalisés par e-mail. En savoir plus sur les [reçus de paiement](https://docs.stripe.com/receipts.md). ## Envoi automatique de reçus Pour activer les reçus automatiques, activez l’option **Paiements réussis** dans vos [paramètres d’e-mails clients](https://dashboard.stripe.com/settings/emails). Seul un paiement réussi déclenche l’envoi d’un reçu. Les paiements échoués ou refusés n’envoient pas de reçu. Vous pouvez éventuellement spécifier un [receipt_email](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-receipt_email) lorsque vous créez un *PaymentIntent* (The Payment Intents API tracks the lifecycle of a customer checkout flow and triggers additional authentication steps when required by regulatory mandates, custom Radar fraud rules, or redirect-based payment methods). Si c’est le cas, Stripe envoie un reçu à cette adresse en plus de l’adresse e-mail du client et de tout [autre destinataire](https://docs.stripe.com/invoicing/send-email.md#additional-email-recipients) configuré pour le client. Nous n’envoyons pas de reçu à une adresse e-mail incluse dans le [PaymentMethod billing_details](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-billing_details-email) d’un paiement. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=usd \ -d "payment_method_types[]=card" \ --data-urlencode "description=Thanks for your purchase!" \ --data-urlencode "receipt_email=Sent.in.addition.to.customer.email.addresses@example.com" ``` Le reçu affiche le montant, les [informations publiques](https://dashboard.stripe.com/settings/public) sur votre entreprise et toute valeur dans le paramètre `description` de la demande. Les reçus des paiements ponctuels ne contiennent que ces informations. Vous ne pouvez pas ajouter de postes supplémentaires. Pour créer automatiquement un reçu une fois le paiement effectué, mettez à jour le paramètre [receipt_email](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-receipt_email) du PaymentIntent. ## Personnaliser les reçus Modifiez l’apparence et les fonctionnalités de vos reçus à l’aide des options de personnalisation suivantes : - **Image de marque** : modifiez le logo et les couleurs dans vos [paramètres de marque](https://dashboard.stripe.com/settings/branding). La taille du fichier de votre logo personnalisé ne doit pas dépasser 512 Ko. Idéalement, le logo doit être une image carrée de plus de 128 x 128 pixels. Seuls les fichiers au format JPG, PNG et GIF sont pris en charge. - **Informations publiques** : spécifiez les informations publiques que vous souhaitez inclure, telles que votre numéro de téléphone ou l’adresse de votre site Web, dans vos [paramètres d’informations publiques](https://dashboard.stripe.com/settings/public). Pour afficher du texte personnalisé, utilisez l’attribut [description](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-description) dans le [PaymentIntent](https://docs.stripe.com/api/payment_intents/object.md). En voici quelques exemples : - Description des biens ou services fournis - Code d’autorisation - Informations sur l’abonnement - Politiques d’annulation Vous pouvez voir un aperçu en temps réel de votre reçu par e-mail sur la page des paramètres de marque dans le Dashboard. Pour envoyer un reçu test, survolez l’image d’aperçu et cliquez sur **Envoyer le reçu test**, puis saisissez votre adresse e-mail. > Les reçus récupèrent les données de l’objet `Charge` généré à la confirmation du PaymentIntent. Pour mettre à jour les données des reçus comme la `description` une fois l’objet Charge généré, vous devez [mettre à jour le paiement](https://docs.stripe.com/api/charges/update.md). Les modifications apportées au PaymentIntent n’apparaissent pas sur le reçu. ## Envoyer automatiquement les factures payées L’[API Payment Intents](https://docs.stripe.com/payments/payment-intents.md) ne peut pas générer de factures. Utilisez Stripe Billing pour [créer directement la facture](https://docs.stripe.com/invoicing/integration/quickstart.md). ## Adaptation aux marchés locaux Lorsque vous utilisez l’API Payment Intents, la langue du reçu est déterminée par plusieurs facteurs : > #### Utiliser l’API Accounts v2 pour représenter les clients > > L’API Accounts v2 est généralement disponible pour les utilisateurs de Connect et en aperçu public pour les autres utilisateurs de Stripe. Si vous avez accès à l’aperçu Accounts v2, vous devez [spécifier une version d’aperçu](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) dans votre code. > > Pour demander l’accès à l’aperçu Accounts v2, > > Dans la plupart des cas d’usage, nous vous recommandons de [modéliser vos clients en tant qu’objets Account configurés par le client](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), plutôt que d’utiliser des objets [Customer](https://docs.stripe.com/api/customers.md). - Si vous définissez un client, nous utilisons la langue spécifiée dans l’attribut [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) d’un `Account` configuré par le client ou dans l’attribut [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) d’un `Customer`, si disponible. - Si vous définissez un client sans préférences de langue, ou si vous ne définissez aucun client, nous appliquons le [paramètre de langue](https://dashboard.stripe.com/settings/emails) du Dashboard.