Changements et finalisation des états

Le graphique suivant illustre les changements possibles entre les différents états d’une facture :

Changements et finalisation des états

Changements et endpoints

Le tableau suivant présente les transitions d’état et leurs endpoints. Il répertorie également les webhooks émis pa l’endpoint, ainsi que l’état résultant pour chacun d’eux :

Finaliser des brouillons de facture

Lorsque vous activez l’encaissement automatique, Stripe finalise automatiquement la facture et commence son encaissement automatique. Nous attendons 1 heure après réception d’une réponse positive à l’événement invoice.created de la part de tous les webhooks en écoute avant de tenter le paiement. Si nous ne recevons aucune réponse de réussite dans les 72 heures, nous tentons de finaliser la facture et de l’envoyer. Vous pouvez fixer un délai plus long.

Les factures sont initialement créées avec status=draft, et vous ne pouvez les modifier que lorsqu’elles sont dans cet état. Lorsqu’une facture est prête à être payée, finalisez-la. La finalisation d’une facture lui applique status=open. Vous pouvez finaliser manuellement une facture dans le Dashboard ou en utilisant l’endpoint Finalize. Si vous avez configuré des endpoints de webhook, vous recevez un événement invoice.finalized lorsqu’une facture est finalisée.

curl -X POST https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

En mode production, si votre endpoint de webhook ne renvoie pas de réponse correcte, Stripe continue de tenter la notification de webhook pendant 3 jours au maximum, avec un allongement exponentiel des délais. Dans un environnement de test, nous procédons à trois tentatives sur une période de quelques heures. Pendant ce temps, nous ne tenterons pas de débiter le client tant que nous n’aurons pas reçu une réponse positive. Nous vous enverrons également un e-mail en cas d’échec du webhook.

Ce comportement s’applique à tous les endpoints de webhook définis sur votre compte, y compris les cas où une application Stripe Connect ou un service tiers rencontre des problèmes pour gérer les webhooks entrants.

Vous pouvez établir une période de grâce plus longue.

Post-finalisation

La finalisation d’une facture :

• Permet le paiement de la facture.
• Garantit la présence d’un numéro de facture.
• Rend certaines propriétés immuables sur la facture.
• Crée un Payment Intent incomplet pour la facture.
• Génère une URL unique permettant au client de payer la facture et un lien pour télécharger la facture au format PDF.

Restrictions relatives aux factures finalisées

Après la finalisation d’une facture, certains champs relatifs au montant et au client ne sont plus modifiables. Cette restriction vise à satisfaire à l’exigence courante en matière de conformité fiscale selon laquelle les factures finalisées doivent être conservées telles qu’elles ont été finalisées pendant une période minimale requise par la loi.

Dans certaines juridictions, le fait de corriger des champs qui modifient le montant total dû sur une facture peut rendre cette dernière invalide. Il s’agit généralement des champs associés au compte, au client, aux postes ou aux taxes. Il vous incombe de vous assurer que les factures que vous créez sont conformes à toutes les réglementations en vigueur.

Si vous avez besoin de mettre à jour le montant de la facture après sa finalisation, utilisez des avoirs. Ces derniers vous permettent de modifier le montant de la facture en spécifiant un réajustement de l’argent dû par le client. Vous pouvez émettre des avoirs pour chaque facture se trouvant à l’état open ou paid. La finalisation de la facture entraîne la copie des champs client suivants et les rend immuables :

• invoice.customer_address
• invoice.customer_email
• invoice.customer_name
• invoice.customer_phone
• invoice.customer_shipping
• invoice.customer_tax_exempt
• invoice.customer_tax_ids

Si vous souhaitez modifier une propriété relative au client sur une facture :

1. Annulez la facture existante.
2. Dupliquez la facture annulée.
3. Mettez à jour les informations du client sur la nouvelle facture.

E-mails après la finalisation

Par défaut, Stripe envoie automatiquement des factures lorsque vous définissez la collection_method sur send_invoice. Stripe n’envoie pas les factures par e-mail dans les cas suivants :

• Lors de la facturation automatique.
• Lorsque l’encaissement automatique est désactivé pour la facture.
• Lorsque l’option Envoyer les factures finalisées aux clients par e-mail est désactivée.

Paiements asynchrones

Certains moyens de paiement requièrent une interaction de la part du client pour la finalisation du paiement. Par exemple, une carte ou un virement bancaire européen peut nécessiter une authentification forte du client (SCA).

Utilisez le paramètre payment_intent de la facture pour déterminer comment traiter la réponse à la tentative de paiement, qui peut être soit success, soit requires_action.

Lorsque l’état du PaymentIntent est requires_action, vous devez amener l’utilisateur à effectuer une authentification 3D Secure pour finaliser le paiement.

Si vous le souhaitez, Stripe peut s’en occuper pour vous. Dans le Dashboard, activez les e-mails de rappel pour permettre à Stripe d’envoyer automatiquement des e-mails à vos clients lorsque requires_action a lieu. Ces e-mails incluent un lien vers la page de facture hébergée sur laquelle les clients peuvent réaliser toutes les actions nécessaires au paiement de la facture. Pour en savoir plus sur ces e-mails et sur leurs options de personnalisation, consultez la page relative à l’envoi d’e-mails de rappel.