Checkout de Preços Dinâmicos com Pague o Que Quiser

Pay What You Want (PWYW) permite oferecer preços variáveis para um único produto sem criar várias entradas de produto. Você define um preço mínimo no dashboard, depois envia valores dinâmicos ao criar sessões de checkout ou permite que os clientes escolham o preço. Esta abordagem funciona para:

Preços variáveis sem gerenciar vários produtos
Preços definidos pelo cliente, permitindo que os compradores escolham o valor
Controle de preços programático, no qual você define o valor via API
Modelos de preços flexíveis para produtos digitais, doações ou lançamentos experimentais

Pay What You Want está disponível apenas para produtos com pagamento único. Ele não pode ser usado com assinaturas. A moeda base do produto deve ser USD, GBP ou EUR.

Pré-requisitos

Um produto com pagamento único e Pay What You Want ativado no dashboard
O ID do produto (por exemplo, pdt_123abc456def)
Uma chave de API em Developer → API Keys

Ativar Pay What You Want em um produto

No dashboard do Dodo Payments:

Go to Products

Navegue até Products e selecione o produto com pagamento único que deseja configurar.

Enable Pay What You Want

Na seção Pricing, ative Pay What You Want.

Set the minimum price

Insira o Minimum Price que os clientes devem pagar. Esse campo é obrigatório.

Set a suggested price (optional)

Opcionalmente, defina um Suggested Price para orientar os clientes. Não há uma configuração de preço máximo. Para limitar o valor cobrado, aplique esse limite no seu próprio código antes de criar a sessão.

Save

Clique em Update Product e anote o ID do produto para usá-lo nas sessões de checkout.

Você pode encontrar o ID do produto no dashboard em Products → View Details ou usando a List Products API.

Criar uma sessão de checkout com um valor fixo

Quando você envia um amount no carrinho do produto, o checkout usa esse valor exato como preço unitário, desde que ele seja igual ou superior ao preço mínimo do produto. O campo amount usa a menor unidade da moeda: centavos para USD, pence para GBP e centavos para EUR. Por exemplo, 1500 = $15.00 ou €15.00.

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123abc456def',
      quantity: 1,
      amount: 1500, // $15.00 in cents
    }
  ],
  return_url: 'https://yoursite.com/success',
  metadata: {
    pricing_tier: 'custom'
  }
});

console.log('Checkout URL:', session.checkout_url);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
)

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123abc456def",
            "quantity": 1,
            "amount": 1500,  # $15.00 in cents
        }
    ],
    return_url="https://yoursite.com/success",
    metadata={
        "pricing_tier": "custom"
    }
)

print(f"Checkout URL: {session.checkout_url}")

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123abc456def",
        "quantity": 1,
        "amount": 1500
      }
    ],
    "return_url": "https://yoursite.com/success"
  }'

O campo amount é ignorado para produtos sem Pay What You Want ativado. Ele se aplica apenas a pagamentos únicos.

Permitir que os clientes escolham o preço

Omita o campo amount para exibir um campo de entrada de preço no checkout. Os clientes podem inserir qualquer valor igual ou superior ao preço mínimo do produto.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123abc456def',
      quantity: 1,
      // No amount field — customer chooses
    }
  ],
  return_url: 'https://yoursite.com/success',
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123abc456def",
            "quantity": 1,
            # No amount field — customer chooses
        }
    ],
    return_url="https://yoursite.com/success",
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123abc456def",
        "quantity": 1
      }
    ],
    "return_url": "https://yoursite.com/success"
  }'

Usar Payment Links com valores dinâmicos

Payment links estáticos para produtos Pay What You Want aceitam um parâmetro de consulta paymentAmount que fixa o valor cobrado. Diferentemente da Checkout Sessions API, esse parâmetro usa unidades monetárias principais (por exemplo, 12.5 para $12.50).

https://checkout.dodopayments.com/buy/pdt_123abc456def?paymentAmount=15.00

paymentAmount usa unidades monetárias principais (15.00 é $15.00). O campo product_cart[].amount da Checkout Sessions API usa a menor unidade da moeda (1500 é $15.00). Consulte o Integration Guide para obter mais detalhes.

Padrões comuns

Preços por segmento de cliente

Cobre valores diferentes de diferentes tipos de clientes usando o mesmo produto:

async function createCheckoutForSegment(segment: string) {
  const amounts: Record<string, number> = {
    student: 1000,    // $10.00
    regular: 2500,    // $25.00
    premium: 5000,    // $50.00
  };

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123abc456def',
        quantity: 1,
        amount: amounts[segment],
      }
    ],
    return_url: 'https://yoursite.com/success',
    metadata: { segment },
  });
}

Preços baseados em quantidade

Ajuste o preço unitário com base na quantidade comprada. O amount é um preço por unidade, e o total é amount × quantity:

async function createCheckoutWithQuantity(quantity: number) {
  const basePrice = 2000; // $20.00 per unit
  let discount = 0;

  if (quantity >= 5) {
    discount = 0.20; // 20% off
  } else if (quantity >= 2) {
    discount = 0.10; // 10% off
  }

  const unitAmount = Math.round(basePrice * (1 - discount));

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123abc456def',
        quantity,
        amount: unitAmount, // Charged per unit
      }
    ],
    return_url: 'https://yoursite.com/success',
  });
}

Preços promocionais

Aplique preços por tempo limitado:

async function createCheckoutWithPromo() {
  const isPromoActive = checkIfPromotionActive(); // Your logic
  const regularPrice = 3000; // $30.00
  const promoPrice = 2000;   // $20.00

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123abc456def',
        quantity: 1,
        amount: isPromoActive ? promoPrice : regularPrice,
      }
    ],
    return_url: 'https://yoursite.com/success',
    metadata: {
      pricing_type: isPromoActive ? 'promotional' : 'regular',
    },
  });
}

Use metadata para acompanhar por que determinados valores foram escolhidos (por exemplo, pricing_tier, discount_code, user_segment). Isso ajuda a analisar padrões de preços e o comportamento dos clientes.

Validar valores

Verifique se o valor é igual ou superior ao preço mínimo do produto antes de criar uma sessão de checkout. maxAmount é o limite do seu próprio negócio; Dodo Payments não tem uma configuração de preço máximo.

async function createValidatedCheckout(
  productId: string,
  amountInCents: number,
  minAmount: number,
  maxAmount: number | null
) {
  if (amountInCents < minAmount) {
    throw new Error(
      `Amount ${amountInCents} is below minimum ${minAmount}`
    );
  }

  if (maxAmount !== null && amountInCents > maxAmount) {
    throw new Error(
      `Amount ${amountInCents} exceeds maximum ${maxAmount}`
    );
  }

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: productId,
        quantity: 1,
        amount: amountInCents,
      }
    ],
    return_url: 'https://yoursite.com/success',
  });
}

def create_validated_checkout(
    product_id: str,
    amount_in_cents: int,
    min_amount: int,
    max_amount: int | None
):
    if amount_in_cents < min_amount:
        raise ValueError(
            f"Amount {amount_in_cents} is below minimum {min_amount}"
        )

    if max_amount is not None and amount_in_cents > max_amount:
        raise ValueError(
            f"Amount {amount_in_cents} exceeds maximum {max_amount}"
        )

    return client.checkout_sessions.create(
        product_cart=[
            {
                "product_id": product_id,
                "quantity": 1,
                "amount": amount_in_cents,
            }
        ],
        return_url="https://yoursite.com/success",
    )

Solução de problemas

Amount is being ignored

Verifique se:

O produto tem Pay What You Want ativado no dashboard
O produto é um produto com pagamento único, não uma assinatura
O valor está no formato correto (menor unidade da moeda: centavos para USD, pence para GBP e centavos para EUR)

Amount is below the minimum price

A API rejeita sessões de checkout nas quais o valor é inferior ao preço mínimo do produto. Valide os valores antes de criar as sessões ou omita o campo amount para permitir que os clientes escolham.

Customer can't enter their own price

Se o campo de entrada de preço não aparecer, verifique se você omitiu o campo amount do carrinho do produto. Quando amount é informado, o checkout usa esse valor exato.

Checkout Sessions API

Referência completa da API para sessões de checkout.

Checkout Sessions Guide

Explore recursos avançados de sessões de checkout e opções de personalização.

Pay What You Want Feature

Saiba mais sobre o modelo de preços Pay What You Want.

Integration Guides

Billing Deconstructions

Cookbooks

Checkout de Preços Dinâmicos com Pague o Que Quiser

Pré-requisitos

Ativar Pay What You Want em um produto

Criar uma sessão de checkout com um valor fixo

Permitir que os clientes escolham o preço

Usar Payment Links com valores dinâmicos

Padrões comuns

Preços por segmento de cliente

Preços baseados em quantidade

Preços promocionais

Validar valores

Solução de problemas

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​Pré-requisitos

​Ativar Pay What You Want em um produto

​Criar uma sessão de checkout com um valor fixo

​Permitir que os clientes escolham o preço

​Usar Payment Links com valores dinâmicos

​Padrões comuns

​Preços por segmento de cliente

​Preços baseados em quantidade

​Preços promocionais

​Validar valores

​Solução de problemas

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

Pré-requisitos

Ativar Pay What You Want em um produto

Criar uma sessão de checkout com um valor fixo

Permitir que os clientes escolham o preço

Usar Payment Links com valores dinâmicos

Padrões comuns

Preços por segmento de cliente

Preços baseados em quantidade

Preços promocionais

Validar valores

Solução de problemas