# 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. Vous pouvez suspendre ou reprendre le recouvrement dans le [Dashboard Stripe](https://support.stripe.com/questions/how-to-pause-or-cancel-subscriptions) ou via l’API. Même si le recouvrement est suspendu, les *abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) génèrent toujours des *factures* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice), 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](https://docs.stripe.com/billing/subscriptions/pause-payment.md#collect-payment-never) | Utiliser `behavior=void` | | [Proposer des services gratuitement de manière temporaire et procéder à l’encaissement plus tard](https://docs.stripe.com/billing/subscriptions/pause-payment.md#collect-payment-later) | Utiliser `behavior=keep_as_draft` | | [Proposer temporairement des services gratuits et marquer la facture comme irrécouvrable](https://docs.stripe.com/billing/subscriptions/pause-payment.md#mark-as-uncollectible) | Utiliser `behavior=mark_uncollectible` | Si ces options ne correspondent pas à votre cas d’usage, vous pouvez envisager d’[annuler les abonnements](https://docs.stripe.com/billing/subscriptions/cancel.md) à la place. Les factures créées avant la suspension des abonnements sont toujours [relancées](https://docs.stripe.com/invoicing/automatic-collection.md), sauf si vous avez choisi de les [annuler](https://docs.stripe.com/api/invoices/void.md). ## 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. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "pause_collection[behavior]=void" ``` 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`. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "pause_collection[behavior]=keep_as_draft" ``` 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`. > 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` : ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -d 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`. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "pause_collection[behavior]=mark_uncollectible" ``` 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` : #### curl ```bash curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \ -u <>: \ -d "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](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), 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](https://docs.stripe.com/billing/subscriptions/pause-payment.md#unpausing) 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.