Pular para o conteúdo principal
Pagamentos únicos permitem que você venda acesso vitalício, downloads ou serviços de uso único com uma única cobrança. Não há renovações, regras de proporcionalidade ou ciclos de faturamento. Apenas uma experiência de compra limpa e instantânea.

Chaves de Licença

Emita chaves de licença únicas após a compra.

Entrega Digital

Entregue automaticamente arquivos e conteúdo após o pagamento.

Webhooks de Pagamento

Reaja a eventos de pagamento bem-sucedido/falhado e recibos.

API de Reembolsos

Crie reembolsos totais ou parciais programaticamente.

​
O Que São Pagamentos Únicos?

Pagamentos únicos são compras fixas e antecipadas - ideais para:
  • Licenças de software: Desbloqueios vitalícios ou de versões principais
  • Downloads digitais: E‑books, templates, gráficos ou plugins
  • Serviços: Auditorias, pacotes de integração ou consultoria pontual
  • Cursos e ingressos: Cursos, workshops ou sessões ao vivo

​
Principais Benefícios

  • Checkout simples: Sem renovações ou lógica de proporcionalidade
  • Cumprimento instantâneo: Entregue licenças ou arquivos imediatamente
  • Preços flexíveis: Descontos e impostos suportados
  • Focado em desenvolvedores: APIs claras para criação, reembolsos e webhooks

​
Criando Produtos Únicos

Crie produtos no seu painel de Dodo Payments e, em seguida, venda-os via checkout hospedado, links de pagamento ou sua API.
Produtos de Pagamento Único

​
Configuração do Produto

Configure os campos no painel para definir como seu produto aparece e é vendido.

​
Detalhes do Produto

  • Nome do Produto (obrigatório): Nome exibido no checkout e nas faturas
  • Descrição do Produto (obrigatório): Declaração clara de valor que os clientes veem antes de pagar
  • Imagem do Produto (obrigatório): PNG/JPG/WebP de até 3 MB
  • Marca: Associe o produto a uma marca específica para temas e e-mails
  • Categoria de Imposto (obrigatório): Escolha a categoria correta para determinar as regras fiscais
Escolha a categoria de imposto mais precisa para garantir a correta coleta de impostos por região.

​
Preços

  • Tipo de Preço: Escolha Pagamento Único
  • Preço (obrigatório): Cobrança fixa com moeda
  • Desconto Aplicável (%): Desconto percentual opcional exibido no checkout e nas faturas
Alterar o preço do produto afeta apenas novas compras. Clientes existentes não são impactados.

​
Configurações Avançadas

  • Preços Inclusivos de Imposto: Exiba preços incluindo impostos aplicáveis
  • Gerar chaves de licença: Emita uma chave única após a compra. Veja Chaves de Licença
  • Entrega de Produto Digital: Entregue arquivos ou conteúdo automaticamente. Veja Entrega de Produto Digital
  • Metadados: Anexe pares de chave-valor personalizados para marcação interna ou integrações. Veja Metadados
Use metadados para armazenar identificadores do seu sistema (por exemplo, orderId) para reconciliar eventos e recibos posteriormente.

​
Gerenciamento de API

Use POST /checkout-sessions/create para criar cobranças únicas a partir de produtos.

Referência da API

Veja a API de criação de pagamento.
Use POST /refunds para criar reembolsos totais ou parciais.

Referência da API

Saiba como reembolsar um pagamento.
Use GET /payments para listar pagamentos e GET /payments/{payment_id} para recuperar um. Recupere itens de linha com GET /payments/{payment_id}/line-items.

Listar Pagamentos

Navegue pela API de listagem.

Obter Detalhes do Pagamento

Veja a API de recuperação.

Recuperar Itens de Linha

Inspecione os itens comprados para um pagamento.
Reaja a eventos como payment.succeeded ou payment.failed no seu backend.

Guia de Webhook

Gerencie eventos do ciclo de vida do pagamento.

​
Casos de Uso Comuns

  • Ferramentas baseadas em licença: Desbloqueie recursos com uma chave única
  • Ativos digitais: Temas, templates, conjuntos de ícones ou mídia
  • Serviços profissionais: Implementação ou configuração com taxa fixa
  • Educação: Ingressos para cursos e workshops pontuais

​
Exemplos de Integração

​
Sessões de Checkout (pagamento único)

Crie uma sessão de checkout com um produto único no carrinho: 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_one_time', quantity: 1 }
  ]
});

​
Melhores Práticas

  • Clarifique entregáveis: Diga aos compradores exatamente o que eles recebem e como é entregue
  • Entregue instantaneamente: Use chaves de licença ou entrega digital para acesso imediato
  • Rastreie com metadados: Armazene seus IDs para fácil reconciliação
Pagamentos únicos são o caminho mais rápido para vender produtos a preço fixo. Comece simples, verifique a entrega e itere sua oferta com base na conversão e feedback.