> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagamentos Únicos

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

<Info>
  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.
</Info>

<CardGroup cols={2}>
  <Card title="License Keys" icon="code" href="/features/license-keys">
    Emita chaves de licença exclusivas após a compra.
  </Card>

  <Card title="Digital Delivery" icon="code" href="/features/digital-product-delivery">
    Entregue arquivos e conteúdos automaticamente após o pagamento.
  </Card>

  <Card title="Payment Webhooks" icon="code" href="/developer-resources/webhooks/intents/payment">
    Reaja aos eventos de pagamento bem-sucedido/falhado e recibos.
  </Card>

  <Card title="Refunds API" icon="code" href="/api-reference/refunds/post-refunds">
    Crie reembolsos totais ou parciais programaticamente.
  </Card>
</CardGroup>

## 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.

<Frame>
  <img src="https://mintcdn.com/dodopayments/r-ndtvzx3WhKqwER/images/products.png?fit=max&auto=format&n=r-ndtvzx3WhKqwER&q=85&s=fb41221c4f2af4de0155e71de1ac6904" alt="Produtos de Pagamento Único" style={{ maxHeight: '500px', width: 'auto' }} width="1911" height="927" data-path="images/products.png" />
</Frame>

### 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

<Tip>
  Escolha a categoria fiscal mais precisa para garantir a cobrança correta de impostos por região.
</Tip>

#### Preços

* **Tipo de Preço**: Escolha <b>Pagamento Único</b>
* **Preço** (obrigatório): Cobrança fixa com moeda
* **Desconto Aplicável (%)**: Desconto percentual opcional exibido no checkout e nas faturas

<Warning>
  Alterar o preço do produto afeta apenas novas compras. Clientes existentes não são impactados.
</Warning>

#### 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 <a href="/features/license-keys">Chaves de Licença</a>
* **Entrega de Produto Digital**: Entregue arquivos ou conteúdo automaticamente. Veja <a href="/features/digital-product-delivery">Entrega de Produto Digital</a>
* **Metadados**: Anexe pares de chave-valor personalizados para marcação interna ou integrações. Veja <a href="/api-reference/metadata">Metadados</a>

<Tip>
  Use metadados para armazenar identificadores do seu sistema (por exemplo, orderId) e reconciliar eventos e recibos depois.
</Tip>

## Gerenciamento de API

<AccordionGroup>
  <Accordion title="Create payments">
    Use `POST /checkouts` para criar cobranças únicas a partir de produtos.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      Veja a API de criação de pagamento.
    </Card>
  </Accordion>

  <Accordion title="Refund payments">
    Use `POST /refunds` para criar reembolsos totais ou parciais.

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      Saiba como reembolsar um pagamento.
    </Card>
  </Accordion>

  <Accordion title="List and retrieve payments">
    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`.

    <Card title="List Payments" icon="code" href="/api-reference/payments/get-payments">
      Confira a API de listagem.
    </Card>

    <Card title="Get Payment Detail" icon="code" href="/api-reference/payments/get-payments-1">
      Veja a API de recuperação.
    </Card>

    <Card title="Retrieve Line Items" icon="code" href="/api-reference/payments/retrieve-line-items">
      Inspecione os itens adquiridos de um pagamento.
    </Card>
  </Accordion>

  <Accordion title="Payment webhooks">
    Reaja a eventos como payment.succeeded ou payment.failed no seu backend.

    <Card title="Webhook Guide" icon="code" href="/developer-resources/webhooks/intents/payment">
      Gerencie eventos de ciclo de vida do pagamento.
    </Card>
  </Accordion>
</AccordionGroup>

## 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:

```typescript theme={null}
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

<Info>
  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.
</Info>