Pular para o conteúdo principal
Os produtos são a base do Dodo Payments. Seja você vendendo um download único, uma assinatura recorrente ou acesso baseado em uso, você começa criando um produto. Cada produto define como ele é precificado, apresentado no checkout e cumprido após a compra.

Pagamento Único

Cobrar uma vez por acesso vitalício ou um único entregável.

Assinaturas

Fature em um cronograma com testes, prorrata e complementos.

Baseado em Uso

Meça o consumo e cobre pelo uso real.

​
Criar um produto

Você pode criar produtos a partir do painel ou via API. Escolha o modelo de precificação de antemão: Pagamento Único, Assinatura ou Baseado em Uso e, em seguida, configure os detalhes. O modelo de precificação não pode ser alterado posteriormente; crie um novo produto se precisar de um modelo diferente.
1

Nome & descrição

Forneça um título claro e uma descrição concisa orientada ao valor. Markdown é suportado nas descrições.
Mantenha a primeira frase voltada para o cliente e orientada a resultados; ela aparece de forma proeminente no checkout.
Produtos
2

Modelo de precificação & preço

Selecione o modelo de precificação:
  • Pagamento Único: Preço fixo pago uma vez.
  • Assinatura: Preço recorrente com intervalo e teste opcional.
  • Baseado em Uso: Preço derivado de eventos medidos.
Em seguida, defina os preços:
  • Preço: Valor base e moeda.
  • Desconto (%): Desconto opcional em linha mostrado no checkout e faturas.
  • Para assinaturas, defina Repetir a cada (por exemplo, 1 mês ou 1 ano) e Dias de teste se necessário.
Alterar o preço afeta apenas novas compras. Assinaturas existentes seguem as regras de alteração de plano.
3

Mídia do produto

Carregue imagens para mostrar o produto no checkout e nas faturas. PNG/JPG/WebP suportados até 3 MB. Reordene ou substitua a qualquer momento.
4

Direitos automatizados (Sob Configurações Avançadas)

Anexe o cumprimento que é ativado automaticamente após o pagamento:
  • Chaves de Licença: Emita e valide chaves únicas
  • Downloads de Arquivos: Conceda acesso seguro a arquivos
  • Personalizado: Acione sua própria lógica de direitos via webhooks
Adicione ou remova benefícios à medida que sua oferta evolui. Assinantes existentes ganham ou perdem acesso de acordo.

​
Variantes e opções de preços

Em vez de variantes sob um único produto, crie produtos separados para cada opção de preço (por exemplo, Mensal e Anual). Em seguida, agrupe-os em uma Coleção de Produtos para apresentar todas as opções em um único checkout e permitir a troca de planos no Portal do Cliente.
Coleções de Produtos

​
Por que essa abordagem?

  • Modelos de preços claros: Cada produto tem um único e bem definido modelo de preços (pagamento único, assinatura ou baseado em uso)
  • APIs previsíveis: Integrações mais simples sem lógica de variantes aninhadas
  • Relatórios mais fáceis: Rastreie receita e métricas por produto sem agregação de variantes
  • Checkout flexível: Exiba múltiplos produtos lado a lado, permitindo que os clientes comparem e escolham

​
Como funcionam as Coleções de Produtos

  1. Criar produtos: Configure produtos individuais para cada plano (por exemplo, Iniciante Mensal, Iniciante Anual, Pro Mensal, Pro Anual)
  2. Agrupar em uma coleção: Adicione produtos relacionados a uma Coleção de Produtos
  3. Checkout unificado: Os clientes veem todas as opções em um único checkout e selecionam seu plano preferido
  4. Troca de planos: Os clientes podem fazer upgrade ou downgrade entre produtos na mesma coleção através do Portal do Cliente

Coleções de Produtos

Agrupe produtos relacionados para experiências de checkout unificadas e caminhos suaves de upgrade/downgrade.

​
Gerenciando produtos

Você pode gerenciar produtos através do painel ou programaticamente via API. A API fornece controle total sobre criação, atualizações, recuperação, uploads de imagens e arquivamento de produtos.

​
Gerenciamento pelo Painel

  • Atualizar: Edite nome, descrição, imagens, preço, campos e benefícios a qualquer momento (o modelo de preços é imutável).
  • Arquivar: Oculte um produto de novas compras sem perturbar clientes existentes. Você pode desarquivar depois.

​
Gerenciamento via API

As seguintes instruções permitem criar, atualizar, gerenciar e recuperar produtos, incluindo o upload de imagens.
Um produto pode ser um item único ou um serviço baseado em assinatura. Para criar um novo produto, envie um POST request para o /products endpoint com detalhes como nome, descrição, preço, moeda e se é um produto recorrente.Para produtos recorrentes, defina recurring: true e especifique um billing_cycle (daily, weekly, monthly, yearly).

API de Criar Produto

Veja a estrutura detalhada de requisições e respostas na documentação da API de Criar Produto.
Para modificar um produto existente, envie um PATCH request para o /products/{product_id} endpoint. Você pode atualizar propriedades como nome, preço e descrição, mantendo outros detalhes inalterados.Certifique-se de que o product_id no endpoint corresponda a um produto existente.

API de Atualizar Produto

Veja a estrutura detalhada de requisições e respostas na documentação da API de Atualizar Produto.
Você pode buscar uma lista de produtos armazenados em sua conta usando um GET request para o /products endpoint. Isso permite que você recupere detalhes do produto, incluindo produtos ativos e arquivados.

API de Recuperar Produtos

Veja a estrutura detalhada de requisições e respostas na documentação da API de Recuperar Produtos.
Você pode associar uma imagem a um produto fazendo o upload para o AWS S3 usando uma URL pré-assinada fornecida pela API. Primeiro, solicite uma URL de upload de imagem do /products/{product_id}/images endpoint, e então use a URL fornecida para fazer o upload da imagem dentro de 60 segundos.
A URL pré-assinada expira em 60 segundos, então a imagem deve ser carregada dentro desse intervalo de tempo.
Uma vez que a URL pré-assinada é recebida da API, faça o upload da imagem usando o PUT método. Isso assegura acesso seguro e temporário ao AWS S3 para o upload da imagem.Bibliotecas suportadas para upload para o S3:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Se o upload for bem-sucedido, o AWS S3 retornará um 200 OK status, indicando que a imagem foi armazenada com sucesso.

API de Upload de Imagem de Produto

Veja a estrutura detalhada de requisições e respostas na documentação da API de Upload de Imagem de Produto.
Se você não deseja mais exibir ou usar um produto, pode arquivá-lo usando um POST request para o /products/{product_id}/archive endpoint. Esta ação oculta o produto, mas não o exclui permanentemente.

API de Arquivar Produto

Veja a estrutura detalhada de requisições e respostas na documentação da API de Arquivar Produto.
Se você precisar restaurar um produto arquivado, envie um POST request para o /products/{product_id}/unarchive endpoint. Isso reativará o produto e o tornará disponível para uso novamente.

API de Desarquivar Produto

Veja a estrutura detalhada de requisições e respostas na documentação da API de Desarquivar Produto.

​
Melhores práticas

  • Comece com clareza: Separe produtos para cada opção de preço (Mensal vs Anual)
  • Use testes gratuitos de forma consciente: Combine testes com integração para promover ativação
  • Automatize o cumprimento: Use benefícios e webhooks para entrega instantânea
  • Tag com metadados: Armazene seus IDs de sistema para reconciliação
Você está pronto para criar produtos e começar a vender - uma vez, recorrente ou por uso.