pay_ est également l’ID du paiement une fois encaissée.
Utilisez l’API Factures pour créer et modifier des brouillons, puis les émettre ou les envoyer. Vous pouvez prélever une facture ouverte sur un moyen de paiement enregistré, ou annuler une facture que l’acheteur ne paiera pas.
La création d’un brouillon ne crée pas d’accès et ne prélève pas l’acheteur. Les coordonnées du destinataire sont stockées sur le membre du compte. Les champs financiers et les métadonnées de l’appelant ne peuvent être modifiés qu’à l’état de brouillon.
Endpoints
Attributs
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Propriétés
Propriétés
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Un lien signé qui ouvre cette facture dans une session de paiement afin que l’acheteur puisse la régler. Transmettez-le comme
link à POST /checkout_sessions. Présent tant que la facture est ouverte. null dans tout autre statut, pour une facture adressée à un acheteur professionnel, et pour une facture dont l’abonnement a été annulé. Également null sauf si vous disposez de payment:charge, ou de invoice:create ou invoice:update sur une facture sans payment_method_id.True lorsque
DELETE /invoices/\{id} peut supprimer cette facture. Un brouillon est éligible sauf s’il est programmé ou s’il facture un abonnement. Une facture annulée est éligible sauf si elle a encaissé de l’argent ou attend encore un virement bancaire.Propriétés
Propriétés
ID de la ligne, préfixé par
li_. Null lorsque le paiement est antérieur aux instantanés d’articles et que l’article est lu depuis la variante du paiement.Texte affiché sous l’article sur la facture, son e-mail et son PDF, lu depuis la
description de la variante. Un prélèvement personnalisé le définit avec la description de l’article. Une variante de produit conserve la sienne. Null lorsque la variante n’en a pas ou a été supprimée depuis.La remise promotionnelle appliquée à cet article, dans la
currency du paiement. Null lorsqu’aucune remise n’a été enregistrée.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
La partie de
unit_amount correspondant aux frais initiaux uniques d’une variante récurrente, le initial_price de la variante, prélevés sur cette facture uniquement. Le reste de unit_amount correspond à la première période de facturation. Un essai n’entraîne aucun prélèvement pour la première période. Null pour les articles ponctuels, les factures de renouvellement, les articles sans frais initiaux et les articles dont les prix de variante ont changé après la tarification de la facture.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Le nom de l’article tel qu’affiché lors du paiement (le titre du produit, sinon le titre de la variante).
Le produit auquel appartient la variante, préfixé par
prod_. Null pour une variante sans produit.unit_amount multiplié par quantity, avant remises et taxes, dans la currency du paiement.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
La taxe perçue sur cet article, dans la
currency du paiement. Null lorsqu’aucune taxe n’a été enregistrée.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Jours d’essai gratuit avant le premier prélèvement de renouvellement de cet article récurrent, issus du
trial_period_days de la variante. La facture ne facture alors que le initial_price de la variante pour l’article. null pour les articles ponctuels et les factures de renouvellement, et lorsque le client avait déjà un abonnement à la variante.Le prix enregistré d’une unité avant remises, dans la
currency du paiement. La création ou le remplacement d’articles récurrents inclut les frais initiaux, plus la première période de facturation sauf si l’article commence par un essai. Les factures de renouvellement excluent les frais initiaux. Les autres modifications conservent les prix enregistrés. Null lorsque le paiement n’a enregistré aucun prix.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
L’abonnement facturé par cette facture, préfixé par
mem_. Pour une facture de renouvellement, il s’agit de l’abonnement qui est renouvelé. Pour une facture comportant un article récurrent, il s’agit de l’abonnement créé lors de l’émission de la facture. Null pour les factures ponctuelles, pour un brouillon pas encore émis, et sans l’autorisation member:basic:read.Une note destinée au client, affichée dans l’e-mail de la facture, le PDF et la page de paiement en conservant ses sauts de ligne.
null lorsqu’aucune n’est définie.Les moyens de paiement parmi lesquels le client peut choisir lorsqu’il paie via le lien de paiement de la facture. Ce paramètre prime sur les variantes de la facture et sur le compte.
null lorsque la facture utilise les moyens de paiement de ses variantes.Propriétés
Propriétés
Moyens de paiement que ce checkout exclut, même lorsque les valeurs par défaut les proposeraient.
Date à laquelle le moyen de paiement enregistré de la facture sera prélevé, sous forme d’horodatage ISO 8601. Il s’agit du
charge_at avec lequel la facture a été envoyée ou émise. À défaut, il s’agit de due_at lorsqu’une facture avec un payment_method_id est envoyée ou émise avant son échéance. Sur un brouillon, il s’agit du charge_at de son envoi programmé. null sinon, dès que le prélèvement commence, et une fois la facture payée, annulée ou irrécouvrable.Le
collection_method qu’applique l’envoi programmé d’un brouillon lorsqu’il se déclenche. null lorsque le brouillon n’a pas d’envoi programmé ou qu’il a été programmé sans, et une fois la facture émise.Options disponibles : charge_automatically, send_invoiceIndique si ce brouillon est émis automatiquement à l’arrivée de son
due_at. Son émission prélève son payment_method_id, ou envoie par e-mail son lien de paiement à ses recipient_emails. false pour une facture qui n’est pas un brouillon et pour un brouillon avec un envoi programmé. false tant que l’envoi du brouillon échouerait faute de destinataires ou de lien de paiement disponible. false pour un brouillon qui n’avait pas de due_at futur lors de son dernier enregistrement. false pour un brouillon créé avant 2026-11-12T22:00:00Z.Options disponibles :
draft, open, authorized, paid, pending, uncollectible, unresolved, voidDate de début de la première période de facturation des articles récurrents de la facture, sous forme d’horodatage ISO 8601. Les renouvellements sont calculés à partir de ce moment. Avec
null, la période commence au paiement de la facture, de même qu’avec une date déjà passée à ce moment-là. Une facture avec une date de début ignore l’essai gratuit de ses variantes.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Le fuseau horaire IANA des dates figurant dans l’e-mail et le PDF de la facture, comme
America/New_York. UTC sauf si un fuseau a été défini.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Invoice

