Lancer des modèles tarifaires à l’usage avec des grilles tarifairesVersion bêta privée

Indiquez un nom interne, une devise, une période de service et un régime fiscal pour créer un tarif. La période de service indique le tarif auquel un client accumule des frais. L’intervalle de facturation, c’est-à-dire la fréquence de facturation, détermine le moment où le client est facturé.

curl -X POST https://api.stripe.com/v2/billing/rate_cards \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-02-24.acacia" \
  --json '{
    "internal_name": "PAYGO rate card",
    "currency": "usd",
    "tax_behavior": "exclusive",
    "service_interval": "month",
    "service_interval_count": 1
  }'

Une fois que vous avez envoyé la demande de grille tarifaire, Stripe renvoie l’objet Rate Card actif. Vous ne pouvez pas abonner de nouveaux clients à une grille tarifaire inactive.

{
  "id": "rcd_test_61RVeJCo447E9aFii16RMt7iESSQdRfzhYKc3x1HkXDM",
  "object": "billing.rate_card",
  "active": true,
  "created": "2024-11-17T21:49:50.000Z",
  "currency": "usd",
  "internal_name": "PAYGO rate card",
  "metadata": {},
  "service_interval": "month",
  "service_interval_count": 1,
  "latest_version": "rcdv_123",
  "live_version": "rcdv_123", // defaults to first version created
  "tax_behavior": "exclusive"
}

Une fois votre une grille tarifaire créée, établissez votre tarification à l’usage et ajoutez chaque tarif à la grille.

• recurring.usage_type doit être metered.
• recurring.meter doit référencer un objet Meter pour enregistrer les événements d’utilisation.
• tax_behavior doit correspondre au tax_behavior de votre grille tarifaire.
• recurring.interval doit correspondre au service_interval de la grille tarifaire.

Ajoutez chacun de vos tarifs à la grille tarifaire à l’aide de la requête d’API suivante :

curl -X POST https://api.stripe.com/v2/billing/rate_cards/rcd_test_61RVeJCo447E9aFii16RMt7iESSQdRfzhYKc3x1HkXDM/rates \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-02-24.acacia" \
  --json {"price":"{{PRICE_ID}}"}

Avant d’abonner votre client à la grille tarifaire, définissez quand et à quelle fréquence créer des factures à l’aide d’une fréquence de facturation. Lors de la création d’une facture, le moyen de paiement par défaut du client est automatiquement débité.

Pour créer une fréquence de facturation, créez un objet Customer. Pour tester votre intégration et avancer la date et l’heure, vous pouvez créer une horloge de simulation et l’associer au client.

Le « payeur » représente l’entité qui paie chaque facture (et pas nécessairement le client qui utilise la tarification à l’usage). Pour créer un payeur pour un client, effectuez la requête suivante :

curl -X POST https://api.stripe.com/v2/billing/payers \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-02-24.acacia" \
  --json {"customer":"{{CUSTOMER_ID}}"}

Après avoir créé un payeur, établissez une fréquence de facturation adaptée. Le billing_cycle définit quand et à quelle fréquence vous facturez automatiquement le payeur. Lors de la création d’une fréquence de facturation, définissez le jour et l’heure exacts de facturation à l’aide de la requête d’API suivante :

curl -X POST https://api.stripe.com/v2/billing/cadences \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-02-24.acacia" \
  --json '{
    "payer": "{{PAYER_ID}}",
    "billing_cycle": {
        "type": "month",
        "interval_count": 1,
        "month": {
            "day_of_month": 20
        }
    }
  }'

Abonnez votre client à la grille tarifaire en transmettant cette dernière ainsi que la fréquence de facturation dans la requête suivante. Vous pouvez éventuellement transmettre une version spécifique d’une grille tarifaire lors de l’abonnement d’un client. Si vous ne spécifiez pas de version, l’abonnement applique la grille tarifaire en mode production.

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-02-24.acacia" \
  --json '{
    "rate_card": "rcd_A",
    "billing_cadence": "bc_1"
  }'

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 au client l’utilisation déclarée.

Pour tester la facturation à l’usage, envoyez des événements de compteur via le Dashboard ou l’API Stripe. Lorsque vous utilisez l’API, spécifiez l’ID client et la valeur d’utilisation dans le payload.

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

Si vous lancez une fonctionnalité qui prélève de nouveaux frais basés sur l’usage, vous pouvez créer un nouveau tarif et l’ajouter à votre grille tarifaire. Après avoir ajouté un nouveau tarif à la grille tarifaire, tous les clients existants abonnés à cette grille tarifaire peuvent commencer à utiliser cette fonctionnalité. Pour envoyer des événements de mesure sans mettre à jour l’abonnement à la grille tarifaire, ajoutez votre nouveau tarif à la grille tarifaire :

curl -X POST https://api.stripe.com/v2/billing/rate_cards/rc_1234/rates \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-02-24.acacia" \
  --json {"price":"PRICE_ID"}