Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUse Managed Payments
Build a custom integration with Elements
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Au-delà des paiements

Remarque

Cette page n'est pas encore disponible dans cette langue. Nous faisons tout notre possible pour proposer notre documentation dans davantage de langues et nous vous fournirons la version traduite dès qu'elle sera disponible.

Dynamically update payment amounts

Learn how to modify total amounts when customers change their selections during checkout.

Update the amount of a Checkout Session or Payment Intent when customers change what they’re buying or how much they pay. Recalculate the totals on your server, and then update the amount of the PaymentIntent.

Common use cases

  • Add or remove add-ons (such as gift wrap or a warranty).
  • Select a different shipping method or delivery speed.
  • Add additional services or charges.
  • Apply or remove a discount code or store credit.

Security best practices

  • Recalculate amounts on your server. Don’t trust client-provided prices or totals.
  • Authorize the update based on your business rules (for example, enforce max quantities).
  • Only update Sessions that are active and not completed or expired.

Constraints and behavior

  • You can update the amount while the Payment Intent or Checkout Session is awaiting payment (for example, requires_payment_method or requires_confirmation).
  • After confirmation, you generally can’t increase the amount.

Update the client SDK
Client-side

When using Elements with the Checkout Sessions API, wrap client calls to your server in runServerUpdate so the checkout state and totals refresh.

checkout.js
import {loadStripe} from '@stripe/stripe-js';

// Optional: include beta flags if your integration requires them
const stripe = await loadStripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
, {
  betas: ['custom_checkout_server_updates_1'],
});

const checkout = await stripe.initCheckout({
  elementsOptions: {/* ... */},
});

// Example: Add additional service using price_data
document
  .getElementById('add-service')
  .addEventListener('click', async () => {
    const updateOnServer = () =>
      fetch('/update-custom-amount', {
        method: 'POST',
        headers: {'Content-Type': 'application/json'},
        body: JSON.stringify({
          checkout_session_id: checkout.session().id,
          product_id: 'gift_wrap', // Server looks up actual price
        }),
      });

    const response = await checkout.runServerUpdate(updateOnServer);
    if (!response.ok) {
      // show error state
    }
  });

Create server endpoints
Server-side

Calculate amounts and validate inputs on your server. Then, you can update line_items with price_data to add ad-hoc charges.

Remarque

Updating the line_items or price_data recalculates the Session total and taxes.

Node
Python
No results
import express from 'express';
import Stripe from 'stripe';

const app = express();
app.use(express.json());

const stripe = new Stripe(
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'
);


// Product catalog with prices - store this securely server-side
const PRODUCTS = {
  gift_wrap: { name: 'Gift Wrap', price: 500 }, // $5.00
  express_shipping: { name: 'Express Shipping', price: 1500 }, // $15.00
  warranty: { name: 'Extended Warranty', price: 2000 }, // $20.00
};

app.post('/update-custom-amount', async (req, res) => {
  try {
    const {checkout_session_id, product_id} = req.body;

    const session = await stripe.checkout.sessions.retrieve(checkout_session_id);
    if (session.status === 'complete' || session.expires_at * 1000 < Date.now()) {
      return res.status(400).json({error: 'Session is no longer updatable.'});
    }

    // Look up product price server-side
    const product = PRODUCTS[product_id];
    if (!product) {
      return res.status(400).json({error: 'Invalid product ID'});
    }

    // Add the additional product via price_data
    const updated = await stripe.checkout.sessions.update(checkout_session_id, {
      line_items: [
        {
          price_data: {
            currency: 'usd',
            product_data: {name: product.name},
            unit_amount: product.price,
          },
          quantity: 1,
        },
      ],
    });

    return res.json({id: updated.id, amount_total: updated.amount_total});
  } catch (err) {
    return res.status(400).json({error: err.message});
  }
});

app.listen(4242, () => console.log('Server running on port 4242'));
Cette page vous a-t-elle été utile ?
OuiNon