Suspendre l'encaissement des paiements
Mise en garde
Les abonnements avec paused collection
ne peuvent pas passer à l’état status=paused
. Seule la fin des périodes d’essai gratuites sans avoir indiqué de moyen de paiement entraîne le passage au status
paused des abonnements.
La suspension de l’encaissement des paiements est souvent utilisée pour proposer vos services gratuitement de façon temporaire. Si le client a besoin de plus de temps pour payer ou n’est pas en mesure de payer pour un ou plusieurs cycles de facturation, on appelle également cela une « période de grâce ».
Vous pouvez suspendre ou reprendre l’encaissement dans le Dashboard Stripe ou l’API. Même si l’encaissement est suspendu, les abonnements continuent de générer des factures, mais plusieurs options s’offrent à vous pour les gérer. Examinez les cas d’usage suivants pour déterminer la meilleure approche pour votre entreprise :
Cas d’usage | Configuration de l’API |
---|---|
Proposer des services gratuitement de manière temporaire et procéder à l’encaissement plus tard | Utiliser behavior=keep_as_draft |
Proposer des services gratuitement de manière temporaire et ne jamais encaisser de paiement | Utiliser behavior=void |
Proposer temporairement des services gratuits et marquer la facture comme irrécouvrable | Utiliser behavior=mark_uncollectible |
Si ces options ne correspondent pas à votre cas d’usage, vous pouvez envisager d’annuler les abonnements à la place.
Les factures créées avant la suspension des abonnements sont toujours relancées, sauf si vous avez choisi de les annuler.
Proposer temporairement des services gratuits et ne jamais procéder à l’encaissement
Si vous souhaitez offrir vos services gratuitement de façon temporaire et ne pas encaisser le paiement associé à une facture (par exemple, une « période de grâce »), vous pouvez annuler les factures créées par votre abonnement de façon à vous assurer que vos clients ne sont pas facturés et que l’abonnement reste à l’état status=active
. Utilisez l’ID d’abonnement pour mettre à jour pause_collection[behavior]
vers void
et définir pause_collection[resumes_at]
à la date à laquelle vous souhaitez recommencer à encaisser les paiements.
Toutes les factures créées avant la date resumes_at
sont immédiatement marquées comme annulées. Stripe n’enverra pas d’e-mails pour les factures à venir ni de webhooks pour ces factures, et l’état de l’abonnement reste inchangé.
Si vous ne définissez pas de date resumes_at
, l’abonnement reste suspendu jusqu’à la désactivation de pause_collection
.
Proposer des services gratuitement de manière temporaire et procéder à l’encaissement plus tard
Si vous voulez proposer vos services gratuitement de manière temporaire et encaisser des paiements plus tard, définissez le paramètre pause_collection[behavior]=keep_as_draft
. Si vous savez quand vous recommencerez à encaisser des paiements, transmettez la date et l’heure correspondantes dans resumes_at
.
Toutes les factures créées avant la date resumes_at
demeurent à l’état draft
et auto_advance
est défini sur false
. Stripe n’enverra pas d’e-mails pour les factures à venir ni de webhooks pour ces factures, et l’état de l’abonnement reste inchangé.
Si vous ne définissez pas de date resumes_at
, l’abonnement reste suspendu jusqu’à la désactivation de pause_collection
.
Mise en garde
Si vous avez une logique personnalisée qui finalise les factures, il se peut que vous deviez la désactiver ou la modifier pour qu’elle n’entre pas en conflit avec ces paramètres.
Lorsque vous souhaiterez procéder à l’encaissement de ces factures, redéfinissez auto_advance
sur true
. Si vous n’avez pas les ID des factures, vous pouvez utiliser les ID d’abonnement pour vérifier les factures avec status=draft
. En utilisant les ID des factures, vous pouvez mettre à jour auto_advance=true
:
Proposer temporairement des services gratuits et marquer les factures comme irrécouvrables
Si vous souhaitez offrir vos services gratuitement de façon temporaire et marquer toutes les factures générées par l’abonnement comme irrécouvrables, utilisez l’ID de l’abonnement pour définir pause_collection[behavior]
sur mark_uncollectible
et éventuellement pause_collection[resumes_at]
à la date à laquelle vous souhaitez recommencer à encaisser les paiements. De cette façon, vous pouvez vous assurer que tous les rapports en aval sont exacts, que votre client n’est pas facturé et que l’abonnement reste à l’état status=active
.
Toutes les factures de l’abonnement créées avant la date resumes_at
sont immédiatement marquées comme irrécouvrables. Stripe n’enverra pas d’e-mails pour les factures à venir ni de webhooks pour ces factures, et l’état de l’abonnement reste inchangé.
Si vous ne définissez pas de date resumes_at
, l’abonnement reste suspendu jusqu’à la désactivation de pause_collection
.
Reprendre manuellement les encaissements
Pour reprendre les encaissements de paiement à tout moment, vous pouvez mettre à jour l’abonnement et désactiver pause_collection
:
Le reprise de l’encaissement de cette manière affecte uniquement les factures à venir.
Suspendre et planifier des abonnements
Si vous suspendez un abonnement dans une planification d’abonnement, les mises à jour planifiées prennent toujours effet. Cependant, le paiement n’est pas perçu tant que l’abonnement est suspendu. Lorsque vous voulez à nouveau procéder à l’encaissement du paiement, vous devez reprendre manuellement l’abonnement. Vous devez aussi mettre à jour auto_advance
pour le définir sur true
sur toutes les factures avec status=draft
dont vous souhaitez encaisser le paiement.