Configurer une facturation à l’usage avec des produits et des tarifs

Les compteurs indiquent comment regrouper les événements des compteurs au cours d’une période de facturation. Les événements de mesure représentent toutes les actions effectuées par les clients dans votre système (par exemple, les requêtes d’API). Les compteurs sont associés aux prix et constituent la base de ce qui est facturé.

Pour l’exemple d’Alpaca AI, les événements de mesure correspondent au nombre de tokens qu’un client utilise lors d’une requête. Le dispositif de mesure suit la somme des tokens utilisés sur un mois.

Vous pouvez utiliser le Dashboard ou l’API Stripe pour configurer un dispositif de mesure. Pour utiliser l’API avec l’interface de ligne de commande Stripe afin de créer un dispositif de mesure, démarrez avec l’interface de ligne de commande Stripe.

curl https://api.stripe.com/v1/billing/meters \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d display_name="Alpaca AI tokens" \
  -d event_name=alpaca_ai_tokens \
  -d "default_aggregation[formula]"=sum \
  -d "customer_mapping[event_payload_key]"=stripe_customer_id \
  -d "customer_mapping[type]"=by_id \
  -d "value_settings[event_payload_key]"=value

Utilisez le Dashboard ou l’API Stripe pour créer un modèle tarifaire qui inclut vos produits et leurs options tarifaires. Les tarifs définissent le coût unitaire, la devise et le cycle de facturation.

Pour l’exemple d’Alpaca AI, créez un produit dont le tarif mesuré est de 0,04 USD par centaine d’unités, facturé mensuellement. Utilisez le dispositif que vous avez créé à l’étape précédente.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=4 \
  -d billing_scheme=per_unit \
  -d "transform_quantity[divide_by]"=100 \
  -d "transform_quantity[round]"=up \
  -d "recurring[usage_type]"=metered \
  -d "recurring[interval]"=month \
  -d "recurring[meter]"={{METER_ID}} \
  -d "product_data[name]"="Alpaca AI tokens"

Ensuite, créez un client.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="John Doe"

Subscriptions vous permet de facturer des montants récurrents en associant un client à un tarif spécifique.

Utilisez le Dashboard Stripe ou l’API pour créer un abonnement qui inclut votre client, votre produit et un tarif à l’usage.

Dans l’exemple d’Alpaca AI, vous créez un abonnement pour le produit Alpaca AI, avec un tarif mesuré de 0,04 USD par 100 unités, facturé chaque mois à John Doe.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}}

Utilisez les événements de mesure pour enregistrer l’utilisation des clients pour votre dispositif de mesure. À la fin de la période de facturation, Stripe facture l’utilisation déclarée.

Vous pouvez tester votre facturation à l’usage en envoyant un événement de mesure via le Dashboard Stripe ou l’API. Lorsque vous utilisez l’API, spécifiez l’ID du client et la valeur de payload.

Après avoir envoyé des événements de mesure, vous pouvez consulter les détails de l’utilisation de votre dispositif sur la page Dispositifs de mesure du Dashboard.

curl https://api.stripe.com/v1/billing/meter_events \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d event_name=alpaca_ai_tokens \
  -d "payload[stripe_customer_id]"={{CUSTOMER_ID}} \
  -d "payload[value]"=25

Créez un aperçu de la facture pour afficher un aperçu de la facture d’un client qui comprend des informations telles que le tarif à l’usage et la quantité utilisée.

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d subscription=
{{SUBSCRIPTION_ID}}