Factures d'abonnements

factures sont une ressource essentielle de Stripe, car elles établissent le montant dû par un client. Stripe génère une facture à chaque période de facturation du cycle d’un abonnement. Vous pouvez également générer des factures manuellement à l’aide du Dashboard ou de l’API dans le cas de paiements hors cycle ou ponctuels. Pour en savoir plus, consultez les guides consacrés au cycle de vie des factures indépendantes et des factures générées par abonnement.

Cycle de vie de la facture d’un abonnement

Les sections suivantes décrivent la manière dont Stripe gère une facture tout au long du cycle de vie d’un abonnement.

Factures d’un nouvel abonnement

Lorsqu’un nouveau client s’abonne, Stripe :

• Crée une facture.
• Finalise la facture environ une heure plus tard.

Si le paiement de la première facture d’un abonnement aboutit ou si la facture ne nécessite pas de paiement, la facture passe à l’état status=paid et l’abonnement devient actif.

L’état de la facture reste sur open et le paramètre auto_advance est défini sur false tant que le paiement n’a pas abouti. L’état de l’abonnement est défini sur incomplete. Découvrez comment résoudre les échecs de paiement des factures d’un nouvel abonnement qui nécessitent un moyen de paiement.

Dans certains cas, le passage à un abonnement supérieur ou inférieur génère également une nouvelle facture. Lorsque c’est le cas, nous désactivons d’emblée auto_advance pour ces factures.

Lorsqu’une facture est finalisée, vous ne pouvez pas ajouter de nouveaux postes ni apporter d’autres modifications susceptibles d’affecter le montant dû. Cependant, vous pouvez définir de nouveaux postes de facture pour ce client. Les postes ajoutés seront alors appliqués à la prochaine facture.

Factures de renouvellement d’abonnement

Lors du renouvellement d’un abonnement, Stripe :

• Crée une facture.

• Leaves the invoice in a draft status for about an hour.

• Tente de finaliser et régler la facture avec le moyen de paiement par défaut.

• Définit l’état de la facture sur paid si le paiement aboutit.

Lorsque Stripe crée une facture, vous recevez un événement invoice.created à l’endpoint de webhook que vous avez configuré. Dans ce cas, l’attribut de l’état de la facture est draft, ce qui signifie que ses postes de facture peuvent être modifiés.

Collecter les paiements

Lorsqu’une facture est due, Stripe tente d’encaisser le paiement soit en débitant automatiquement le moyen de paiement enregistré, soit en envoyant la facture par e-mail aux clients.

Relancer les paiements

Stripe propose plusieurs options pour gérer les échecs de paiement, notamment la fonction de relance intelligente basée sur le machine learning Smart Retries.

Gérer les factures d’abonnements

Mettre à jour la première facture d’un abonnement

La façon dont vous modifiez la première facture d’un abonnement dépend du paramètre du moyen de paiement du client pour l’abonnement. En cas de doute, vous pouvez vérifier le paramètre du moyen de paiement à l’aide de l’API ou du Dashboard.

Pour vérifier le moyen de paiement de l’abonnement à l’aide de l’API, vérifiez la valeur de collection_method dans l’objet Subscriptions pour le client. La valeur send_invoice signifie que Stripe envoie sa facture au client par e-mail. La valeur charge_automatically signifie que Stripe débite le client en votre nom à l’aide de son moyen de paiement par défaut.

Pour vérifier le moyen de paiement de l’abonnement dans le Dashboard, ouvrez la page Abonnements. Cliquez ensuite sur l’abonnement que vous souhaitez vérifier pour ouvrir son affichage détaillé. Dans la section Détails de l’abonnement, la valeur du champ Méthode de facturation définit le moyen de paiement : Utiliser le moyen de paiement par défaut ou Envoyer la facture.

Personnaliser les factures

Vous pouvez personnaliser vos factures de différentes manières :

• Ajouter des postes à une facture à venir
• Augmenter la fréquence des factures
• Ajouter de postes à la première facture d’un client
• Ajouter des postes à un brouillon de facture d’abonnement
• Générer une facture en dehors du cycle d’abonnement
• Mettre en suspens une facture d’abonnement pour vérification
• Émettre une facture d’abonnement avec des tarifs de poste configurables

Ajouter des postes de facture à une facture à venir

Vous pouvez ajouter jusqu’à 250 postes à une facture. Pour ajouter des postes à la prochaine facture du cycle :

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pricing[price]"=price_CBb6IXqvTLXp3f \
  -d customer=cus_4fdAW5ftNQow1a

Ces postes ponctuels sont ajoutés à la prochaine facture créée pour ce client. Pour vérifier qu’ils ont bien été ajoutés à un abonnement spécifique, utilisez le paramètre facultatif subscription pour les appliquer à cet abonnement.

Facturer les postes en attente plus fréquemment

Outre la modification du cycle de facturation, il existe d’autres moyens de facturer ces postes sans avoir besoin d’ajuster le cycle d’abonnement normal :

• Créez une facture ponctuelle pour votre client.

• Facturez un abonnement dès que le montant dû atteint un seuil.

• Utilisez le paramètre pending_invoice_item_interval pour spécifier la fréquence à laquelle les postes en attente doivent être facturés. Cette méthode revient au même que la création récurrente par Stripe d’une facture ponctuelle pour l’abonnement.

Ajouter un paiement supplémentaire sur la première facture d’un abonnement

Incluez un paiement ponctuel dans la première facture d’abonnement à l’aide de add_invoice_items:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "add_invoice_items[0][price]"={{PRICE_ID}} \
  -d payment_behavior=default_incomplete

Ajouter des postes de facture à un brouillon de facture d’abonnement

Lorsqu’un abonnement est renouvelé et fait l’objet d’une facture, Stripe envoie l’événement webhook invoice.created. Stripe attend environ une heure avant de finaliser la facture et de tenter d’effectuer le paiement ou d’envoyer un e-mail.

Pendant ce temps, la facture est à l’état, la facture est à l’état de brouillon et est modifiable. Vous pouvez créer des postes sur cette facture. Dans ce cas, assurez-vous de spécifier le paramètre invoice. afin d’éviter qu’ils ne deviennent des postes en attente et qu’ils ne soient inclus à la période d’abonnement suivante.

Ces postes de facture fonctionnent légèrement différemment de ceux générés automatiquement par Stripe :

• Les postes de facture en attente sont systématiquement facturés à la fin de la période de facturation de tout abonnement annulé. Lorsque l’abonnement d’un client est annulé, ce dernier ne sera plus facturé s’il ne reste plus aucun poste de facture.

• Lorsque l’abonnement d’un client est modifié, les postes de facture en attente ne sont pas calculés au prorata.

Si un abonnement est annulé alors que des postes de facture sont en attente, Stripe génère une facture et tente de facturer ces postes au client à la fin de la période de facturation suivante. De la même manière, ces postes de facture ne sont pas calculés au prorata lorsqu’un abonnement est modifié.

Gérer les poste de facture en attente

Vous pouvez afficher les factures en attente d’un client en accédant à la page Clients, puis en cliquant sur son nom. Si le client dispose d’un poste de facture en attente, il apparaît sous la rubrique Postes de facture en attente. Un poste de facture apparaît comme étant en attente s’il n’est associé à aucune facture.

Sous Postes de facture en attente, vous pouvez également choisir de créer un poste de facture ou de facturer instantanément tous les éléments affichés. Lorsque vous cliquez sur Facturer maintenant, une boîte de dialogue s’affiche et vous permet de choisir de facturer la source par défaut ou d’envoyer la facture par e-mail au client. En outre, la boîte de dialogue vous permet de calculer la taxe automatiquement.

Générer une facture pour les postes d’abonnement en dehors du cycle de facturation

Vous pouvez facturer des postes en attente en dehors du cycle de facturation habituel en générant une facture ponctuelle, qui reprend tous les postes en attente qui auraient été ajoutés à la facture planifiée.

Mettre en suspens une facture d’abonnement pour vérification

Plutôt que d’effectuer une tentative de paiement automatique à la fin de la période de facturation, vous pouvez suspendre la facture pour qu’elle soit vérifiée ou corrigée. Pour suspendre une facture :

1. Suspendez l’encaissement automatique dans la première heure suivant la réception de l’événement invoice.created en paramétrant auto_advance=false dans l’API, ou en accédant à Abonnements et e-mails dans le Dashboard. Recherchez la section de suspension des paiements, puis cliquez sur Configurer pour y apporter des modifications. Avec cette fonctionnalité, Stripe ne facturera pas automatiquement le client et ne lui enverra pas la facture par e-mail.

2. Vérifiez la facture.

3. Une fois que vous êtes prêt à facturer votre client, réactivez l’encaissement automatique en paramétrant auto_advance=true ou en mettant à jour les options de suspension des paiements dans le Dashboard.

Émettre une facture d’abonnement avec des tarifs de poste configurables

Vous pouvez émettre des factures qui n’incluent pas la taxe dans le prix des différents postes. Les prix hors taxe figurent seulement sur le PDF de la facture, ce qui signifie que lorsque vous choisissez d’indiquer les prix TTC, la page de facture hébergée et les e-mails de facturation affichent les prix TTC. Vous pouvez définir les paramètres pour les prix nets dans le Dashboard ou l’API.

• TTC : le PDF de la facture affiche les prix des postes en incluant la taxe (affichage par défaut).
• Hors taxe : le PDF de la facture affiche les prix des postes sans inclure la taxe.

Annuler une facture générée par un abonnement

Annuler la première facture d’un abonnement

Lorsque vous annulez la première facture d’un abonnement, Stripe applique la logique suivante en établi de l’état de l’abonnement :

• Si l’abonnement est à l’état incomplete, l’état de l’abonnement passe à incomplete_expired.
• Si l’abonnement est défini sur past_due, l’état de l’abonnement passe à active.
• Si l’abonnement est active, l’état de l’abonnement ne change pas.

Annuler la facture la plus récente d’un abonnement

Lorsque vous annulez la facture la plus récente d’un abonnement actif et que la facture n’est pas la première, Stripe applique la logique suivante à chaque facture, de la plus récente à la plus ancienne, jusqu’à ce qu’elle remplisse l’une des conditions suivantes :

• If the invoice is in a paid or uncollectible status, the subscription status changes to active.
• Si la collection_method est définie sur charge_automatically sur la facture et que Stripe a cessé les relances sur la facture en raison des limites de tentatives, l’abonnement passe à l’état canceled, unpaid ou past_due, établi vos paramètres d’encaissement automatique.
• Si collection_method est défini sur send_invoice et que la facture atteint sa date d’échéance, l’état de l’abonnement bascule sur past_due.
• If the invoice isn’t in one of these statuses, the same steps execute on the next most recent invoice.

Si aucune facture ne remplit l’un ou l’autre des critères ci-dessus, l’état de l’abonnement est défini sur active.

Métadonnées d’abonnement

Une fois qu’un abonnement a créé une facture, celle-ci inclut les metadata de l’abonnement des manières suivantes :

• L’attribut subscription_details.metadata de la facture contient toujours les metadata de l’abonnement au moment de la création de la facture, même si les metadata de l’abonnement sont modifiées ultérieurement.
• L’attribut metadata des sous-postes de facture avec type=“subscription” reflète les metadata d’abonnement les plus récentes au moment de la récupération de la facture, ce qui signifie qu’il peut différer des metadata au moment de la création de la facture.
• Les postes de facture avec type=“invoiceitem” ne contiennent pas les metadata de l’abonnement.

Lorsque vous modifiez directement les metadata d’un sous-poste de facture d’abonnement, que ce soit avec l’endpoint invoice line update ou bulk invoice line update, la demande de mise à jour déclare les metadata du sous-poste de facture. Les metadata « héritées » des abonnements ne sont pas conservées implicitement.

Les métadonnées des postes d’abonnement ne sont pas automatiquement propagées vers d’autres objets Stripe.