Configuration des quantités d'un abonnement

Par défaut, chaque abonnement correspond à un produit. Stripe vous permet cependant d’abonner un client à plusieurs quantités d’un même poste. Par exemple, imaginons que vous dirigez une société d’hébergement grâce à laquelle vos clients hébergent des sites pour 9,99 USD par site et par mois. La plupart des clients hébergent un seul site, mais certains en hébergent un grand nombre. Vous pourriez créer des tarifs pour un site (9,99 USD), deux sites (19,98 USD) et ainsi de suite, mais la meilleure approche consiste à abonner des clients pour une quantité donnée à un tarif unitaire de 9,99 USD.

Il existe deux types d’abonnements facturés à l’usage : la facturation à la consommation ou par utilisateur. Vous pouvez activer ces modèles de facturation en définissant la valeur de l’attribut recurring[usage_type] lors de la création d’un tarif. Vous pouvez uniquement indiquer une quantité lors de la création d’un abonnement dont le paramètre recurring[usage_type] est défini sur licensed. Si vous souhaitez une facturation détaillée pour une utilisation qui fluctue dans un intervalle de facturation, pensez à utiliser la facturation à l’usage plutôt que les quantités.

Configuration de plusieurs quantités

Pour définir la quantité d’un abonnement, fournissez une valeur à quantity lors de la création ou de la mise à jour de l’abonnement :

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_4fdAW5ftNQow1a \
  -d "items[0][price]"=price_CBb6IXqvTLXp3f \
  -d "items[0][quantity]"=5

Vous continuez néanmoins à facturer plusieurs quantités sur une même facture, et vous les calculez au prorata lorsque l’abonnement change, y compris lorsque vous modifiez les quantités pour un abonnement.

Facturation de différents montants en fonction de la quantité

Dans certains cas, vous pourriez vouloir réajuster le coût par utilisateur en fonction du nombre d’utilisateurs pour un même abonnement. Par exemple, vous pouvez proposer des réductions sur les autorisations de volume pour les abonnements qui excèdent certains seuils de quantité. Vous pouvez utiliser des niveaux pour réajuster la tarification par utilisateur.

Modification de la quantité

Lorsque vous facturez vos clients, vous pouvez effectuer un suivi de l’utilisation à différents niveaux de détail par rapport à votre facturation. Par exemple, imaginons une suite de logiciels de productivité qui facture 10 $ pour 5 utilisateurs (au maximum) utilisant le produit. Sans la modification de quantité, il est nécessaire d’augmenter la valeur quantity du poste d’abonnement de 1 pour 5 utilisateurs.

Avec le paramètre transform_quantity, vous pouvez indiquer à Stripe de modifier la quantité avant l’application du coût unitaire. L’abonnement suivant vous permet de reporter facilement le nombre actuel d’utilisateurs comme poste d’abonnement quantity. Le système de facturation de Stripe divise la quantité par 5 et arrondit avant de calculer en utilisant le coût unitaire.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Standard Cost Per 5 Users" \
  -d "transform_quantity[divide_by]"=5 \
  -d "transform_quantity[round]"=up \
  -d unit_amount=1000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=licensed \
  -d product={{PRODUCTIVITY_SUITE_ID}}

Actuellement, la seule transformation disponible est la division, à l’aide du paramètre divide_by et du paramètre round.

Vous pouvez uniquement utiliser transform_quantity avec billing_scheme=per_unit. Cette fonctionnalité est incompatible avec la tarification échelonnée.

Arrondi

Dans l’exemple précédent, l’abonnement est facturé par groupe de 5 utilisateurs en arrondissant (6 divisé par 5 génère ainsi une quantité de 2). Pour des cas d’utilisation pour lesquels vous ne souhaitez pas facturer une partie de l’utilisation, comme facturer chaque gigaoctet complet d’utilisation d’un service Internet haut débit, vous pouvez également transmettre down comme valeur de round.

Utilisation calculée

Vous pouvez également appliquer transform_quantity conjointement avec la facturation à l’usage. Cette modification s’applique aux tarifs avec recurring[usage_type]=metered à la fin d’une période de facturation, de la même façon qu’elle s’applique à quantity pour des tarifs avec recurring[usage_type]=licensed.

Le code suivant illustre l’exemple d’un service d’e-mails marketing qui crée un tarif à la consommation pour facturer 0,10 $ lorsque 1 000 e-mails ont été envoyés :

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Metered Emails" \
  -d "transform_quantity[divide_by]"=1000 \
  -d "transform_quantity[round]"=down \
  -d unit_amount=10 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d product={{MARKETING_EMAILS_ID}}

Avec cet abonnement, l’utilisation peut être rapportée par e-mail et vous pouvez facturer le client 0,10 $ chaque fois qu’il atteint 1 000 e-mails envoyés.