Skip to main content
Le blueprint Object Storage envoie un événement d’utilisation à Dodo Payments chaque fois qu’un client téléverse un fichier, avec le nombre d’octets téléversés. Un compteur Sum sur bytes additionne le volume téléversé de chaque client afin que vous puissiez le facturer. Le blueprint est fourni dans le package npm @dodopayments/ingestion-blueprints sous la forme de trackObjectStorage(), et fonctionne avec S3, Google Cloud Storage, Azure Blob Storage et d’autres services de stockage d’objets.

Cas d’utilisation

Le blueprint Object Storage convient aux scénarios suivants :

File Hosting

Facturez aux clients le volume total des fichiers qu’ils téléversent.

Backup Services

Suivez les téléversements de données de sauvegarde et facturez le volume de données téléversé.

Media CDN

Surveillez les téléversements de contenus multimédias et facturez le volume téléversé. Pour facturer la bande passante de diffusion, utilisez le blueprint Stream.

Document Management

Suivez les téléversements de documents par client pour une tarification basée sur l’utilisation.
Utilisez-le pour facturer en fonction du volume téléversé pour les services d’hébergement de fichiers, de CDN multimédia et de sauvegarde. Le blueprint comptabilise les octets téléversés, et non les octets stockés au fil du temps.

Démarrage rapide

Pour suivre les téléversements, installez le package, créez un compteur et envoyez un événement après chaque téléversement réussi.
1

Install the SDK

Installez le package Dodo Payments Ingestion Blueprints :
2

Get Your API Keys

Vous avez besoin de deux ensembles d’identifiants :
  • Clé API Dodo Payments : créez-en une sous Developer → API Keys dans le tableau de bord Dodo Payments, puis stockez-la dans DODO_PAYMENTS_API_KEY. Utilisez une clé de mode test pendant le développement. Une clé de mode test fonctionne uniquement avec test_mode.
  • Identifiants du fournisseur de stockage : les identifiants utilisés par votre SDK de stockage pour AWS S3, Google Cloud Storage, Azure Blob Storage ou un autre fournisseur.
3

Create a Meter

Dans le tableau de bord Dodo Payments, accédez à Products → Meters et cliquez sur Create Meter. Définissez les champs suivants :
  • Meter Name : un nom descriptif, tel que Storage Uploads.
  • Event Name : object_storage_upload, ou un nom de votre choix. Il doit correspondre exactement à eventName dans votre code (sensible à la casse).
  • Aggregation Type : Sum, pour additionner les octets téléversés.
  • Over Property : bytes, pour facturer en fonction de la taille du téléversement.
  • Measurement Unit : l’unité affichée sur les factures, par exemple bytes.
4

Track Storage Usage

Envoyez l’événement une fois l’appel au stockage terminé avec succès. Dans ces exemples, un téléversement échoué génère une exception avant l’exécution de trackObjectStorage(), et n’est donc pas facturé.

Configuration

Configuration de l’ingestion

Transmettez ces options à new Ingestion() :
string
requis
Votre clé API Dodo Payments provenant du tableau de bord.
string
Mode d’environnement : test_mode ou live_mode. La valeur par défaut est test_mode. Les SDK Dodo Payments utilisent par défaut live_mode à la place ; définissez donc explicitement live_mode en production.
string
requis
Nom de l’événement correspondant à Event Name de votre compteur (sensible à la casse).

Options de suivi du stockage d’objets

Transmettez ces options à trackObjectStorage() :
string
requis
Identifiant client Dodo Payments à facturer pour le téléversement, par exemple cus_123.
number
Nombre d’octets téléversés. Requis pour la facturation basée sur les octets. Si vous l’omettez, l’événement ne contient aucune valeur bytes, mais il est tout de même comptabilisé par un compteur Count.
object
Métadonnées facultatives concernant le téléversement, comme le nom du bucket ou le type de contenu. Chaque valeur doit être une chaîne, un nombre ou une valeur booléenne.

Bonnes pratiques

Suivre avant ou après le téléversement : vous pouvez suivre l’événement avant ou après le téléversement réel, selon votre stratégie de gestion des erreurs.
L’API ne dispose d’aucun endpoint permettant de supprimer un événement ingéré. Un événement envoyé avant un téléversement qui échoue ensuite reste inclus dans l’utilisation du client.
Gérer les échecs de téléversement : ne suivez que les téléversements réussis afin de ne pas facturer les opérations échouées.
Dernière modification le 26 septembre 2026