Suspendre l'encaissement des paiements

Apprenez à suspendre l'encaissement des paiements des abonnements.

La suspension de l’encaissement des paiements est souvent utilisée pour offrir temporairement vos services gratuitement. On parle parfois de « délai de grâce » si un client a besoin de plus de temps pour payer ou ne peut pas payer pendant une ou plusieurs périodes de facturation.

Suspendre un abonnement et suspendre l’encaissement des paiements

La suspension de l’encaissement des paiements maintient l’abonnement dans l’état active, les factures continuent d’être générées et seul l’encaissement est suspendu. Vos clients conservent l’accès au service pendant que vous suspendez l’encaissement.

La suspension d’un abonnement est différente : elle interrompt à la fois le service et la facturation. L’abonnement passe à l’état paused, Stripe cesse de générer des factures et votre client perd l’accès au service de l’abonnement pendant toute la durée de la pause.

	Le service est mis en pause (le client perd l’accès au service)	La facturation est mise en pause	L’encaissement des paiements est mis en pause
Suspendre la collecte des paiements	Non	Non	Oui
Suspendre l’abonnement	Oui	Oui	Oui

Vous pouvez suspendre ou reprendre le recouvrement dans le Dashboard Stripe ou via l’API. Même si le recouvrement est suspendu, les abonnements génèrent toujours des factures, mais vous disposez de plusieurs options pour les gérer. Consultez les cas d’usage suivants pour déterminer l’approche la plus adaptée.

Cas d’usage	Configuration de l’API
Proposer des services gratuitement de manière temporaire et ne jamais encaisser de paiement	Utiliser `behavior=void`
Proposer des services gratuitement de manière temporaire et procéder à l’encaissement plus tard	Utiliser `behavior=keep_as_draft`
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.

Si vous définissez pause_collection[behavior] sur mark_uncollectible, nous suspendrons le recouvrement actif des paiements pour les nouvelles factures créées par l’abonnement avant la date resumes_at. Stripe n’enverra pas d’e-mails ou de webhooks concernant les factures à venir.

Malgré cette interruption, Stripe applique tout solde client existant aux factures de façon à utiliser les fonds disponibles avant qu’une facture ne soit marquée comme uncollectible. Si le total de la facture est entièrement réglé à l’aide du solde du client, la facture passe à l’état paid. Dans le cas contraire, elle passe à l’état uncollectible.

Si vous ne définissez pas de date resumes_at, le recouvrement des paiements de 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.