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

When you enable automatic collection, Stripe automatically finalizes, and begins automatic collection of the invoice. We wait 1 hour after receiving a successful response to the invoice.created event from all listening webhooks before attempting payment. If we don’t receive a successful response within 72 hours, we attempt to finalize and send the invoice. You can configure a longer grace period.

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
:"

In live mode, if your webhook endpoint doesn’t respond properly, Stripe continues retrying the webhook notification for up to 3 days with an exponential back off. In a sandbox, we retry three times over a few hours. During that time, we won’t attempt to charge the customer unless we receive a successful response. We also send you an email to notify you that the webhook is failing.

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.