Créer des échéanciers de paiement pour des facturesVersion bêta publique
Découvrez comment créer des échéanciers de paiement pour vos factures Stripe.
Les échéanciers de paiement des factures vous permettent de diviser le montant total d’une facture en paiements distincts avec des dates d’échéance différentes pour vos clients. Cela peut accroître votre flexibilité en matière de facturation. Par exemple, vous pouvez d’abord percevoir un acompte, puis le montant du solde d’une transaction à une date ultérieure. Vous pouvez également offrir des conditions de paiement plus favorables à vos clients en divisant le montant total en plusieurs petits versements à effectuer sur une certaine durée. Stripe rappelle à vos clients les paiements à venir et leur montre l’historique des paiements déjà effectués. Vous pouvez utiliser à la fois le Dashboard et l’API pour générer des échéanciers de paiement.
Limites
Les échéanciers de paiement sont actuellement en version bêta et présentent quelques limitations importantes. Assurez-vous que les limitations suivantes n’entrent pas en conflit avec votre cas d’usage :
- Les échéanciers de paiement ne sont pas compatibles avec Stripe Revenue Recognition ni avec le Stripe Connector for Netsuite.
- Les factures présentant des échéanciers de paiement ne sont pas reflétées avec précision par le suivi des obligations fiscales de Stripe Tax. Contactez votre conseiller fiscal.
- Stripe Tax ne prend pas en charge les remboursements partiels donc l’obligation fiscale ne sera pas reflétée avec précision. Consultez votre conseiller fiscal.
- Les échéanciers de paiement ne permettent pas de débiter automatiquement les clients dont les informations de paiement ont été enregistrées. Les clients doivent revenir à la page de paiement pour effectuer les paiements suivants. Vous ne pouvez pas les utiliser avec les factures
charge_.automatically - Par défaut, Stripe envoie automatiquement des e-mails de rappel à vos clients une semaine avant chacun des paiements suivants. L’envoi de ces e-mails prime sur vos éventuels calendriers de rappels par e-mail et sur les paramètres des factures ponctuelles. Pour ne plus envoyer d’e-mails de rappel, vous pouvez désactiver le paramètre Envoyer les factures finalisées et avoirs aux clients.
- Les utilisateurs Connect ne peuvent pas définir des commissions de plateforme sur les factures associées à des échéanciers de paiement. Vous pouvez uniquement définir des frais sur les PaymentIntents.
- Les champs supplémentaires associés aux échéanciers de paiement ne sont pas disponibles dans Sigma.
- Certains graphiques d’analyse Billing (Abonnés les plus importants, Recouvrements) n’enregistrent que les factures entièrement payées. Les autres graphiques ne sont pas affectés.
- Les factures d’abonnement ne peuvent pas faire l’objet d’échéancier de paiement.
Remarque
Si vous souhaitez activer les options de paiement différé pour les factures B2C, lisez notre guide sur le sujet pour plus d’informations.
Ce guide explique comment configurer et gérer des échéanciers de paiement à l’aide du champ amounts_due de l’API Invoicing.
Créer des objets complémentaires
Avant de configurer des échéanciers de paiement, veillez à en comprendre le concept en consultant le guide consacré à l’intégration avec l’API Invoicing. Dans ce guide, nous partons du principe que vous maîtrisez déjà la création de produits, de tarifs et de clients à l’aide de l’API ou du Dashboard Stripe.
Créer une facture avec échéancier de paiement
Le champ amounts_due vous permet de configurer des échéanciers de paiement pour des factures Stripe. Pour utiliser cette fonctionnalité, définissez le collection_method de la facture sur send_. Les échéanciers de paiement ne sont pas pris en charge pour les factures charge_.
Dans cette section, nous vous présentons deux cas d’usage des échéanciers de paiement : les conditions de paiement flexibles et le versement initial.
Conditions de paiement flexibles
Utilisez des échéanciers de paiement pour scinder le montant dû en plusieurs versements. Imaginons par exemple que vous souhaitiez qu’un client règle sa facture de 6 000 USD en trois paiements. Vous pouvez configurer l’échéancier comme suit, à l’aide du champ amounts_ :
curl https://api.stripe.com/v1/invoices \ -u: \ -d customer=sk_test_BQokikJOvBiI2HlWgH4olfQ2\ -d collection_method=send_invoice \ -d auto_advance=true \ -d "amounts_due[][amount]=2000" \ -d "amounts_due[][days_until_due]=30" \ -d "amounts_due[][description]=Payment 1" \ -d "amounts_due[][amount]=2000" \ -d "amounts_due[][days_until_due]=60" \ -d "amounts_due[][description]=Payment 2" \ -d "amounts_due[][amount]=2000" \ -d "amounts_due[][days_until_due]=90" \ -d "amounts_due[][description]=Payment 3"{{CUSTOMER_ID}}
Acompte
Il peut arriver que vous exigiez le versement d’un acompte, suivi d’un échéancier de paiement pour le montant restant. Prenons l’exemple d’une facture de 5 000 USD : vous souhaitez que votre client s’acquitte d’un acompte de 1 000 USD, puis qu’il règle la somme restante en deux versements d’un montant égal. Pour ce faire, configurez l’échéancier de paiement suivant :
curl https://api.stripe.com/v1/invoices \ -u: \ -d customer=sk_test_BQokikJOvBiI2HlWgH4olfQ2\ -d collection_method=send_invoice \ -d auto_advance=true \ -d "amounts_due[][amount]=1000" \ -d "amounts_due[][days_until_due]=1" \ -d "amounts_due[][description]=Deposit" \ -d "amounts_due[][amount]=2000" \ -d "amounts_due[][days_until_due]=30" \ -d "amounts_due[][description]=Payment 1" \ -d "amounts_due[][amount]=2000" \ -d "amounts_due[][days_until_due]=60" \ -d "amounts_due[][description]=Payment 2"{{CUSTOMER_ID}}
Les exemples ci-dessus montrent comment configurer des échéanciers de paiement à l’aide du champ amounts_ pour des factures présentant différentes structures de paiement. Gardez à l’esprit que le montant total indiqué dans le champ amounts_ doit correspondre au montant final amount_due de la facture. Appuyez-vous sur ces exemples pour créer des échéanciers de paiement adaptés à vos besoins.
Modifier l'échéancier de paiement
Vous pouvez modifier le champ amounts_ d’une facture avant sa finalisation. Cela vous permet d’apporter les éventuelles modifications nécessaires à l’échéancier de paiement, qu’il s’agisse de définir de nouvelles dates d’échéance, de modifier les montants ou d’ajouter de nouveaux paiements.
Vous pouvez non seulement configurer le nombre de jours avant l’échéance d’un paiement à l’aide du paramètre days_until_due, mais aussi définir une date d’échéance spécifique dans le champ due_date. Ce champ due_ vous permet de spécifier la date précise d’un paiement, pour une personnalisation plus poussée de vos échéanciers de paiement.
Voici un exemple de modification d’échéancier de paiement d’une facture :
curl https://api.stripe.com/v1/invoices/\ -u{{INVOICE_ID}}: \ -d "amounts_due[][amount]=1000" \ -d "amounts_due[][due_date]=1677514200" \ -d "amounts_due[][description]=Updated Payment 1" \ -d "amounts_due[][amount]=3000" \ -d "amounts_due[][due_date]=1678132000" \ -d "amounts_due[][description]=Updated Payment 2"sk_test_BQokikJOvBiI2HlWgH4olfQ2
Dans cet exemple, nous cherchons à modifier l’échéancier de paiement d’une facture pour indiquer des dates d’échéance précises plutôt que d’utiliser le paramètre days_. Le champ amounts_ reflète les nouveaux montants. Comme vous le voyez, vous bénéficiez d’une grande marge de manœuvre avant la finalisation des factures.
Finaliser la facture
Vous pouvez finaliser une facture après avoir configuré l’échéancier de paiement et ajouté les postes de facture souhaités. Une fois finalisée, vous ne pourrez plus modifier la facture. Cela signifie que vous ne pourrez plus apporter de changements à l’échéancier, ajouter ou supprimer des postes, ni modifier les montants ou les dates figurant sur la facture.
Avant de finaliser votre facture, vérifiez que vous avez ajouté les postes de facture nécessaires. Voici la marche à suivre :
curl https://api.stripe.com/v1/invoiceitems \ -u: \ -d customer=sk_test_BQokikJOvBiI2HlWgH4olfQ2\ -d invoice={{CUSTOMER_ID}}\ -d price={{INVOICE_ID}}\ -d currency=usd{{PRICE_ID}}
Après avoir ajouté les postes de facture souhaités et vérifié la configuration de votre échéancier, finalisez la facture. Voici comment finaliser une facture :
curl https://api.stripe.com/v1/invoices//finalize \ -u{{INVOICE_ID}}: \ -X POSTsk_test_BQokikJOvBiI2HlWgH4olfQ2
Une fois la facture finalisée, vous pouvez l’envoyer au client pour paiement. Si vous souhaitez y apporter une modification, vous devez le faire avant la finalisation ; c’est pourquoi nous vous recommandons de vérifier les informations figurant sur la facture avant de la finaliser. Pour en savoir plus sur l’étape de finalisation, consultez le guide consacré à la finalisation et aux changements d’état.
Actions ou factures post-finalisation
Vous pouvez toujours réviser, annuler ou marquer comme irrécouvrable une facture finalisée avec un échéancier de paiement, mais seulement avant d’avoir reçu le premier paiement. En outre, en dehors de Stripe, les échéanciers de paiement ne peuvent être « marqués comme payés » que pour la totalité du montant restant dû de la facture, et non pour un montant partiel.
Suivi de factures partiellement payées
Les factures d’échéanciers de paiement ayant été partiellement réglées affichent un état partially paid dans le Dashboard Stripe. Cependant, si au moins un paiement n’est pas effectué à la date prévue, l’état overdue s’affiche en priorité. Pour afficher l’état de la facture avec l’API, consultez les champs amounts_due et payments. Ils vous donneront des indications utiles.