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 producto, crea productos separados para cada opción de precio (por ejemplo, Mensual y Anual). Puedes presentar múltiples productos uno al lado del otro en el mismo pago y permitir que los clientes cambien entre ellos.
Esto mantiene las API predecibles y simplifica los informes. Cada producto tiene un único modelo de precios.

​
Gestión de productos

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

​
Gestión del panel de control

  • Actualizar: Edita 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 desarchivar 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 único o un servicio basado en suscripción. Para crear un nuevo producto, envía un POST a la /products 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).

Crear Producto API

Ver la estructura detallada de solicitud y respuesta en la documentación de la API Crear Producto.
Para modificar un producto existente, envía un PATCH a la /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.

Actualizar Producto API

Ver la estructura detallada de solicitud y respuesta en la documentación de la API Actualizar Producto.
Puedes obtener una lista de productos almacenados en tu cuenta usando un GET a la /products. Esto te permite recuperar detalles del producto, incluyendo productos activos y archivados.

Recuperar Productos API

Ver la estructura detallada de solicitud y respuesta en la documentación de la API Recuperar Productos.
Puedes asociar una imagen con un producto subiéndola a AWS S3 usando una URL pre-firmada proporcionada por la API. Primero, solicita una URL de carga de imagen desde el /products/{product_id}/images, luego usa la URL proporcionada para cargar la imagen dentro de los 60 segundos.
La URL pre-firmada expira en 60 segundos, por lo que la imagen debe ser cargada dentro de ese plazo.
Una vez que se recibe la URL pre-firmada de la API, carga la imagen usando 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 estado, indicando que la imagen se ha almacenado correctamente.

Cargar Imagen de Producto API

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

Archivar Producto API

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

Desarchivar Producto API

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

​
Mejores prácticas

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