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

# Preços Pague o Que Quiser

> Deixe os clientes escolherem seu preço acima de um mínimo. Opcionalmente, mostre um preço sugerido. Otimizado para compras únicas.

**Pague o Que Quiser (PWYW)** permite que os clientes decidam quanto pagam—no mínimo definido pelo comerciante. Isso aumenta o engajamento, incentiva o apoio da comunidade e fornece preços flexíveis para produtos digitais.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/Lh0Q01b33NY" title="Pay What You Want Pricing | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

## O Que É Pague o Que Quiser?

PWYW é um modelo de precificação onde os clientes definem seu próprio preço dentro dos limites que você define. É ideal para:

* **Produtos e mídias digitais**: Modelos, e‑books, cursos, plugins
* **Lançamentos experimentais**: Acesso antecipado, lançamentos beta, promoções com tempo limitado
* **Pacotes e extras**: Adicione um nível PWYW para aumentar a participação

## Principais Benefícios

* **Precificação orientada pelo cliente**: Compradores escolhem o que pagam
* **Piso de receita**: Imponha um mínimo para proteger as margens
* **Expectativas ancoradas**: Preço sugerido opcional para guiar as escolhas
* **Checkout sem costura**: Checkout hospedado e recibos gerenciados para você
* **Focado no desenvolvedor**: APIs claras para criação, reembolsos e webhooks

<Warning>
  PWYW está disponível apenas para produtos **Pagamento Único** (uma única vez).
</Warning>

## Criando Pague o Que Quiser

Crie um produto de uma única vez e ative PWYW no seu painel do Dodo Payments. As seções abaixo mapeiam diretamente para o formulário de criação.

### Criação de Produto

#### 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 Fiscal** (obrigatório): Escolha a categoria correta para determinar as regras fiscais

<Tip>
  Escolha a categoria tributária 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>
* **Pague o Que Quiser** (alternar): Ative para permitir que os compradores escolham o valor
* **Preço Mínimo** (obrigatório): Valor mais baixo que um cliente pode pagar
* **Preço Sugerido** (opcional): Valor recomendado exibido na página do produto

<Tip>
  Use metadados para armazenar identificadores do seu sistema (por exemplo, orderId) para que possa conciliar eventos e recibos posteriormente.
</Tip>

## Gerenciamento de API

<AccordionGroup>
  <Accordion title="Create checkout sessions (PWYW)">
    Use `POST /checkouts` para criar sessões de checkout únicas a partir de produtos. O checkout solicitará que os compradores insiram um valor que atenda ao seu mínimo PWYW.

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

  <Accordion title="Refund payments">
    Use `POST /refunds` para criar reembolsos totais ou parciais. Os clientes recebem exatamente o valor pago.

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

  <Accordion title="List and retrieve">
    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">
      Explore 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 comprados 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">
      Trate eventos do ciclo de vida de pagamentos.
    </Card>
  </Accordion>
</AccordionGroup>

## Casos de Uso Comuns

* **Ativos digitais**: Temas, modelos, conjuntos de ícones, mídias ou plugins
* **Conteúdo e educação**: E‑books, cursos, workshops com preços para apoiadores
* **Comunidade e doações**: Arrecadações, patrocínios de código aberto, apoio a criadores
* **Experimentos de lançamento**: Acesso beta e campanhas com tempo limitado para avaliar a demanda

## Exemplos de Integração

### Sessões de Checkout (pagamento único, PWYW)

Adicione um produto PWYW ao carrinho. O checkout coleta o valor do comprador (respeitando seu mínimo) — nenhum campo extra é necessário.

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_pwyw_demo', quantity: 1 }
  ],
  return_url: 'https://yoursite.com/checkout/success'
});
```

## Melhores Práticas

* **Escolha um mínimo sensato**: Cubra custos enquanto mantém a participação fácil
* **Use um preço sugerido**: Ancore expectativas para melhorar o valor médio do pedido
* **Explique o valor claramente**: Diga aos compradores o que a contribuição deles desbloqueia
* **Teste campanhas A/B**: Ofertas com tempo limitado e experimente com mensagens
* **Monitore a distribuição**: Acompanhe os valores pagos para refinar o mínimo e o preço sugerido

<Info>
  PWYW é uma maneira flexível de atrair mais clientes enquanto preserva um piso de receita. Comece simples, teste exaustivamente e itere com base na conversão, na distribuição de contribuições e nas taxas de reembolso.
</Info>
