Trackers de dépenses

Bêta publiqueLes trackers de dépenses sont actuellement en bêta publique. Des changements incompatibles peuvent survenir entre maintenant et la disponibilité générale. Veuillez contacter votre représentant Metronome pour y accéder.

Pour certains modèles de facturation, il peut être utile de suivre les dépenses d’un client au fil du temps. Ces trackers peuvent être utilisés pour informer des schémas de remise ou fournir de la visibilité au client final. Créez un spend_tracker sur le contrat pour suivre les dépenses totales pour des charges spécifiques au fil du temps.

Créer un tracker de dépenses

Les trackers de dépenses renvoient la somme des charges spécifiées sur une période de temps — spend_tracker.reset_frequency. Les trackers de dépenses peuvent être définis lors de la création d’un Package, de la création d’un contrat ou de l’édition d’un contrat. D’autres configurations sur le contrat peuvent pointer vers le tracker de dépenses pour gérer les seuils basés sur les dépenses. Par exemple, nous pouvons créer un tracker de dépenses pour plafonner le montant des achats de commits prépayés remisés qu’un client peut obtenir sur un seul mois. applicable_spend_specifiers spécifie quelles charges doivent compter par rapport au tracker de dépenses :

spend_type : aujourd’hui, seuls les achats de commits peuvent compter pour un tracker de dépenses.
sources : spécifiez si les commits créés manuellement et/ou les commits de facturation par seuil comptent pour le tracker de dépenses.
discounted : spécifiez facultativement si les commits marqués comme « discounted » comptent pour le tracker de dépenses. Pour les commits manuels, cela est défini via spend_tracker_attributes.count_as_discounted. Pour les commits de facturation par seuil, cela est défini via le discount_config.

Voir le contrat d’exemple ci-dessous :

    curl https://api.metronome.com/v1/contracts/create \
      -H "Authorization: Bearer <TOKEN>" \
      -H "Content-Type: application/json" \
      -d '{
            "customer_id": "8cecbf69-960f-4f66-9575-edebb7d95e88",
            "rate_card_id": "a7bc3775-b651-46b6-b7e4-d225a7e55c4c",
            "starting_at": "2025-04-01T00:00:00.000Z",
            ...
            "spend_trackers": [
              {
                "alias": "promo-cap",
                "credit_type_id": "usd_credit_type_id",
                "reset_frequency": "BILLING_PERIOD",
                "applicable_spend_specifiers": [
                  {
                    "spend_type": "COMMIT_PURCHASE",
                    "sources": ["THRESHOLD_RECHARGE", "MANUAL"],
                    "discounted": "DISCOUNTED_ONLY"
                  }
                ]
              }
            ],
            "prepaid_balance_threshold_configuration": {
              "commit": {
                "product_id": "d6be3bf4-1669-40c9-a8b1-388bb167ab16",
                "name": "prepaid-balance",
                "description": "threshold billing recharges"
              },
              "discount_config": {
                "fraction": 0.90,
                "cap": {
                  "spend_tracker_alias": "promo-cap",
                  "amount": 20000
                }
              },
              "is_enabled": true,
              "payment_gate_config": {
                "payment_gate_type": "STRIPE",
                  "stripe_config": {
                    "payment_type": "INVOICE"
                  }
              },
              "threshold_amount": 500,
              "recharge_to_amount": 2000
            }
          }'

Pour ce contrat, nous avons un tracker de dépenses dont la portée inclut les commits manuels et de facturation par seuil remisés. Le discount_config sur le prepaid_balance_threshold_configuration pointe vers ce tracker de dépenses pour appliquer un plafond. Lorsque le plafond est atteint, les nouveaux commits par seuil ne seront plus remisés jusqu’au début de la prochaine période de facturation.

Obtenir le total du tracker de dépenses

Une fois configuré, vous pouvez interroger le contrat pour obtenir les dépenses actuelles comptées dans le tracker pour la période en cours. Voir un exemple ci-dessous :

    curl https://api.metronome.com/v2/contracts/get \
      -H "Authorization: Bearer <TOKEN>" \
      -H "Content-Type: application/json" \
      -d '{
            "data": {
            "id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
            "customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
            ...
            "spend_trackers": [
              {
                "alias": "promo-cap",
                "credit_type_id": "usd_credit_type_id",
                "reset_frequency": "BILLING_PERIOD",
                "accumulated_spend": {
                  "amount": 14253.22,
                  "period_starting_at": "2026-05-01T00:00:00.000Z",
                  "period_ending_before": "2026-06-01T00:00:00.000Z"
                },
                "applicable_spend_specifiers": [
                  {
                    "spend_type": "COMMIT_PURCHASE",
                    "sources": ["THRESHOLD_RECHARGE", "MANUAL"],
                    "discounted": "DISCOUNTED_ONLY"
                  }
                ]
              }
            ]
          }
        }'

Bien que les trackers de dépenses puissent être utilisés pour déclencher dynamiquement certaines configurations, comme la configuration de remise de facturation par seuil illustrée ci-dessus, les utilisateurs peuvent exploiter ce tracker de dépenses pour appliquer des schémas de tarification internes. Par exemple, si vous souhaitez appliquer un plafond de dépenses pour les commits avec passerelle de paiement, vous pouvez vérifier le tracker de dépenses avant d’émettre le commit pour appliquer un plafond.

DÉMARRER

IMPLÉMENTER METRONOME

ÉVÉNEMENTS

TARIFICATION ET PACKAGING

CLIENTS ET FACTURATION

FACTURATION

RAPPORTS ET ANALYSES

CONFIGURATION DE LA PLATEFORME

Trackers de dépenses

Créer un tracker de dépenses

Obtenir le total du tracker de dépenses

​Créer un tracker de dépenses

​Obtenir le total du tracker de dépenses

Créer un tracker de dépenses

Obtenir le total du tracker de dépenses