Checkout con Prezzi Dinamici e Paga Quanto Vuoi

Pay What You Want (PWYW) ti consente di offrire prezzi variabili per un singolo prodotto senza creare più voci di prodotto. Imposti un prezzo minimo nel dashboard, quindi passi importi dinamici durante la creazione delle sessioni di checkout oppure lasci che siano i clienti a scegliere il prezzo. Questo approccio è adatto per:

Prezzi variabili senza dover gestire più prodotti
Prezzi determinati dal cliente, in cui gli acquirenti scelgono l’importo
Controllo programmatico dei prezzi, in cui imposti l’importo tramite API
Modelli di prezzo flessibili per prodotti digitali, donazioni o lanci sperimentali

Pay What You Want è disponibile solo per prodotti con pagamento una tantum. Non può essere utilizzato con gli abbonamenti. La valuta di base del prodotto deve essere USD, GBP o EUR.

Prerequisiti

Un prodotto con pagamento una tantum e Pay What You Want abilitato nel dashboard
L’ID del prodotto (ad esempio, pdt_123abc456def)
Una chiave API disponibile in Developer → API Keys

Abilitare Pay What You Want su un prodotto

Nel dashboard di Dodo Payments:

Go to Products

Vai su Products e seleziona il prodotto con pagamento una tantum che vuoi configurare.

Enable Pay What You Want

Nella sezione Pricing, attiva Pay What You Want.

Set the minimum price

Inserisci il Minimum Price che i clienti devono pagare. È obbligatorio.

Set a suggested price (optional)

Facoltativamente, imposta un Suggested Price per orientare i clienti. Non esiste un’impostazione per il prezzo massimo. Per limitare l’importo addebitato, applica il limite nel tuo codice prima di creare la sessione.

Save

Fai clic su Update Product e annota l’ID del prodotto da utilizzare nelle sessioni di checkout.

Puoi trovare l’ID del prodotto nel dashboard, in Products → View Details, oppure utilizzando l’API List Products.

Creare una sessione di checkout con un importo fisso

Quando passi un amount nel carrello del prodotto, il checkout utilizza esattamente quell’importo come prezzo unitario, purché sia uguale o superiore al prezzo minimo del prodotto. Il campo amount utilizza l’unità minima della valuta: centesimi per USD, penny per GBP, centesimi per EUR. Ad esempio, 1500 = $15.00 o €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"
  }'

Il campo amount viene ignorato per i prodotti senza Pay What You Want abilitato. Si applica solo ai pagamenti una tantum.

Lasciare che siano i clienti a scegliere il prezzo

Ommetti il campo amount per visualizzare un campo di inserimento del prezzo nel checkout. I clienti possono inserire qualsiasi importo uguale o superiore al prezzo minimo del prodotto.

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"
  }'

Utilizzare Payment Links con importi dinamici

I link di pagamento statici per i prodotti Pay What You Want accettano un parametro di query paymentAmount che fissa l’importo addebitato. A differenza dell’API Checkout Sessions, questo parametro utilizza le unità principali della valuta (ad esempio, 12.5 per $12.50).

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

paymentAmount utilizza le unità principali della valuta (15.00 è $15.00). Il campo dell’API Checkout Sessions product_cart[].amount utilizza l’unità minima della valuta (1500 è $15.00). Consulta la Integration Guide per ulteriori dettagli.

Modelli comuni

Prezzi a livelli per segmento di clientela

Addebita importi diversi a diversi tipi di clienti utilizzando lo stesso prodotto:

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 },
  });
}

Prezzi basati sulla quantità

Modifica il prezzo unitario in base alla quantità acquistata. amount è un prezzo per unità e il totale è 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',
  });
}

Prezzi promozionali

Applica prezzi con validità limitata nel tempo:

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',
    },
  });
}

Utilizza i metadati per tenere traccia del motivo per cui sono stati scelti importi specifici (ad esempio, pricing_tier, discount_code, user_segment). Questo ti aiuta ad analizzare i modelli di prezzo e il comportamento dei clienti.

Convalidare gli importi

Verifica che l’importo sia uguale o superiore al prezzo minimo del prodotto prima di creare una sessione di checkout. maxAmount è il limite aziendale che definisci tu; Dodo Payments non dispone di un’impostazione per il prezzo massimo.

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",
    )

Risoluzione dei problemi

Amount is being ignored

Verifica che:

Il prodotto abbia Pay What You Want abilitato nel dashboard
Il prodotto sia un prodotto con pagamento una tantum, non un abbonamento
L’importo sia nel formato corretto (unità minima della valuta: centesimi per USD, penny per GBP, centesimi per EUR)

Amount is below the minimum price

L’API rifiuta le sessioni di checkout in cui l’importo è inferiore al prezzo minimo del prodotto. Convalida gli importi prima di creare le sessioni oppure ometti il campo amount per consentire ai clienti di scegliere.

Customer can't enter their own price

Se il campo di inserimento del prezzo non viene visualizzato, assicurati di aver omesso il campo amount dal carrello del prodotto. Quando amount viene fornito, il checkout utilizza esattamente quell’importo.

Checkout Sessions API

Riferimento completo dell’API per le sessioni di checkout.

Checkout Sessions Guide

Scopri le funzionalità avanzate delle sessioni di checkout e le opzioni di personalizzazione.

Pay What You Want Feature

Scopri di più sul modello di prezzo Pay What You Want.

Integration Guides

Billing Deconstructions

Cookbooks

Checkout con Prezzi Dinamici e Paga Quanto Vuoi

Prerequisiti

Abilitare Pay What You Want su un prodotto

Creare una sessione di checkout con un importo fisso

Lasciare che siano i clienti a scegliere il prezzo

Utilizzare Payment Links con importi dinamici

Modelli comuni

Prezzi a livelli per segmento di clientela

Prezzi basati sulla quantità

Prezzi promozionali

Convalidare gli importi

Risoluzione dei problemi

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​Prerequisiti

​Abilitare Pay What You Want su un prodotto

​Creare una sessione di checkout con un importo fisso

​Lasciare che siano i clienti a scegliere il prezzo

​Utilizzare Payment Links con importi dinamici

​Modelli comuni

​Prezzi a livelli per segmento di clientela

​Prezzi basati sulla quantità

​Prezzi promozionali

​Convalidare gli importi

​Risoluzione dei problemi

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

Prerequisiti

Abilitare Pay What You Want su un prodotto

Creare una sessione di checkout con un importo fisso

Lasciare che siano i clienti a scegliere il prezzo

Utilizzare Payment Links con importi dinamici

Modelli comuni

Prezzi a livelli per segmento di clientela

Prezzi basati sulla quantità

Prezzi promozionali

Convalidare gli importi

Risoluzione dei problemi