Saltar al contenido principal
Los productos son la base de Dodo Payments. Ya sea que vendas una descarga única, una suscripción recurrente o acceso basado en uso, comienzas creando un producto. Cada producto define cómo se precio, se presenta en el pago y se cumple después de la compra.

Una sola vez

Cobra una vez por acceso de por vida o un solo entregable.

Suscripciones

Facturación programada con pruebas, prorrateo y complementos.

Basado en uso

Mide el consumo y factura según el uso real.

​
Crear un producto

Puedes crear productos desde el panel de control o a través de la API. Elige el modelo de precios de antemano: Una sola vez, Suscripción o Basado en uso y luego configura los detalles. El modelo de precios no se puede cambiar más tarde; crea un nuevo producto si necesitas un modelo diferente.
1

Nombre y descripción

Proporciona un título claro y una descripción concisa orientada al valor. Se admite Markdown en las descripciones.
Mantén la primera oración orientada al cliente y enfocada en el resultado; aparece de manera prominente en el pago.
Productos
2

Modelo de precios y precio

Selecciona el modelo de precios:
  • Una sola vez: Precio fijo pagado una vez.
  • Suscripción: Precio recurrente con intervalo y prueba opcional.
  • Basado en uso: Precio derivado de eventos medidos.
Luego establece el precio:
  • Precio: Monto 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.
Cambiar el precio afecta solo a nuevas compras. Las suscripciones existentes siguen las reglas de cambio de plan.
3

Medios del producto

Sube imágenes para mostrar el producto en el pago y facturas. PNG/JPG/WebP soportados hasta 3 MB. Reordena o reemplaza en cualquier momento.
4

Derechos automatizados (Bajo Configuración avanzada)

Adjunta el cumplimiento que se activa automáticamente después del pago:
  • Claves de licencia: Emite y valida claves únicas
  • Descargas de archivos: Concede acceso seguro a archivos
  • Personalizado: Activa tu propia lógica de derechos a través de webhooks
Agrega o quita beneficios a medida que tu oferta evoluciona. Los suscriptores existentes ganan o pierden acceso en consecuencia.

​
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.
Colecciones de Productos

​
¿Por qué este enfoque?

  • Modelos de precios claros: Cada producto tiene un modelo de precios único y bien definido (pago único, suscripción o basado en uso)
  • APIs predecibles: Integraciones más simples sin lógica de variantes anidadas
  • Informes más fáciles: Realiza un seguimiento de los ingresos y métricas por producto sin la agregación de variantes
  • Pago flexible: Muestra múltiples productos uno al lado del otro, permitiendo a los clientes comparar y elegir

​
Cómo funcionan las Colecciones de Productos

  1. Crea productos: Configura productos individuales para cada plan (por ejemplo, Starter Mensual, Starter Anual, Pro Mensual, Pro Anual)
  2. Agrupa en una colección: Agrega productos relacionados a una Colección de Productos
  3. Pago unificado: Los clientes ven todas las opciones en un solo pago y seleccionan su plan preferido
  4. Cambio de plan: Los clientes pueden actualizar o degradar entre productos en la misma colección a través del Portal del Cliente

Colecciones de Productos

Agrupa productos relacionados para experiencias de pago unificadas y caminos de actualización/degradación sin problemas.

​
Gestión de productos

Puedes gestionar productos a través del panel o programáticamente mediante la API. La API proporciona control total sobre la creación, actualizaciones, recuperación, carga de imágenes y archivo de productos.

​
Gestión desde el Panel

  • Actualizar: Edita el nombre, descripción, imágenes, precio, campos y beneficios en cualquier momento (el modelo de precios es inmutable).
  • Archivar: Oculta un producto de nuevas compras sin interrumpir a los clientes existentes. Puedes desarchivarlo más tarde.

​
Gestión de API

Las siguientes instrucciones te permiten crear, actualizar, gestionar y recuperar productos, incluyendo la carga de imágenes.
Un producto puede ser un artículo de pago único o un servicio basado en suscripción. Para crear un nuevo producto, envía una POST solicitud al /products punto final con detalles como nombre, descripción, precio, moneda, y si es un producto recurrente.Para productos recurrentes, establece recurring: true y especifica un billing_cycle (daily, weekly, monthly, yearly).

API de Crear Producto

Consulta la estructura detallada de solicitud y respuesta en la documentación de la API de Crear Producto.
Para modificar un producto existente, envía una PATCH solicitud al /products/{product_id} punto final. Puedes actualizar propiedades como nombre, precio y descripción, mientras mantienes otros detalles sin cambios.Asegúrate de que el product_id en el punto final coincida con un producto existente.

API de Actualizar Producto

Consulta la estructura detallada de solicitud y respuesta en la documentación de la API de Actualizar Producto.
Puedes obtener una lista de productos almacenados en tu cuenta utilizando unaGET solicitud al /products punto final. Esto te permite recuperar detalles del producto, incluidos productos activos y archivados.

API de Recuperar Productos

Consulta la estructura detallada de solicitud y respuesta en la documentación de la API de Recuperar Productos.
Puedes asociar una imagen con un producto cargándola a AWS S3 utilizando una URL prefirmada proporcionada por la API. Primero, solicita una URL de carga de imagen desde el /products/{product_id}/images punto final, luego usa la URL proporcionada para cargar la imagen en un plazo de 60 segundos.
La URL prefirmada expira en 60 segundos, así que la imagen debe ser cargada dentro de ese período de tiempo.
Una vez que se recibe la URL prefirmada de la API, carga la imagen utilizando el PUT método. Esto asegura acceso seguro y temporal a AWS S3 para cargar la imagen.Bibliotecas soportadas para cargar a S3:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Si la carga es exitosa, AWS S3 devolverá un 200 OK estatus, indicando que la imagen ha sido almacenada exitosamente.

API de Cargar Imagen de Producto

Consulta la estructura detallada de solicitud y respuesta en la documentación de la API de Cargar Imagen de Producto.
Si ya no deseas mostrar o usar un producto, puedes archivarlo utilizando una POST solicitud al /products/{product_id}/archive punto final. Esta acción oculta el producto, pero no lo elimina permanentemente.

API de Archivar Producto

Consulta la estructura detallada de solicitud y respuesta en la documentación de la API de Archivar Producto.
Si necesitas restaurar un producto archivado, envía una POST solicitud al /products/{product_id}/unarchive punto final. Esto reactivará el producto y lo hará disponible para su uso nuevamente.

API de Desarchivar Producto

Consulta la estructura detallada de solicitud y respuesta en la documentación de la API de Desarchivar Producto.

​
Mejores prácticas

  • Comienza con claridad: Productos separados para cada opción de precio (Mensual vs Anual)
  • Utiliza pruebas de manera reflexiva: Combina pruebas con incorporación para impulsar la activación
  • Automatiza el cumplimiento: Utiliza beneficios y webhooks para entregar instantáneamente
  • Etiqueta con metadatos: Almacena tus IDs del sistema para reconciliación
Estás listo para crear productos y comenzar a vender - único, recurrente o por uso.