# Suspendre l'encaissement des paiements Apprenez à suspendre l'encaissement des paiements des abonnements. Vous pouvez suspendre l’encaissement des paiements pour offrir temporairement vos services gratuitement à un client. C’est ce qu’on appelle parfois un délai de grâce (par exemple, lorsqu’un client a besoin de plus de temps pour payer ou ne peut pas payer une ou plusieurs périodes de facturation). Lorsque vous suspendez l’encaissement des paiements, l’*abonnement* (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) reste `actif` et 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) continuent d’être générées, mais Stripe ne perçoit pas le paiement. Votre client conserve l’accès au service pendant cette période. ## Before you begin - Si vous souhaitez suspendre l’accès du client au service, suspendre l’encaissement des paiements et également suspendre les factures, consultez plutôt [Suspendre les abonnements](https://docs.stripe.com/billing/subscriptions/pause.md). - Si vous souhaitez arrêter définitivement le renouvellement, consultez plutôt [Annuler les abonnements](https://docs.stripe.com/billing/subscriptions/cancel.md). - Les factures créées avant de suspendre les abonnements continuent de faire l’objet de [nouvelles tentatives](https://docs.stripe.com/invoicing/automatic-collection.md) à moins que vous ne les [annuliez](https://docs.stripe.com/api/invoices/void.md). ## Suspendre le recouvrement des paiements Utilisez le Dashboard ou l’API pour suspendre l’encaissement des paiements. Vous pouvez choisir de suspendre l’encaissement des paiements indéfiniment ou de le reprendre automatiquement à une date ultérieure. Pendant que l’encaissement des paiements est suspendu, Stripe n’envoie aucun e-mail de facture à venir ni aucun webhook pour ces factures, et l’état de l’abonnement reste inchangé. Lorsque vous suspendez l’encaissement des paiements pour un abonnement, vous disposez de trois options pour gérer les factures pendant la période de suspension : | | | **Conserver les factures à l’état de brouillon** (`keep_as_draft`) | - Les factures sont créées à l’état `draft` avec la propriété `auto_advance` définie sur false. - Vous pourrez finaliser et percevoir le paiement plus tard. > 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. | | **Marquer les factures comme irrécouvrables** (`mark_uncollectible`) | - Les factures sont marquées comme irrécouvrables. Aucun paiement n’est perçu pour ces périodes. Stripe n’envoie aucun e-mail de facture à venir ni aucun webhook pour ces factures. - 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 irrécouvrable. 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`. | | **Annuler les factures** (`void`) | Les factures sont annulées. Aucun enregistrement de paiements n’est créé pour ces périodes. | Pour suspendre l’encaissement des paiements pour un abonnement : #### Dashboard 1. Sur la page [Subscriptions](https://dashboard.stripe.com/subscriptions), sélectionnez l’abonnement. 2. Cliquez sur le menu contextuel (⋯) et sélectionnez **Suspendre la collecte du paiement**. 3. Choisissez la durée : - **Indéfinie** : nous maintenons l’encaissement des paiements suspendu jusqu’à ce que vous le repreniez. - **Jusqu’à une date personnalisée** : nous reprenons automatiquement l’encaissement des paiements à la date de votre choix. 4. Choisissez le comportement de la facture : - **Conserver les factures à l’état de brouillon** : les factures sont créées sous forme de brouillons. Vous pourrez finaliser et percevoir le paiement plus tard. - **Marquer les factures comme irrécouvrables** : les factures sont marquées comme irrécouvrables. Aucun paiement n’est perçu pour ces périodes. - **Annuler les factures** : les factures sont annulées. Aucun enregistrement de paiements n’est créé pour ces périodes. 5. Cliquez sur **Pause**. #### API Pour suspendre l’encaissement des paiements pour un abonnement, [mettez à jour l’abonnement](https://docs.stripe.com/api/subscriptions/update.md) et définissez `pause_collection[behavior]`. Vous pouvez également définir `pause_collection[resumes_at]` pour reprendre automatiquement l’encaissement des paiements à un moment précis. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "pause_collection[behavior]=keep_as_draft" ``` ### pause_collection[behavior] Choisissez comment gérer les factures créées pendant la suspension de l’encaissement des paiements : - `keep_as_draft` : conserve toutes les factures à l’état de brouillon pendant que l’encaissement est suspendu. - `mark_uncollectible` : marque toutes les factures comme irrécouvrables pendant que l’encaissement est suspendu. - `void` : annule toutes les factures pendant que l’encaissement est suspendu. ### pause_collection[resumes_at] Un horodatage Unix après lequel l’abonnement recommence à percevoir les paiements. Si vous ne définissez pas `resumes_at`, l’encaissement des paiements reste suspendu jusqu’à ce que vous supprimiez `pause_collection`. > Si vous suspendez un abonnement géré par une planification d’abonnement, les mises à jour planifiées prennent toujours effet. Une transition de phase de la planification d’abonnement ne supprime pas automatiquement le comportement `pause_collection` qui a été défini directement sur l’abonnement. ## Reprendre l’encaissement des paiements Vous pouvez reprendre l’encaissement des paiements à tout moment via le Dashboard ou l’API pour un abonnement ou pour les factures conservées à l’état de brouillon. ### Reprendre l’encaissement à partir d’un abonnement #### Dashboard Pour reprendre l’encaissement des paiements dans le Dashboard : 1. Sur la page [Subscriptions](https://dashboard.stripe.com/subscriptions), recherchez l’abonnement concerné. 2. Cliquez sur le menu contextuel (⋯) et sélectionnez **Reprendre la collecte du paiement**. #### API Pour reprendre l’encaissement des paiements, [mettez à jour l’abonnement](https://docs.stripe.com/api/subscriptions/update.md) et supprimez `pause_collection`. Vous pouvez supprimer des clés individuelles en leur attribuant une valeur vide : #### curl ```bash curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \ -u <>: \ -d "pause_collection"= ``` ### Percevoir le paiement sur les factures à l’état de brouillon Après avoir repris l’encaissement des paiements d’un abonnement, définissez `auto_advance=true` sur chaque facture à l’état de brouillon. Si vous n’avez pas les ID de facture, recherchez-les en utilisant l’ID de l’abonnement avec `status=draft` comme filtre. #### Dashboard Après avoir repris l’encaissement des paiements d’un abonnement, pour chaque facture à l’état de brouillon : 1. Accédez à la page des [factures](https://dashboard.stripe.com/invoices/) dans le Dashboard, et cliquez sur la facture pour afficher sa page de détails. 2. Cliquez sur le menu de débordement (⋯). 3. Cliquez sur **Activer le recouvrement automatique**. Cela change la propriété `auto_advance` de la facture en `true`. #### API Récupérez les factures à l’état de brouillon pour l’abonnement : ```curl curl -G https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "subscription={{SUBSCRIPTION_ID}}" \ -d status=draft ``` Ensuite, pour chaque facture à l’état de brouillon, définissez `auto_advance` sur `true` : ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -d auto_advance=true ``` ## See also - [Suspendre les abonnements](https://docs.stripe.com/billing/subscriptions/pause.md)