Skip to main content
El Object Storage Blueprint envía un evento de uso a Dodo Payments cada vez que un cliente carga un archivo, junto con el número de bytes cargados. Un medidor de tipo Sum sobre bytes suma el volumen cargado de cada cliente para que puedas facturarlo. El blueprint se incluye en el paquete npm @dodopayments/ingestion-blueprints como trackObjectStorage() y funciona con S3, Google Cloud Storage, Azure Blob Storage y otros servicios de almacenamiento de objetos.

Casos de uso

El Object Storage Blueprint es adecuado para estos escenarios:

File Hosting

Cobra a los clientes por el volumen total de archivos que cargan.

Backup Services

Realiza un seguimiento de las cargas de datos de respaldo y cobra por la cantidad de datos cargados.

Media CDN

Supervisa las cargas de contenido multimedia y factura según el volumen cargado. Para facturar el ancho de banda de entrega, usa el Stream Blueprint.

Document Management

Realiza un seguimiento de las cargas de documentos por cliente para aplicar precios basados en el uso.
Úsalo para facturar según el volumen cargado en servicios de alojamiento de archivos, CDN de contenido multimedia y copias de seguridad. El blueprint cuenta los bytes cargados, no los bytes almacenados a lo largo del tiempo.

Inicio rápido

Para realizar un seguimiento de las cargas, instala el paquete, crea un medidor y envía un evento después de cada carga correcta.
1

Install the SDK

Instala el paquete Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Necesitas dos conjuntos de credenciales:
  • Clave de API de Dodo Payments: crea una en Developer → API Keys, dentro del panel de Dodo Payments, y guárdala en DODO_PAYMENTS_API_KEY. Usa una clave de modo de prueba mientras desarrollas. Una clave de modo de prueba solo funciona con test_mode.
  • Credenciales del proveedor de almacenamiento: las credenciales que utiliza tu SDK de almacenamiento para AWS S3, Google Cloud Storage, Azure Blob Storage u otro proveedor.
3

Create a Meter

En el panel de Dodo Payments, ve a Products → Meters y haz clic en Create Meter. Configura estos campos:
  • Meter Name: un nombre descriptivo, como Storage Uploads.
  • Event Name: object_storage_upload, o el nombre que elijas. Debe coincidir exactamente con eventName en tu código (distingue entre mayúsculas y minúsculas).
  • Aggregation Type: Sum, para sumar los bytes cargados.
  • Over Property: bytes, para facturar según el tamaño de la carga.
  • Measurement Unit: la unidad que se muestra en las facturas, como bytes.
4

Track Storage Usage

Envía el evento después de que la llamada de almacenamiento se complete correctamente. En estos ejemplos, una carga fallida genera un error antes de que se ejecute trackObjectStorage(), por lo que no se factura.

Configuración

Configuración de ingestión

Pasa estas opciones a new Ingestion():
string
requerido
Tu clave de API de Dodo Payments del panel.
string
Modo de entorno: test_mode o live_mode. El valor predeterminado es test_mode. En cambio, los SDK de Dodo Payments usan live_mode de forma predeterminada, así que configura live_mode explícitamente en producción.
string
requerido
Nombre del evento que coincide con el Event Name de tu medidor (distingue entre mayúsculas y minúsculas).

Opciones de seguimiento del almacenamiento de objetos

Pasa estas opciones a trackObjectStorage():
string
requerido
El ID de cliente de Dodo Payments al que se facturará la carga, por ejemplo cus_123.
number
Número de bytes cargados. Es obligatorio para la facturación basada en bytes. Si lo omites, el evento no tendrá un valor bytes, pero seguirá contando para un medidor de tipo Count.
object
Metadatos opcionales sobre la carga, como el nombre del bucket o el tipo de contenido. Cada valor debe ser una cadena, un número o un booleano.

Prácticas recomendadas

Realiza el seguimiento antes o después de la carga: puedes realizar el seguimiento del evento antes o después de la carga real, según tu estrategia de gestión de errores.
La API no tiene ningún endpoint para eliminar un evento ingerido. Un evento enviado antes de una carga que luego falla permanece en el uso del cliente.
Gestiona los errores de carga: realiza el seguimiento únicamente de las cargas correctas para no facturar las operaciones fallidas.
Última modificación el 26 de septiembre de 2026