Factures d'abonnements

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.

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.

• Laisse la facture à l’état draft pendant environ une heure.

• 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 via des webhooks configurés. Dans ce cas, l’attribut de l’état de la facture est draft, ce qui signifie que les 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.

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.

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d 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 lorsque 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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

When a subscription renews and creates an invoice, Stripe sends the invoice.created webhook event. Stripe waits approximately one hour before finalizing the invoice and attempting payment, or sending an email.

During that delay, the invoice is a draft and is editable. You can create invoice items on that invoice. Make sure to provide the invoice parameter when you create these invoice items. Otherwise, they’re added as pending items and are included in the next subscription period.

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.

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.