Facturation anticipée

Grâce à la facturation anticipée, vous pouvez facturer vos clients à l’avance pour plusieurs périodes d’abonnement. Vous pouvez activer ce mode de facturation lors de la création d’un abonnement ou l’ajouter à un abonnement existant.

Cas d’usage

La facturation anticipée vous permet d’encaisser les paiements à l’avance pour des périodes d’abonnement futures. Voici les cas d’usage les plus courants :

Limitations

La facturation anticipée est soumise aux limites suivantes :

• Vous ne pouvez pas l’utiliser avec des planifications d’abonnement ou avec des abonnements adossés à une planification d’abonnement.
• En cas de préfacturation, vous pouvez utiliser des bons de réduction seulement avec percent_off et une durée de validité qui soit once ou forever.
• Vous ne pouvez pas activer la facturation anticipée si tous les éléments de l’abonnement ont des tarifs à l’usage. Dans le cas d’un abonnement, la facturation anticipée ne s’applique pas aux prix à l’usage. Vous ne pouvez pas définir applies_to[price] si le prix a utilisation_type=metered.
• Si l’annulation d’un abonnement est programmée et que vous tentez de définir la date de fin de préfacturation après la date d’annulation prévue, la date de fin est automatiquement fixée à la date d’annulation prévue.

Fonctionnement de la facturation anticipée

La facturation anticipée s’appuie sur le paramètre billing_schedules de l’abonnement pour définir les éléments à facturer à l’avance et la durée de la facturation. Lorsque vous configurez le paramètre billing_schedules, Stripe génère une facture anticipée (couvrant l’ensemble des périodes d’abonnement futures indiquées) dès la création ou la mise à jour de l’abonnement, plutôt que d’attendre chaque cycle de facturation.

La facturation anticipée s’applique au niveau de l’élément. Vous pouvez facturer certains éléments en amont en transmettant le paramètre applies_to avec les ID de tarifs concernés, ou omettre complètement le paramètre applies_to pour facturer l’ensemble des éléments éligibles qui sont au prix fixe de l’abonnement. Les tarifs à l’usage ne sont jamais concernés par la facturation anticipée, quelle que soit la configuration du paramètre applies_to.

Le paramètre bill_until contrôle la date de fin de la période de facturation anticipée. Vous pouvez l’exprimer sous forme d’une durée avec le paramètre duration (par exemple, 2 mois à partir de la date actuelle) ou sous forme d’horodatage avec le paramètre timestamp (un horodatage Unix spécifique).

Création d’un abonnement avec facturation anticipée

Pour configurer la facturation anticipée lors de la création d’un abonnement, utilisez le paramètre billing_schedules et précisez les éléments concernés, ainsi que la durée correspondante.

• Utilisez le paramètre applies_to pour spécifier les éléments à facturer en amont en indiquant leur ID de tarif, ou omettez-le pour facturer tous les éléments éligibles.
• Utilisez le paramètre bill_until pour définir la date de fin de la facturation anticipée sous la forme d’une durée ou d’un horodatage.
• Utilisez le paramètre proration_behavior pour contrôler à quel moment la facture liée à la facturation anticipée est générée.

Lorsque vous définissez la date de fin de la période de préfacturation :

• La date de fin ne peut pas précéder le terme de la première période de facturation. Si vous proposez un abonnement mensuel, la date de fin doit par exemple être fixée au moins un mois après le début de la période de facturation.
• Si la date de fin ne correspond pas à la fin d’une période de facturation, la partie de la période précédant la date de fin est préfacturée. Le reste est facturé séparément en fonction de la configuration de l’abonnement.
• Le nombre total de cycles de facturation anticipée pour l’ensemble des éléments ne peut pas dépasser 50. Si vous facturez deux éléments, vous pouvez par exemple le faire pour chacun d’eux jusqu’à 25 mois à l’avance.
• La date de fin de facturation anticipée ne peut pas dépasser un délai de 5 ans à compter de la date actuelle.

Mise à jour d’un abonnement existant pour y ajouter la facturation anticipée

Pour ajouter la facturation anticipée à un abonnement existant, mettez-le à jour à l’aide du paramètre billing_schedules. Le paramètre billing_mode=flexible doit déjà être activé sur l’abonnement.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d "billing_schedules[0][bill_until][type]=duration" \
  -d "billing_schedules[0][bill_until][duration][interval]=month" \
  -d "billing_schedules[0][bill_until][duration][interval_count]=2"

Frais d’annulation anticipée

Utilisez la facturation anticipée pour facturer aux clients la durée restante de leur engagement lorsqu’ils l’annulent prématurément. Ce cas de figure est courant pour les abonnements à durée déterminée assortis d’une facturation récurrente (par exemple mensuelle).

Un client s’abonne par exemple le 1er janvier à une offre d’un an avec facturation mensuelle pour un montant de 10 dollars par mois. Il résilie son abonnement le 10 septembre. Pour recouvrer le montant restant de son engagement, facturez l’abonnement de façon anticipée jusqu’à fin décembre sur sa facture finale, puis résiliez l’abonnement sans calcul au prorata.

1. Mettez l’abonnement à jour en définissant le paramètre billing_schedules.bill_until sur la date de fin de l’engagement (le 31 décembre).
2. Résiliez l’abonnement en définissant le paramètre proration_behavior sur none.

Les frais pour les mois d’octobre, de novembre et de décembre seront inclus dans la facture finale du client, ce qui couvre le reste de son engagement sous forme de frais d’annulation anticipée.

Ce système fonctionne également pour les engagements de plus longue durée (si un client annule par exemple un contrat de deux ans au cours du 18e mois), ainsi que pour les renouvellements anticipés. Dans ce cas, les clients modifient leur offre en cours de période et paient la durée restante à l’avance, au nouveau tarif.

Considérations supplémentaires

Délai de génération de la facture

La facture liée à la facturation anticipée est générée lors de la création ou de la mise à jour de l’abonnement incluant le paramètre billing_schedules. Le délai exact de génération dépend du paramètre proration_behavior :

• always_invoice : génère et finalise immédiatement la facture liée à la facturation anticipée, dès la création ou la mise à jour de l’abonnement.
• create_prorations : génère la facture liée à la facturation anticipée à la date du prochain cycle de facturation.

Utilisez always_invoice si vous souhaitez que le client reçoive immédiatement la facture anticipée. Utilisez create_prorations si vous souhaitez que la facture accompagne la facture habituelle du client à sa prochaine date de facturation.

Webhooks et événements

La facturation anticipée permet de générer des factures en dehors du cycle habituel de facturation. Assurez-vous que votre intégration gère les événements concernés. Il est par exemple possible d’envoyer un reçu au client lorsque la facture liée à la facturation anticipée est payée, ou de gérer l’échec d’un paiement avec un flux de nouvelle tentative.

Aperçu de la facture liée à la facturation anticipée

Vous pouvez afficher l’aperçu de la facture d’un client avant de créer ou de mettre à jour un abonnement pour utiliser la facturation anticipée. Utilisez l’API pour créer un aperçu de la facture et incluez billing_schedules dans le paramètre subscription_details. Vous aurez ainsi accès à la facture générée pour la facturation anticipée.

Interaction avec les bons de réduction

Seuls les bons de réduction avec percent_off et une duration de once ou forever sont compatibles avec la facturation anticipée. Les bons de réduction avec amount_off et les bons de réduction avec duration=repeating renvoient une erreur lorsqu’ils sont utilisés avec un abonnement qui a billing_schedules configuré.