Products are the foundation of Dodo Payments. Whether you sell a one‑time download, a recurring subscription, or usage‑based access, you start by creating a product. Each product defines how it’s priced, presented at checkout, and fulfilled after purchase.
One‑Time
Charge once for lifetime access or a single deliverable.
Subscriptions
Bill on a schedule with trials, proration, and add‑ons.
Usage‑Based
Medir el consumo y la factura según el uso real.
Create a product
You can create products from the dashboard or via API. Choose the pricing model up‑front, One‑Time, Subscription, or Usage‑Based and then configure details. The pricing model can’t be changed later; create a new product if you need a different model.1
Name & description
Provide a clear title and a concise value‑oriented description. Markdown is supported in descriptions.
2
Pricing model & price
Select the pricing model:
- One‑Time: Fixed price paid once.
- Subscription: Recurring price with interval and optional trial.
- Usage‑Based: Price derived from metered events.
- Precio: Importe base y moneda.
- Descuento (%): Descuento opcional en línea mostrado en el pago y facturas.
- Para suscripciones, establece Repetir cada (por ejemplo, 1 mes o 1 año) y Días de prueba si es necesario. El precio de la suscripción debe ser al menos $1 (o el equivalente en la moneda elegida); los importes por debajo de este mínimo no son compatibles y la suscripción no funcionará.
3
Product media
Sube imágenes para mostrar el producto durante el pago y en las facturas. Se admiten PNG/JPG/WebP de hasta 3 MB. Reordena o reemplaza en cualquier momento.
4
Automated entitlements (Under Advanced Settings)
Adjunta cumplimiento que se activa automáticamente después del pago:
- Claves de Licencia: Emitir y validar claves únicas
- Descarga de Archivos: Otorgar acceso seguro a archivos
- Personalizado: Activar tu lógica de derechos mediante webhooks
Variantes y opciones de precios
En lugar de variantes bajo un solo producto, crea productos separados para cada opción de precio (por ejemplo, Mensual y Anual). Luego, agrúpalos en una Colección de Productos para presentar todas las opciones en un solo pago y permitir el cambio de plan en el Portal del Cliente.
¿Por qué este enfoque?
- Modelos de precios claros: Cada producto tiene un modelo de precios único y bien definido (único, suscripción, o basado en uso)
- APIs predecibles: Integraciones más simples sin la lógica de variantes anidadas
- Informes más fáciles: Seguimiento de ingresos y métricas por producto sin agregación de variantes
- Pago flexible: Mostrar múltiples productos uno al lado del otro, permitiendo a los clientes comparar y elegir
Cómo funcionan las Colecciones de Productos
- Crear productos: Configura productos individuales para cada plan (por ejemplo, Inicio Mensual, Inicio Anual, Pro Mensual, Pro Anual)
- Agrupar en una colección: Añadir productos relacionados a una Colección de Productos
- Pago unificado: Los clientes ven todas las opciones en un solo pago y seleccionan su plan preferido
- Cambio de plan: Los clientes pueden mejorar o degradar entre productos en la misma colección a través del Portal del Cliente
Product Collections
Agrupa productos relacionados para experiencias de pago unificadas y rutas de actualización/degradación sin interrupciones.
Gestión de productos
Puedes gestionar los productos a través del panel de control o programáticamente mediante la API. La API proporciona control total sobre la creación, actualizaciones, recuperación, carga de imágenes, y archivado de productos.Gestión mediante el Panel de Control
- Actualización: Edita el nombre, descripción, imágenes, precio, campos, y beneficios en cualquier momento (el modelo de precios es inmutable).
- Archivado: Oculta un producto de nuevas compras sin interrumpir a los clientes existentes. Puedes desarchivarlo más tarde.
Gestión mediante la API
Las siguientes instrucciones te permiten crear, actualizar, gestionar y recuperar productos, incluyendo la carga de imágenes.Creating a Product
Creating a Product
Un producto puede ser un artículo único o un servicio basado en suscripción. Para crear un nuevo producto, envía una solicitud
POST al endpoint /products con detalles como nombre, descripción, precio, moneda, y si es un producto recurrente.Para productos recurrentes, establece el objeto price a un precio recurrente (type: recurring_price) y especifica payment_frequency_interval e subscription_period_interval (Day, Week, Month, o Year) junto con sus cuentas correspondientes.Create Product API
Ve la estructura detallada de solicitud y respuesta en la documentación de la API de Crear Producto.
Updating a Product
Updating a Product
Para modificar un producto existente, envía una solicitud
PATCH al endpoint /products/{product_id}. Puedes actualizar propiedades como nombre, precio, y descripción mientras mantienes otros detalles sin cambios.Asegúrate de que el product_id en el endpoint coincida con un producto existente.Update Product API
Ve la estructura detallada de solicitud y respuesta en la documentación de la API de Actualización de Producto.
Retrieving Products
Retrieving Products
Puedes obtener una lista de productos almacenados en tu cuenta usando una solicitud
GET al endpoint /products. Esto te permite recuperar detalles del producto, incluyendo productos activos y archivados.Retrieve Products API
Ve la estructura detallada de solicitud y respuesta en la documentación de la API de Recuperación de Productos.
Uploading Product Images
Uploading Product Images
Puedes asociar una imagen a un producto subiéndola a AWS S3 usando una URL prefirmada proporcionada por la API. Primero, solicita una URL de carga de imagen desde el endpoint
/products/{product_id}/images, luego usa la URL proporcionada para subir la imagen dentro de 60 segundos.Una vez recibida la URL prefirmada de la API, sube la imagen usando el método PUT. Esto asegura acceso seguro y temporal a AWS S3 para subir la imagen.Librerías soportadas para subir a S3:- Node.js:
axios,node-fetch - Python:
requests,boto3 - Go:
net/http - PHP:
GuzzleHttp - Ruby:
rest-client
200 OK, indicando que la imagen se ha almacenado correctamente.Upload Product Image API
Ve la estructura detallada de solicitud y respuesta en la documentación de la API de Carga de Imagen de Producto.
Archiving a Product
Archiving a Product
Si ya no deseas mostrar o usar un producto, puedes archivarlo usando una solicitud
DELETE al endpoint /products/{id}. Esta acción oculta el producto pero no lo elimina permanentemente.Archive Product API
Ve la estructura detallada de solicitud y respuesta en la documentación de la API de Archivado de Producto.
Unarchiving a Product
Unarchiving a Product
Si necesitas restaurar un producto archivado, envía una solicitud
POST al endpoint /products/{product_id}/unarchive. Esto reactivará el producto y lo pondrá nuevamente disponible para su uso.Unarchive Product API
Ve la estructura detallada de solicitud y respuesta en la documentación de la API de Desarchivado de Producto.
Checkout & fulfillment
Checkout & fulfillment
Crea flujos de pago o suscripción a partir de productos y cumple automáticamente mediante beneficios y webhooks.
Checkout Sessions
Crea sesiones de pago para compras únicas o por suscripción.
Payment Webhooks
Reacciona a eventos del ciclo de vida del pago.
Subscription Webhooks
Maneja eventos de suscripción creados, renovados y cancelados.
Mejores prácticas
- Empieza con claridad: Separa los productos para cada opción de precio (Mensual vs Anual)
- Usa pruebas de manera juiciosa: Combina pruebas con onboarding para impulsar la activación
- Automatiza el cumplimiento: Usa beneficios y webhooks para entregar instantáneamente
- Etiquetar con metadatos: Guarda los IDs de tu sistema para la conciliación
Estás listo para crear productos y comenzar a vender - único, recurrente, o por uso.
Relacionado
Product Analytics
Rastrea ingresos, clientes, retención, suscriptores, y MRR para cada producto individual.
Localized Pricing
Establecer precios fijos por moneda o país en un producto en lugar de confiar en tasas de cambio en vivo.