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

License Keys

Emita chaves de licença exclusivas após a compra.

Digital Delivery

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

Payment Webhooks

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

Refunds API

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.
One-Time Payment Products

​
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 fiscal mais precisa para garantir a cobrança correta 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) e reconciliar eventos e recibos depois.

​
Gerenciamento de API

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

API Reference

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

API Reference

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.

List Payments

Confira a API de listagem.

Get Payment Detail

Veja a API de recuperação.

Retrieve Line Items

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

Webhook Guide

Gerencie eventos de 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 com preço fixo. Comece simples, verifique a entrega e itere sua oferta com base na conversão e no feedback.