# Crédits de facturation Découvrez comment utiliser les crédits de facturation pour des produits ou services prépayés ou promotionnels basés sur l’utilisation. Utilisez les octrois de crédit pour offrir des crédits de facturation à vos clients dans vos flux de travail, par exemple : - **Prépaiement** : accordez à vos clients des crédits de facturation qu’ils peuvent utiliser pour payer des produits ou services basés sur l’usage, tels que des adhésions, des plans avec paiement à l’usage, des abonnements ou des produits ou services spécifiques. - **Offre promotionnelle** : accordez gratuitement des crédits de facturation à vos clients dans le cadre d’une offre promotionnelle. Les entreprises offrent souvent un nombre limité de crédits promotionnels, et généralement avec une date d’expiration. Le diagramme suivant illustre le fonctionnement des crédits de facturation avec la facturation à l’usage : (See full diagram at https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits) ## Cas d’usage pour les crédits de facturation Reportez-vous aux conseils suivants pour l’utilisation des crédits de facturation. **Utilisations approuvées** - Vous pouvez accorder des crédits de facturation à vos clients, gratuitement ou moyennant des frais. - Vos clients peuvent utiliser les crédits de facturation pour payer des adhésions, des offres de paiement à l’utilisation, des abonnements ou des produits ou services spécifiques que vous proposez. **Utilisations interdites** - Vous ne pouvez pas émettre de crédits de facturation sous forme de cartes ou de chèques-cadeaux. De même, vous ne pouvez pas autoriser vos clients à dépenser des crédits de facturation ou à les échanger contre des cartes ou des chèques-cadeaux. - Vous ne pouvez pas proposer à vos clients des crédits de facturation sous forme de valeur stockée. Cela signifie que vous ne pouvez pas accorder de crédits de facturation qui ne sont pas destinés à être dépensés pour des adhésions, des plans avec paiement à l’usage, des abonnements ou des produits ou services spécifiques que vous proposez. - Vous ne pouvez pas autoriser vos clients à utiliser des crédits de facturation pour régler des tiers. Par exemple, vous ne pouvez pas leur permettre d’appliquer des crédits de facturation à des achats effectués sur le site Web ou la plateforme d’une autre entreprise. - Vous ne pouvez pas lier les crédits de facturation aux portefeuilles numériques, ni autoriser vos clients à le faire. Par exemple, vous ne pouvez pas autoriser vos clients à ajouter des crédits de facturation à un portefeuille électronique, tel qu’Apple Pay ou Google Pay. ## Octrois de crédit Un [octroi de crédit](https://docs.stripe.com/api/billing/credit-grant.md) suit un ensemble de crédits de facturation prépayés ou promotionnels alloués à un client. Les octrois de crédit ont les états suivants : | État | Description | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | En attente | Le [available_balance](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-available_balance) de l’octroi de crédit n’est pas encore disponible. | | Octroyé | L’octroi de crédit peut être utilisé en fonction de l’horodatage [effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at), lequel doit être défini sur une date ultérieure. Si vous ne définissez pas ce champ, l’octroi de crédit prend effet immédiatement. | | Épuisé | Le solde de l’octroi de crédit est entièrement utilisé. | | Expiré | Vous pouvez [faire expirer](https://docs.stripe.com/api/billing/credit-grant/expire.md) immédiatement tous les crédits restants pour un octroi de crédit, ou vous pouvez spécifier une date d’expiration à l’aide du champ [expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at). Les crédits n’expireront que si vous définissez ce champ. | | Annulé | Vous pouvez uniquement [annuler](https://docs.stripe.com/api/billing/credit-grant/void.md) les octrois de crédit que vous n’avez pas appliqués à une facture, que ce soit partiellement ou totalement. Vous ne pouvez pas appliquer les octrois de crédit annulés aux factures à venir, mais vous pouvez faire expirer les crédits restants. | ## Admissibilité à l’octroi de crédit Vous pouvez appliquer des octrois de crédit à vos factures si toutes les conditions suivantes sont remplies : - La valeur [period_end](https://docs.stripe.com/api/invoices/object.md#invoice_object-period_end) de la facture est égale ou postérieure à la valeur [effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at) de l’octroi de crédit. - La valeur `period_end` de la facture est antérieure à l’horodatage [expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at) de l’octroi de crédit, s’il est défini. - Le solde de l’octroi de crédit est disponible à la finalisation de la facture. - La devise de l’octroi de crédit correspond à celle de la facture. Vous ne pouvez appliquer des octrois de crédit qu’aux postes d’abonnement qui utilisent des [tarifs à la consommation](https://docs.stripe.com/api/prices/object.md#price_object-recurring-usage_type) et qui rendent compte de leur usage à l’aide de [dispositifs de mesure](https://docs.stripe.com/api/billing/meter.md). Vous ne pouvez pas accorder de crédits aux factures suivantes : - Factures ponctuelles qui n’ont pas été créées dans le cadre d’un abonnement. - Éléments de facture ponctuels qui sont ajoutés à la [facture à venir](https://docs.stripe.com/api/invoices/create_preview.md) d’un abonnement, p. ex. les frais de configuration initiale. - [Postes](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines) sur les factures d’abonnement qui utilisent des [tarifs sous licence](https://docs.stripe.com/api/prices/object.md#price_object-recurring-usage_type). - [Postes](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines) sur les factures d’abonnement qui utilisent des [tarifs à la consommation](https://docs.stripe.com/api/prices/object.md#price_object-recurring-usage_type), mais qui rendent compte de l’usage à l’aide des anciens [enregistrements d’utilisation](https://docs.stripe.com/api/usage_records.md). ## Appliquer des octrois de crédit Vous pouvez appliquer des attributions de crédit aux [postes d’abonnement](https://docs.stripe.com/api/subscription_items.md) qui sont liés à un [tarif de compteur](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=2025-09-30.preview&rds=1#billing_credit_grant_object-applicability_config-scope). Les attributions de crédit s’appliquent aux factures après les remises, mais avant les taxes et le [invoice_credit_balance](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_credit_balance). ### Champ d’application du tarif Lors de la création d’un octroi de crédit, vous pouvez configurer le [champ d’application](https://docs.stripe.com/api/billing/credit-grant/create.md#create_billing_credit_grant-applicability_config-scope-price_type) pour fournir une liste de tarifs à la consommation auxquels un octroi de crédit peut s’appliquer. Si le tarif d’un poste d’abonnement correspond à l’un des tarifs applicables de l’octroi de crédit, l’octroi de crédit peut s’appliquer à ce poste. ### Factures ou postes multiples Si vous pouvez appliquer un crédit à plusieurs factures, le crédit s’applique en priorité à la facture finalisée en premier. Étant donné que les factures d’abonnement sont finalisées automatiquement dès qu’elles sont admissibles, nous ne pouvons pas garantir l’ordre de finalisation. Si vous pouvez appliquer un crédit à plusieurs [postes](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines) sur la même facture, le crédit s’applique aux postes dans l’ordre dans lequel ils apparaissent sur la facture. ### Octrois de crédit multiples Si vous pouvez accorder plusieurs crédits à une facture ou à un poste, vous devez les classer par ordre de priorité comme suit : 1. **Priorité** : les octrois de crédits à la [priorité](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-priority) plus élevée (un nombre plus faible indique une priorité plus élevée) s’appliquent en premier. 1. **Date d’expiration** : les octrois de crédit dont l’horodatage [expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at) est antérieur s’appliquent en premier. 1. **Catégorie** : les crédits de la catégorie `promotional` sont utilisés en priorité. 1. **Date d’entrée en vigueur** : les octrois de crédit dont l’horodatage [effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at) est antérieur sont utilisés en priorité. 1. **Date de création** : les octrois de crédit dont l’horodatage de [création](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-created) est antérieur sont utilisés en priorité. ### Factures prévisionnelles, à l’état de brouillon ou finalisées Les crédits s’appliquent aux factures uniquement au moment de la [finalisation](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized). Si vous appliquez des crédits à une facture [à venir](https://docs.stripe.com/api/invoices/create_preview.md) ou à l’état de [brouillon](https://docs.stripe.com/invoicing/overview.md#draft), ces crédits peuvent être modifiés si une facture finalisée les utilise en premier. **Exemple 1** : À la fin d’un cycle, le même ensemble de crédits apparaît à la fois sur un brouillon de facture et sur une facture à venir. Une fois finalisé, le brouillon de facture utilise les crédits. La facture à venir est alors réajustée pour refléter avec précision les crédits restants de l’octroi de crédit. **Exemple 2** : Un client dispose de plusieurs abonnements actifs et le même ensemble de crédits apparaît sur une facture à venir pour tous les abonnements. Si les crédits sont insuffisants pour couvrir tous les abonnements lorsque les factures finalisées sont générées, seules certaines factures bénéficient des crédits. Si vous utilisez des [seuils de facturation](https://docs.stripe.com/billing/subscriptions/usage-based/thresholds.md), ils risquent de se déclencher plus tard que prévu en raison des crédits qui s’appliquent à plusieurs factures à venir. ## Récapitulatifs et transactions du solde créditeur [Credit Balance Summary](https://docs.stripe.com/api/billing/credit-balance-summary.md) affiche les éléments suivants pour un client : - **Solde du grand livre** : le montant du solde reflète le solde du crédit de facturation après enregistrement des transactions du grand livre pertinentes. Un octroi de crédit est garanti par un grand livre immuable qui n’est accessible qu’en annexe. - **Solde disponible** : solde du crédit de facturation que le client peut utiliser. Ce montant est égal au solde du grand livre, moins les crédits expirés et les transactions non enregistrées. Une [opération sur solde créditeur](https://docs.stripe.com/api/billing/credit-balance-transaction.md) inclut les crédits et débits affectant un octroi de crédit. Par exemple, vous pouvez voir une transaction de crédit pour le financement initial de l’octroi de crédit, ou une transaction de débit pour un octroi de crédit sur une facture. ## Annuler des factures et émettre des avoirs Les cas suivants s’appliquent si vous annulez des factures et émettez des notes de crédit : - [L’annulation d’une facture](https://docs.stripe.com/api/invoices/void.md) pour laquelle des crédits ont été appliqués rétablit le solde appliqué à l’octroi de crédit. Si la date d’expiration du crédit est dépassée, les crédits rétablis expirent immédiatement. - Émettre des [avoirs](https://docs.stripe.com/api/credit_notes/object.md) n’entraîne pas le remboursement des crédits appliqués à une facture. Pour rétablir ces crédits de facturation, vous devez créer un nouvel avoir. ## Limite d’octroi de crédits inutilisé Les clients peuvent disposer d’un maximum de 100 octrois de crédit non utilisés à un instant donné. Si vous émettez un nouvel octroi au-delà de cette limite, la requête échoue et renvoie un message d’erreur indiquant la limite maximale. ### Lorsqu’un octroi de crédit est non utilisé Un octroi de crédit est considéré comme non utilisé si toutes les conditions suivantes sont réunies : - L’octroi de crédit n’est pas annulé. - L’octroi de crédit n’a pas dépassé sa date [expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at). - L’octroi de crédit est soit en attente (avant [effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at)), soit associé à un [solde du grand livre](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-ledger_balance) positif. ### Lorsqu’un octroi de crédit cesse d’être considéré comme non utilisé Un octroi de crédit n’est plus pris en compte dans la limite si l’une des situations suivantes se produit : | Événement | Description | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Épuisé | Le solde du grand livre de l’octroi de crédit est nul après l’application des crédits sur une facture finalisée. | | Expiré | L’octroi de crédit arrive à échéance à la date `expires_at`, ou vous le faites expirer via l’endpoint [Expire](https://docs.stripe.com/api/billing/credit-grant/expire.md). | | Annulé | Vous annulez l’octroi de crédit via l’endpoint [Annulé](https://docs.stripe.com/api/billing/credit-grant/void.md). | ### Solde disponible et solde du grand livre La limite des octrois de crédit non utilisés est calculée sur la base du [solde du grand livre](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-ledger_balance), et non du [solde disponible](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-available_balance). Les crédits ne s’appliquent aux factures qu’au moment de leur finalisation. Par exemple, un octroi de crédit avec un solde disponible nul et un solde du grand livre positif reste pris en compte dans la limite. Si des crédits issus d’un octroi apparaissent sur une facture en brouillon, le solde disponible peut être égal à zéro, tandis que le solde du grand livre reste positif jusqu’à la finalisation de la facture. Dans ce cas, l’octroi de crédit est toujours comptabilisé dans la limite des crédits non utilisés.