Créer des échéanciers de paiement pour des facturesBêta
Les échéanciers de paiements des factures vous permettent de répartir le montant total d’une facture en plusieurs paiements avec différentes échéances pour vos clients. Vous pouvez ainsi proposer des options de facturation plus flexibles. Par exemple, vous pouvez percevoir un premier versement, puis solder la transaction à une date ultérieure. Vous pouvez également répartir le montant total en plusieurs paiements échelonnés dans le temps afin de proposer des conditions plus avantageuses à vos clients. Stripe rappelle à vos clients les prochains paiements qu’ils doivent effectuer et leur montre l’historique de ceux qu’ils ont déjà effectués. Vous pouvez utiliser le Dashboard et l’API pour générer des échéanciers de paiements.
Limitations
Payment Plans are currently a beta feature and have a few important limitations. Make sure that the following limitations don’t conflict with your use case:
- Payment Plans are not supported by Stripe Revenue Recognition or Stripe Connector for Netsuite.
- Payment Plans do not auto-charge customers with saved payment details. Customers must return to the payment page to make subsequent payments. They cannot be used with
charge_automatically
invoices. - Stripe automatically emails reminders to your customers to complete subsequent payments. These emails are sent by default one week before payments are due. Sending these emails overrides any email reminder schedules and settings for one-off invoices. You can turn off the email reminders by disabling the setting for Send finalized invoices and credit notes to customers.
- For Connect users, application fees cannot be set on Payment Plan-enabled invoices. You can only set fees on PaymentIntents.
- Additional fields associated with Payment Plans are not available in Sigma.
- Subscription invoices cannot have Payment Plans applied.
Vous souhaitez obtenir un accès anticipé aux échéanciers de paiement pour des factures ?
Ce guide explique comment configurer et gérer des échéanciers de paiements à 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 paramètre collection_method de la facture sur send_invoice
. Les factures de type charge_automatically
ne sont pas compatibles avec les échéanciers de paiement.
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 diviser le montant dû en plusieurs règlements dont votre client pourra s’acquitter plus facilement. 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 de paiements comme suit, à l’aide du champ amounts_due
:
curl https://api.stripe.com/v1/invoices \ -u
: \ -d customer=sk_test_4eC39HqLyjWDarjtT1zdp7dc\ -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_4eC39HqLyjWDarjtT1zdp7dc\ -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_due
pour des factures présentant différentes structures de paiement. Gardez à l’esprit que le montant total indiqué dans le champ amounts_due
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_due
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 due_date
champ 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_4eC39HqLyjWDarjtT1zdp7dc
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_until_due
. Le champ amounts_due
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
Lorsque vous avez configuré l’échéancier de paiement et ajouté les postes de facture nécessaires, vous pouvez finaliser la facture. Attention : une fois finalisée, vous ne pourrez plus la modifier. 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_4eC39HqLyjWDarjtT1zdp7dc\ -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_4eC39HqLyjWDarjtT1zdp7dc
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 plan 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 Payée partiellement dans le Dashboard Stripe. Cependant, si au moins un paiement n’est pas effectué à la date prévue, l’état En retard 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.