Pagamentos únicos

Venda bens ou serviços digitais com preço fixo usando uma única cobrança antecipada, sem renovações.

Os 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 proporcional ou ciclos de cobrança.

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 a eventos de pagamento bem-sucedido e malsucedido.

Refunds API

Crie reembolsos totais ou parciais programaticamente.

​

O Que São Pagamentos Únicos?

Os 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, modelos, gráficos ou plugins.
• Serviços: Auditorias, pacotes de onboarding ou consultorias pontuais.
• Cursos e ingressos: Cursos, workshops ou sessões ao vivo.

​

Principais Benefícios

• Checkout simples: Sem renovações ou lógica de rateio proporcional.
• Atendimento instantâneo: Entregue licenças ou arquivos imediatamente.
• Preços flexíveis: Descontos e impostos compatíveis.
• Foco no desenvolvedor: 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.

​

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 de exibição mostrado no checkout e nas faturas.
• Descrição do produto: Declaração clara de valor que os clientes veem antes de pagar.
• Imagem do produto: PNG, JPG ou WebP de até 3 MB.
• Marca: Associe o produto a uma marca específica para personalização visual e e-mails.
• Categoria fiscal (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 Uma vez.
• Preço (obrigatório): Cobrança fixa com moeda.
• Desconto aplicável (%): Desconto percentual opcional exibido no checkout e nas faturas. Você pode inserir até duas casas decimais, como 10.5. Na API, use discount_bps (basis points, portanto 1050 corresponde a 10,5%).

Alterar o preço do produto afeta apenas novas compras. Os clientes existentes não são afetados.

​

Configurações avançadas

Essas configurações opcionais estão nas seções Pricing, Entitlements e Meta Data do formulário do produto:

• Tax Inclusive Pricing (em Pricing): exiba os preços incluindo os impostos aplicáveis.
• License key (em Entitlements): emita uma chave exclusiva após a compra. Consulte License Keys.
• Digital Files (em Entitlements): entregue arquivos ou conteúdo automaticamente. Consulte Digital Product Delivery.
• Meta Data: anexe pares de chave-valor personalizados para marcação interna ou integrações. Consulte Metadata.

Use metadados para armazenar identificadores do seu sistema (por exemplo, orderId) e reconciliar eventos e recibos posteriormente.

​

Gerenciamento via API

Create Payments

Use POST /checkouts para criar uma sessão de checkout que coleta um pagamento único pelos seus produtos.

API Reference

Consulte a API de criação de pagamentos.

Refund Payments

Use POST /refunds para criar reembolsos totais ou parciais.

API Reference

Saiba como reembolsar um pagamento.

List and Retrieve Payments

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

List Payments

Navegue pela API de listagem.

Get Payment Detail

Consulte a API de recuperação.

Retrieve Line Items

Inspecione os itens comprados de um pagamento.

Payment Webhooks

Reaja a eventos como payment.succeeded ou payment.failed no seu backend.

Webhook Guide

Gerencie eventos do ciclo de vida do pagamento.

​

Casos de uso comuns

• Ferramentas baseadas em licenças: Desbloqueie recursos com uma chave única.
• Ativos digitais: Temas, modelos, conjuntos de ícones ou mídia.
• Serviços profissionais: Implementação ou configuração com preço fixo.
• 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: 'pdt_one_time', quantity: 1 }
  ]
});

​

Práticas recomendadas

• Esclareça as entregas: Informe aos compradores exatamente o que receberão e como será entregue.
• Entregue instantaneamente: Use chaves de licença ou entrega digital para fornecer acesso imediato.
• Acompanhe com metadados: Armazene seus IDs para facilitar a reconciliação.