Skip to main content
Produtos são a base do Dodo Payments. Seja vendendo um download único, uma assinatura recorrente ou acesso baseado em uso, você começa criando um produto. Cada produto define como é precificado, apresentado no checkout e realizado após a compra.

One‑Time

Cobre uma vez por acesso vitalício ou um único item entregue.

Subscriptions

Fature conforme cronograma com testes gratuitos, prorrata e complementos.

Usage‑Based

Medir consumo e conta 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

Name & description

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

Pricing model & price

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:
  • Price: Valor base e moeda. Você pode definir o preço base em qualquer moeda que o Dodo Payments possa cobrar, não apenas USD. Use o seletor de moedas pesquisável para encontrar uma moeda; USD, GBP, EUR e INR ficam fixadas no topo da lista.
  • Discount (%): Desconto opcional exibido inline no checkout e nas faturas.
  • Para assinaturas, defina Repeat every (por exemplo, 1 mês ou 1 ano), Trial days e um Trial amount opcional para um paid trial. O preço da assinatura deve ser de pelo menos $1 (ou o equivalente na moeda escolhida); valores abaixo desse mínimo não são compatíveis e a assinatura não funcionará.
Clientes fora da sua moeda base ainda são cobrados por meio de Adaptive Currency, para que você possa definir preços na moeda que melhor se adapta ao seu mercado sem alterar a forma como os compradores são cobrados.
Quer um preço fixo por moeda ou país em vez de uma conversão de câmbio em tempo real? Defina um pricing_mode no produto e associe regras de Localized Pricing — por exemplo, €9.99 em EUR ou ₹999 na Índia.
Alterar o preço afeta apenas novas compras. As assinaturas existentes seguem as regras de alteração de plano.
3

Product media

Envie imagens para destacar o produto no checkout e nas faturas. PNG/JPG/WebP compatíveis de até 3 MB. Reordene ou substitua a qualquer momento.
4

Automated entitlements (Under Advanced Settings)

Associe um fulfillment que seja ativado automaticamente após o pagamento:
  • License Keys: Emita e valide chaves exclusivas
  • File Downloads: Conceda acesso seguro a arquivos
  • Custom: Acione sua própria lógica de entitlement por meio de webhooks
Adicione ou remova benefícios conforme sua oferta evolui. Os assinantes existentes ganham ou perdem acesso de acordo com isso.

​
Variantes e opções de preço

Em vez de usar variantes em um único produto, crie produtos separados para cada opção de preço (por exemplo, mensal e anual). Em seguida, agrupe-os em uma Product Collection para apresentar todas as opções em um único checkout e permitir a troca de plano no Customer Portal.
Product Collections

​
Por que essa abordagem?

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

​
Como as Product Collections funcionam

  1. Crie produtos: Configure produtos individuais para cada plano (por exemplo, Starter Mensal, Starter Anual, Pro Mensal, Pro Anual)
  2. Agrupe em uma coleção: Adicione produtos relacionados a uma Product Collection
  3. Checkout unificado: Os clientes veem todas as opções em um único checkout e selecionam o plano de sua preferência
  4. Troca de plano: Os clientes podem fazer upgrade ou downgrade entre produtos da mesma coleção pelo Customer Portal

Product Collections

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

​
Gerenciamento de produtos

Você pode gerenciar produtos pelo dashboard ou programaticamente via API. A API oferece controle total sobre a criação, atualização, consulta, envio de imagens e arquivamento de produtos.

​
Gerenciamento pelo dashboard

  • Update: Edite o nome, a descrição, as imagens, o preço, os campos e os benefícios a qualquer momento (o modelo de preço é imutável).
  • Archive: Oculte um produto de novas compras sem afetar os clientes existentes. Você pode desarquivá-lo posteriormente.
  • Drafts: Um produto em andamento é salvo como rascunho para que você possa retomá-lo depois. Os rascunhos são mantidos separadamente para o test mode e o live mode, portanto, um produto inacabado em um modo nunca interfere no outro. Use Clear Draft para descartá-lo e começar novamente.
As páginas de formulário de produtos e coleções incluem botões de ação no cabeçalho, para que você possa salvar sem rolar até o final de um formulário longo.

​
Gerenciamento pela API

As instruções a seguir permitem criar, atualizar, gerenciar e consultar produtos, incluindo o envio de imagens.
Um produto pode ser um item único ou um serviço baseado em assinatura. Para criar um novo produto, envie uma solicitação POST ao endpoint /products com detalhes como nome, descrição, preço, moeda e indicação de se é um produto recorrente.Para produtos recorrentes, defina o objeto price como um preço recorrente (type: recurring_price) e especifique payment_frequency_interval e subscription_period_interval (Day, Week, Month ou Year), juntamente com suas respectivas quantidades.

Create Product API

Consulte a estrutura detalhada da solicitação e da resposta na documentação da API Create Product.
Para modificar um produto existente, envie uma solicitação PATCH ao endpoint /products/{product_id}. Você pode atualizar propriedades como nome, preço e descrição, mantendo os demais detalhes inalterados.Certifique-se de que o product_id no endpoint corresponda a um produto existente.

Update Product API

Consulte a estrutura detalhada da solicitação e da resposta na documentação da API Update Product.
Você pode obter uma lista dos produtos armazenados na sua conta usando uma solicitação GET ao endpoint /products. Isso permite recuperar detalhes dos produtos, incluindo produtos ativos e arquivados.

Retrieve Products API

Consulte a estrutura detalhada da solicitação e da resposta na documentação da API Retrieve Products.
Você pode associar uma imagem a um produto enviando-a para o AWS S3 usando uma URL pré-assinada fornecida pela API. Primeiro, solicite uma URL de envio de imagem ao endpoint /products/{product_id}/images e, em seguida, use a URL fornecida para enviar a imagem em até 60 segundos.
A URL pré-assinada expira em 60 segundos, portanto a imagem deve ser enviada dentro desse período.
Depois de receber a URL pré-assinada da API, envie a imagem usando o método PUT. Isso garante acesso seguro e temporário ao AWS S3 para o envio da imagem.Bibliotecas compatíveis para envio ao S3:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Se o envio for bem-sucedido, o AWS S3 retornará um status 200 OK, indicando que a imagem foi armazenada com sucesso.

Upload Product Image API

Consulte a estrutura detalhada da solicitação e da resposta na documentação da API Upload Product Image.
Se você não quiser mais exibir ou usar um produto, poderá arquivá-lo usando uma solicitação DELETE ao endpoint /products/{id}. Essa ação oculta o produto, mas não o exclui permanentemente.

Archive Product API

Consulte a estrutura detalhada da solicitação e da resposta na documentação da API Archive Product.
Se precisar restaurar um produto arquivado, envie uma solicitação POST ao endpoint /products/{product_id}/unarchive. Isso reativará o produto e o disponibilizará novamente para uso.

Unarchive Product API

Consulte a estrutura detalhada da solicitação e da resposta na documentação da API Unarchive Product.
Crie fluxos de pagamento ou assinatura a partir de produtos e faça o fulfillment automaticamente por meio de benefícios e webhooks.

Checkout Sessions

Crie sessões de checkout para compras únicas ou por assinatura.

Payment Webhooks

Reaja aos eventos do ciclo de vida do pagamento.

Subscription Webhooks

Gerencie eventos de criação, renovação e cancelamento de assinaturas.

​
Práticas recomendadas

  • Comece pela clareza: Separe os produtos para cada opção de preço (mensal versus anual)
  • Use trials com critério: Combine trials com onboarding para impulsionar a ativação
  • Automatize o fulfillment: Use benefícios e webhooks para entregar instantaneamente
  • Adicione metadados: Armazene os IDs do seu sistema para reconciliação
Você está pronto para criar produtos e começar a vender — de forma única, recorrente ou baseada em uso.

​
Relacionados

Product Analytics

Acompanhe a receita, os clientes, a retenção, os assinantes e o MRR de cada produto individual.

Localized Pricing

Defina preços fixos por moeda ou país para um produto, em vez de depender de taxas de câmbio em tempo real.
Última modificação em 31 de julho de 2026