Paiement Dynamique à la Caisse avec Pay What You Want

Pay What You Want (PWYW) vous permet de proposer une tarification variable pour un seul produit sans créer plusieurs entrées de produit. Vous définissez un prix minimum dans le tableau de bord, puis transmettez des montants dynamiques lors de la création des sessions de paiement, ou laissez les clients choisir leur prix. Cette approche convient aux cas suivants :

Tarification variable sans gérer plusieurs produits
Tarification définie par le client, où les acheteurs choisissent leur montant
Contrôle programmatique du prix, où vous définissez le montant via l’API
Modèles de tarification flexibles pour les produits numériques, les dons ou les lancements expérimentaux

Pay What You Want est uniquement disponible pour les produits avec paiement unique. Il ne peut pas être utilisé avec les abonnements. La devise de base du produit doit être USD, GBP ou EUR.

Prérequis

Un produit avec paiement unique et Pay What You Want activé dans le tableau de bord
L’identifiant du produit (par exemple, pdt_123abc456def)
Une clé API disponible dans Developer → API Keys

Activer Pay What You Want sur un produit

Dans le tableau de bord Dodo Payments :

Go to Products

Accédez à Products et sélectionnez le produit avec paiement unique que vous souhaitez configurer.

Enable Pay What You Want

Dans la section Pricing, activez Pay What You Want.

Set the minimum price

Saisissez le Minimum Price que les clients doivent payer. Ce champ est obligatoire.

Set a suggested price (optional)

Vous pouvez définir un Suggested Price pour guider les clients. Il n’existe aucun paramètre de prix maximum. Pour plafonner le montant facturé, appliquez cette limite dans votre propre code avant de créer la session.

Save

Cliquez sur Update Product et notez l’identifiant de votre produit afin de l’utiliser dans les sessions de paiement.

Vous trouverez l’identifiant de votre produit dans le tableau de bord, sous Products → View Details, ou en utilisant l’API List Products.

Créer une session de paiement avec un montant fixe

Lorsque vous transmettez un amount dans le panier du produit, le paiement utilise ce montant exact comme prix unitaire, à condition qu’il soit supérieur ou égal au prix minimum du produit. Le champ amount utilise la plus petite unité monétaire : centimes pour USD, pence pour GBP, centimes pour EUR. Par exemple, 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"
  }'

Le champ amount est ignoré pour les produits dont l’option Pay What You Want n’est pas activée. Il s’applique uniquement aux paiements uniques.

Laisser les clients choisir leur prix

Omettez le champ amount pour afficher un champ de saisie du prix lors du paiement. Les clients peuvent saisir tout montant supérieur ou égal au prix minimum de votre produit.

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

Utiliser des liens de paiement avec des montants dynamiques

Les liens de paiement statiques pour les produits Pay What You Want acceptent un paramètre de requête paymentAmount qui fixe le montant facturé. Contrairement à l’API Checkout Sessions, ce paramètre utilise les unités monétaires principales (par exemple, 12.5 pour $12.50).

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

paymentAmount utilise les unités monétaires principales (INLINE_CODE_PLACEHOLDER_9e7fa61a0bb9fbf5f2_END correspond à $15.00). Le champ product_cart[].amount de l’API Checkout Sessions utilise la plus petite unité monétaire (1500 correspond à $15.00). Consultez le Guide d’intégration pour plus d’informations.

Modèles courants

Tarification par segment de clientèle

Facturez des montants différents selon le type de client en utilisant le même produit :

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

Tarification basée sur la quantité

Ajustez le prix unitaire en fonction de la quantité achetée. amount correspond au prix par unité, et le total est égal à 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',
  });
}

Tarification promotionnelle

Appliquez une tarification limitée dans le temps :

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

Utilisez les métadonnées pour suivre la raison pour laquelle certains montants ont été choisis (par exemple, pricing_tier, discount_code, user_segment). Cela vous aide à analyser les tendances de tarification et le comportement des clients.

Valider les montants

Vérifiez que le montant est supérieur ou égal au prix minimum de votre produit avant de créer une session de paiement. maxAmount correspond à votre propre plafond commercial ; Dodo Payments ne dispose d’aucun paramètre de prix maximum.

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

Résolution des problèmes

Amount is being ignored

Vérifiez que :

Pay What You Want est activé pour le produit dans le tableau de bord
Le produit est un produit avec paiement unique, et non un abonnement
Le montant est au format correct (plus petite unité monétaire : centimes pour USD, pence pour GBP, centimes pour EUR)

Amount is below the minimum price

L’API rejette les sessions de paiement dont le montant est inférieur au prix minimum de votre produit. Validez les montants avant de créer les sessions ou omettez le champ amount pour permettre aux clients de choisir.

Customer can't enter their own price

Si le champ de saisie du prix n’apparaît pas, vérifiez que vous avez omis le champ amount du panier du produit. Lorsque amount est fourni, le paiement utilise ce montant exact.

Checkout Sessions API

Référence complète de l’API pour les sessions de paiement.

Checkout Sessions Guide

Découvrez les fonctionnalités avancées des sessions de paiement et les options de personnalisation.

Pay What You Want Feature

En savoir plus sur le modèle de tarification Pay What You Want.

Integration Guides

Billing Deconstructions

Cookbooks

Paiement Dynamique à la Caisse avec Pay What You Want

Prérequis

Activer Pay What You Want sur un produit

Créer une session de paiement avec un montant fixe

Laisser les clients choisir leur prix

Utiliser des liens de paiement avec des montants dynamiques

Modèles courants

Tarification par segment de clientèle

Tarification basée sur la quantité

Tarification promotionnelle

Valider les montants

Résolution des problèmes

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​Prérequis

​Activer Pay What You Want sur un produit

​Créer une session de paiement avec un montant fixe

​Laisser les clients choisir leur prix

​Utiliser des liens de paiement avec des montants dynamiques

​Modèles courants

​Tarification par segment de clientèle

​Tarification basée sur la quantité

​Tarification promotionnelle

​Valider les montants

​Résolution des problèmes

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

Prérequis

Activer Pay What You Want sur un produit

Créer une session de paiement avec un montant fixe

Laisser les clients choisir leur prix

Utiliser des liens de paiement avec des montants dynamiques

Modèles courants

Tarification par segment de clientèle

Tarification basée sur la quantité

Tarification promotionnelle

Valider les montants

Résolution des problèmes