Crédits de facturationVersion bêta publique
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 :
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 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 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, 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 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. Les crédits n’expireront que si vous définissez ce champ. |
Annulé | Vous pouvez uniquement annuler 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 de la facture est égale ou postérieure à la valeur effective_at de l’octroi de crédit.
- La valeur
period_
de la facture est antérieure à l’horodatage expires_at de l’octroi de crédit, s’il est défini.end - 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 et qui rendent compte de leur usage à l’aide de dispositifs de mesure.
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.
- One-time invoice items which are added to a subscription’s previewed invoice, such as an initial setup fee.
- Postes sur les factures d’abonnement qui utilisent des tarifs sous licence.
- Postes sur les factures d’abonnement qui utilisent des tarifs à la consommation, mais qui rendent compte de l’usage à l’aide des anciens enregistrements d’utilisation.
Appliquer des octrois de crédit
Vous pouvez appliquer des octrois de crédit aux postes d’abonnement qui sont liés à un tarif à l’usage. Les octrois de crédit s’appliquent aux factures après remises, mais avant les taxes et le 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 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 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 :
- Priorité : les octrois de crédits à la priorité plus élevée (un nombre plus faible indique une priorité plus élevée) s’appliquent en premier.
- Date d’expiration : les octrois de crédit dont l’horodatage expires_at est antérieur s’appliquent en premier.
- Catégorie : les crédits de la catégorie
promotional
sont utilisés en priorité. - Date d’entrée en vigueur : les octrois de crédit dont l’horodatage effective_at est antérieur sont utilisés en priorité.
- Date de création : les octrois de crédit dont l’horodatage de création est antérieur sont utilisés en priorité.
Preview, draft, or finalized invoices
Credits apply to invoices only at the time of finalization. If you apply credits to a preview or draft invoice, those credits might change if a finalized invoice uses them first.
Example 1: At the end of a cycle, the same set of credits appear on both a draft invoice and a preview invoice. When finalized, the draft invoice uses the credits. The preview invoice adjusts to accurately reflect any remaining credits from the credit grant.
Example 2: A customer has multiple active subscriptions and the same set of credits appear on a preview invoice for all of the subscriptions. If there aren’t enough credits to apply to all the subscriptions when the invoices finalize, only some invoices receive the credits. If you use billing thresholds, they might trigger later than expected because of the credits that apply to multiple preview invoices.
Récapitulatifs et transactions du solde créditeur
Credit Balance Summary 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 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 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 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.
Unused credit grants limit
Customers can have up to 20 unused credit grants at a time. If you issue a credit grant after this limit, the request fails with an error message stating the max limit. A credit grant is unused if it has a future effective date or a positive balance.