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.
Preços
- Tipo de preço: Escolha Único.
- Preço (obrigatório): Cobrança fixa com moeda.
- Desconto aplicável (%): Desconto percentual opcional exibido no checkout e nas faturas.
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.
Gerenciamento via API
Create Payments
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
Refund Payments
Use
POST /refunds para criar reembolsos totais ou parciais.API Reference
Saiba como reembolsar um pagamento.
List and Retrieve Payments
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
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: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.