# Utiliser Boleto avec des abonnements Comment utiliser Boleto avec des abonnements. > #### 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). Découvrez comment configurer [Boleto](https://docs.stripe.com/payments/boleto.md) en tant que *moyen de paiement* (PaymentMethods represent your customer's payment instruments, used with the Payment Intents or Setup Intents APIs). Boleto est un coupon associé à un nombre généré. Les *clients* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) peuvent en obtenir à un distributeur automatique, auprès d’une banque, sur un portail bancaire en ligne ou dans une agence autorisée. ## Activer Boleto Avant de démarrer votre intégration, accédez à **Gérer les paiements qui nécessitent une confirmation** dans vos [paramètres pour les abonnements et les e-mails](https://dashboard.stripe.com/settings/billing/automatic) puis activez **Envoyer un lien hébergé par Stripe pour que les clients confirment leurs paiements lorsque cela est nécessaire**. Accédez aux [paramètres des moyens de paiement](https://dashboard.stripe.com/settings/payment_methods) et activez le moyen de paiement Boleto. Cliquez sur **Configurer** pour définir le délai d’expiration du bon. ## Décider de la méthode d'encaissement Vous pouvez définir la méthode d’encaissement dans le Dashboard ou l’[API](https://docs.stripe.com/api/invoices/create.md#create_invoice-collection_method). Pour les factures, vous pouvez choisir d’envoyer une facture ou de facturer votre client automatiquement. Si vous utilisez l’API, les valeurs `send_invoice` et `charge_automatically` déterminent la méthode d’encaissement. | | Envoyer la facture | Débiter automatiquement | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Quand les utiliser | - Votre client n’a pas défini son moyen de paiement privilégié pour régler ses factures ou ses abonnements. Dans ce cas, vous voulez lui donner la possibilité d’utiliser soit une carte de crédit, soit Boleto. - Il vous manque des informations importantes sur le client, nécessaires pour utiliser Boleto (nom complet, adresse et numéro d’identification fiscale). | - Votre client a déjà choisi de payer ses factures ou ses abonnements avec des coupons Boleto. - Vous disposez des informations nécessaires sur le client pour créer une facture qui utilise Boleto (nom complet, adresse et numéro d’identification fiscale). | | Expérience client | - Votre client doit saisir à nouveau ses informations personnelles (nom complet, adresse et numéro d’identification fiscale) chaque fois que vous envoyez une nouvelle facture, ou pour chaque nouvelle période de service de l’abonnement. Cette méthode d’encaissement ne tient pas compte du moyen de paiement par défaut associé à ce client. | - Votre client a configuré Boleto comme moyen de paiement par défaut. Votre client reçoit un e-mail contenant un bon Boleto chaque fois que vous lui envoyez une facture, ou à chaque période de service de l’abonnement. | | Expiration et dates d’échéance | - La facture doit inclure une date d’échéance. - Quelle que soit la date d’échéance de la facture, Stripe crée le coupon Boleto dès que votre client saisit les informations nécessaires. Comme les coupons ont leur propre date d’expiration (la valeur par défaut est de 3 jours), la date d’échéance de la facture et la date d’expiration du coupon Boleto ne correspondent pas nécessairement. Le coupon peut expirer avant ou après la date d’échéance de la facture. | - La facture n’a pas de date d’échéance. - Stripe crée le coupon Boleto lorsque le marchand crée la facture avec une date d’expiration sélectionnée (la valeur par défaut est de 3 jours). | ## Créer un client Créez un client pour chaque nouvel utilisateur ou nouvelle entreprise à facturer. Lors de la création d’un client, définissez un [profil client minimal](https://docs.stripe.com/payments/boleto/set-up-subscription.md#customer-profile) pour aider à créer plus de factures utiles, et activez la fonction de relance intelligente Smart Retries (si vous êtes un utilisateur [Invoicing Plus](https://stripe.com/invoicing/pricing)). Après la création et la configuration de ce client, vous pouvez émettre des factures ponctuelles ou créer des *abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis). > Avant de créer un nouveau client, assurez-vous qu’il n’existe pas déjà dans le Dashboard. La création de plusieurs entrées client pour un même client peut vous poser problème par la suite, par exemple lorsque vous devez rapprocher l’historique des transactions ou coordonner les moyens de paiement enregistrés. #### Dashboard Vous pouvez créer et gérer des clients en vous rendant sur la [page Clients](https://dashboard.stripe.com/customers) si vous ne souhaitez pas utiliser de code pour créer un client, ou si vous voulez facturer manuellement une facture ponctuelle à un client. Vous pouvez également créer un client dans le Dashboard lors de la création de la facture. ### Créer un client Lorsque vous créez un client, vous pouvez lui associer diverses données de compte et de facturation, notamment un **E-mail**, un **Nom** ou encore un **Pays**. Vous pouvez également définir la langue préférée ou la devise du client, ainsi que d’autres informations. Pour créer un client, suivez ces étapes : 1. Vérifiez que ce client n’existe pas déjà. 1. Cliquez sur **Ajouter un client** ou appuyez sur la touche **N** sur la page **Clients**. 1. Veuillez saisir au moins le **Nom** et l’**Adresse e-mail du compte** de votre client. 1. Cliquez sur **Ajouter un client** dans la boîte de dialogue. ### Modifier un client Pour modifier le profil d’un client, suivez ces étapes : 1. Recherchez le client que vous souhaitez modifier et cliquez sur son nom sur la page **Clients**. 1. Sur la page des informations du compte, cliquez sur **Actions** > **Modifier les informations**. 1. Apportez les modifications voulues au profil du client. 1. Cliquez sur **Mettre à jour**. ### Supprimer un client Pour supprimer un client, suivez ces étapes : 1. Recherchez le client que vous souhaitez supprimer sur la page **Clients**. 1. Cochez la case située en regard du nom du client, puis cliquez sur le bouton **Supprimer**. Vous pouvez également cliquer sur la page des informations du client, puis sur **Actions** > **Supprimer le client**. #### API Avant de créer un client, vérifiez qu’il n’existe pas déjà. Par exemple, transmettez une adresse e-mail à l’API [List all customers](https://docs.stripe.com/api/customers/list.md). ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` Découvrez comment créer un client utilisant le moyen de paiement Boleto. Consultez la documentation [Créer un client](https://docs.stripe.com/api/customers/create.md) pour obtenir des informations détaillées. #### Envoyer une facture par e-mail ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=joao@exemplo.com" \ -d "description=My first test customer" ``` #### Débiter automatiquement votre client ### Configurer le client Pour créer un client avec les attributs `name`, `email` et `description`, ajoutez ce code : ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "name=João da Silva" \ --data-urlencode "email=joao@exemplo.com" \ -d "description=My first test customer" ``` ### Créer le moyen de paiement Boleto Pour créer le moyen de paiement Boleto, ajoutez ce code : ```curl curl https://api.stripe.com/v1/payment_methods \ -u "<>:" \ -d type=boleto \ -d "boleto[tax_id]=000.000.000-00" \ -d "billing_details[name]=João da Silva" \ --data-urlencode "billing_details[email]=joao@exemplo.com" \ -d "billing_details[address][line1]=1234 Av. Paulista" \ -d "billing_details[address][city]=São Paulo" \ -d "billing_details[address][state]=SP" \ -d "billing_details[address][postal_code]=01310-000" \ -d "billing_details[address][country]=BR" ``` ### Associer le moyen de paiement Boleto à un client Pour associer le moyen de paiement Boleto à un client, ajoutez ce code : ```curl curl https://api.stripe.com/v1/payment_methods/{{PAYMENT_METHOD_ID}}/attach \ -u "<>:" \ -d customer={{CUSTOMER_ID}} ``` ### Définir comme moyen de paiement par défaut de ce client Pour définir Boleto comme moyen de paiement par défaut de votre client, ajoutez ce code : ```curl curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \ -u "<>:" \ -d "invoice_settings[default_payment_method]={{PAYMENT_ID}}" ``` ## Créer un produit et un tarif Définissez toutes vos offres commerciales au même endroit. Les *produits* (Products represent what your business sells—whether that's a good or a service) représentent les produits ou services que vous vendez et les *tarifs* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) définissent le montant et la fréquence de facturation. Ces entités centrales de Stripe sont compatibles avec les *abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis), les *factures* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) et [Checkout](https://docs.stripe.com/payments/checkout.md). Les tarifs permettent de mettre en œuvre les cas d’usage suivants : - Un fournisseur de logiciels qui facture des frais d’installation ponctuels dès qu’un utilisateur crée un nouvel abonnement. - Un magasin d’e-commerce qui expédie de manière récurrente une boîte de produits pour 10 USD par mois et qui souhaite permettre à ses clients d’acheter ponctuellement des produits supplémentaires. - Une entité de services aux entreprises qui peut désormais créer une liste standard de services et effectuer ses sélections dans cette liste pour chaque facture, au lieu de saisir manuellement chaque poste de facture. - Une organisation à but non lucratif qui permet aux donateurs d’établir un montant de dons récurrent et personnalisé pour chaque client Vous pouvez gérer votre catalogue de produits avec les produits et les tarifs. Les produits définissent ce que vous vendez, tandis que les tarifs indiquent le montant et la fréquence de facturation. Gérez vos produits et les tarifs associés dans le Dashboard ou en utilisant l’API. #### Dashboard Si vous avez utilisé le Dashboard dans un *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) pour configurer votre activité, vous pouvez copier chacun de vos produits vers le mode production à l’aide de l’option **Copier en mode production** de la [page du catalogue de produits](https://dashboard.stripe.com/products). Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application. 1. Accédez à la page du **catalogue de produits** et cliquez sur **Ajouter un produit**. 1. Choisissez si vous voulez créer un **produit ponctuel** ou un **produit ponctuel récurrent**. 1. Nommez votre produit et assignez-lui un tarif. #### API Découvrez comment créer des [produits](https://docs.stripe.com/api/products.md) et des [tarifs](https://docs.stripe.com/api/prices.md). > Pour un guide complet sur la démarche à suivre pour démarrer avec l’[interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md) ou les API, consultez le [guide d’intégration de la facturation de bout en bout](https://docs.stripe.com/invoicing/integration.md). ### Créer un produit Pour créer un produit, saisissez son nom : ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d "name=Gold Special" ``` ### Créer un tarif L’API [Prices](https://docs.stripe.com/api.md#prices) définit le montant et la fréquence de facturation des produits. Dans le cadre d’un abonnement, elle détermine notamment le coût du produit, la devise à utiliser et la période de facturation. De même que pour les produits, si vous n’avez défini que quelques tarifs, il est préférable de les gérer dans le Dashboard. Utilisez le montant unitaire pour exprimer les tarifs dans l’unité la plus faible de la devise, en l’occurrence les centimes (10 USD correspondant à 1 000 centimes, le montant unitaire est 1 000). Si vous n’avez pas besoin de créer un tarif pour votre produit, vous pouvez également utiliser le paramètre [amount](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-amount) lors de la création du poste de facture. Pour créer un tarif et l’associer au produit, transmettez l’ID du produit, le montant unitaire et la devise. Dans l’exemple suivant, le tarif du produit « Gold Special » est fixé à 10 USD : ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=1000 \ -d currency=usd ``` > #### Tarification localisée > > Lorsque vous [créez des postes de facture](https://docs.stripe.com/api/invoiceitems/create.md) ou des paiements via l’API, Stripe traite le montant et la devise que vous fournissez explicitement. Le prix localisé n’est pas calculé automatiquement, et vous êtes responsable de la transmission du montant et de la devise corrects pour la région de votre client. Nous recommandons d’utiliser le paramètre [pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) pour transmettre l’identifiant du prix. ## Créer un abonnement Vous pouvez créer et mettre à jour des abonnements depuis le Dashboard ou l’API. Mieux vaut utiliser l’API si vous avez un grand nombre d’abonnements à gérer ou si vous voulez le faire de manière programmatique. > Pour découvrir comment [créer une intégration d’abonnements complète](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md), consultez notre guide d’intégration. #### Dashboard ### Créer un abonnement Pour créer un abonnement : 1. Accédez à la page **Paiements** > **Abonnements**. 1. Cliquez sur **+Créer un abonnement**. 1. Sélectionnez ou ajoutez un client. 1. Saisissez les informations de tarif et de produit, ce qui vous permet d’ajouter plusieurs produits, un bon de réduction ou une période d’essai à l’abonnement. Dans la section des options **Avancées**, vous pouvez créer des [seuils pour l’utilisation calculée](https://docs.stripe.com/products-prices/pricing-models.md#usage-based-pricing) ou ajouter des champs de [facture personnalisée](https://docs.stripe.com/invoicing/customize.md). Une fois que vous avez terminé, cliquez sur **Planifier l’abonnement** ou **Démarrer l’abonnement**. Lorsque vous programmez un abonnement, vous pouvez le lancer immédiatement, le mois suivant ou à une date personnalisée. Vous pouvez y mettre fin immédiatement, après un certain nombre de cycles ou à une date de votre choix. ### Modifier un abonnement Pour modifier un abonnement : 1. Accédez à la page **Paiements** > **Abonnements**. 1. Recherchez l’abonnement que vous souhaitez modifier, cliquez sur le menu de débordement (⋯), puis sur **Mettre à jour l’abonnement**. Vous pouvez aussi cliquer sur l’✏ edit icon à côté du nom de l’abonnement. Depuis ce menu, vous pouvez également effectuer les actions suivantes : - **Annuler l’abonnement** : Sélectionnez une date pour annuler l’abonnement immédiatement, à la fin de la période actuelle ou à une date personnalisée. Vous pouvez aussi choisir de rembourser le dernier paiement de cet abonnement et de créer un [avoir](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) dans vos dossiers. - **Suspendre l’encaissement des paiements** : Sélectionnez la durée de la suspension (indéterminée ou se terminant à une date personnalisée) et le comportement des factures pendant cette suspension. - **Partager le lien de mise à jour des paiements** : Générez un lien que le client peut utiliser pour [mettre à jour le moyen de paiement de son abonnement](https://docs.stripe.com/billing/subscriptions/payment-methods-setting.md#update-payment-method). 1. Apportez vos modifications à l’abonnement. 1. Cliquez sur **Mettre à jour l’abonnement**. ### Supprimer un abonnement Vous ne pouvez pas supprimer un objet abonnement, mais vous pouvez l’annuler ou suspendre l’encaissement des paiements. Pour en savoir plus, consultez la section [Modifier un abonnement](https://docs.stripe.com/payments/boleto/set-up-subscription.md#edit-subscription). #### API ### Créer un abonnement Lorsque vous créez un [abonnement](https://docs.stripe.com/api/subscriptions.md), vous pouvez envoyer les factures au client par e-mail ou le débiter automatiquement à chaque cycle. #### Envoyer une facture par e-mail Pour créer un abonnement et envoyer automatiquement un e-mail à votre client à chaque période, saisissez le code suivant : ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "items[0][price]={{RECURRING_PRICE_ID}}" \ -d collection_method=send_invoice \ -d payment_behavior=default_incomplete \ -d "payment_settings[payment_method_types][0]=card" \ -d "payment_settings[payment_method_types][1]=boleto" \ -d days_until_due=3 ``` #### Débiter automatiquement votre client Pour créer un abonnement et facturer automatiquement votre client à chaque période, saisissez le code suivant : ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "items[0][price]={{RECURRING_PRICE_ID}}" \ -d collection_method=charge_automatically \ -d payment_behavior=default_incomplete \ -d off_session=true ``` ### Utiliser des sessions Checkout Vous pouvez également créer un abonnement à l’aide de [sessions Checkout](https://docs.stripe.com/api/checkout/sessions.md). Stripe envoie un coupon Boleto préalablement généré à l’adresse e-mail de votre client, à chaque cycle d’abonnement. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d customer={{CUSTOMER_ID}} \ -d "line_items[0][price]={{RECURRING_PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "payment_method_options[boleto][expires_after_days]=3" \ --data-urlencode "success_url=https://example.com/success" ``` ### Utiliser les planifications d’abonnement Certains clients souhaitent programmer leur abonnement à une date future ou ne s’inscrire que pour un an de service à la fois. Les [planifications d’abonnement](https://docs.stripe.com/api/subscription_schedules.md) vous permettent de configurer des phases avec un tarif récurrent de sorte qu’elles démarrent ultérieurement ou se terminent à une date donnée. Si vous souhaitez associer des achats ponctuels au début d’une phase, vous pouvez le faire en configurant le paramètre `add_invoice_items` sur une phase : #### curl ```bash curl https://api.stripe.com/v1/subscription_schedules \ -u <>: \ -d customer="{{CUSTOMER_ID}}" \ -d start_date=1780272000 \ -d "phases[0][items][0][price]={{RECURRING_PRICE_ID}}" \ -d "phases[0][add_invoice_items][0][price]={{PRICE_ID}}" ``` Cela permet de programmer un abonnement de 10 USD par mois prévu pour commencer à une date ultérieure, et la première facture correspondante inclura des frais ponctuels de 20 USD. Si vous configurez le paramètre `add_invoice_items` sur une phase future, les postes de facture ne seront pas générés avant le début de cette phase. Si vous configurez le paramètre `add_invoice_items` sur la phase actuelle, ils seront générés immédiatement. ## See also - [Fonctionnement de Subscriptions](https://docs.stripe.com/billing/subscriptions/overview.md)