Suspendre l'encaissement des paiements

Apprenez à suspendre l'encaissement des paiements des abonnements.

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 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.