Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous

Mise à jour de initCheckout pour qu'il soit synchroneModifications majeures

Nouveautés

La méthode stripe.initCheckout est désormais synchrone au lieu d’être asynchrone.

Pourquoi s’agit-il d’une modification majeure ?

Ce changement majeur vous concerne si votre intégration utiliseElements avec l’API Checkout Sessions.

Pour migrer, vous devez :

  1. Supprimez tous les appels await ou .then() associés à initCheckout.
  2. Remplacez votre fonction fetchClientSecret par une chaîne clé secrète du client ou une Promise qui aboutit à une chaîne clé secrète du client.
  3. Appelez la nouvelle fonction asynchrone checkout.loadActions() sur commande pour accéder à des actions telles que getSession(), qui remplace session(), ou confirm(). Vous n’avez besoin d’appeler loadActions() qu’une seule fois.
  4. Si vous avez précédemment intégré initCheckout dans un bloc try...catch, vous devez plutôt examiner la valeur type résolue de loadActions() pour vérifier des erreurs.
const clientSecret = fetch("/create-checkout-session", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
})
  .then((r) => r.json())
  .then((r) => r.clientSecret);

const checkout = await stripe.initCheckout({
  fetchClientSecret: () => clientSecret
});
const checkout = stripe.initCheckout({
  clientSecret
});
const paymentElement = checkout.createPaymentElement();
paymentElement.mount("#payment-element");

const session = checkout.session();
const loadActionsResult = await checkout.loadActions();
if (loadActionsResult.type === 'success') {
  const session = loadActionsResult.actions.getSession();
}

Impact

La nature synchrone d’initCheckout vous permet de monter Elements plus tôt, ce qui réduit la latence de rendu de tous les Elements que vous montez immédiatement après initCheckout. Cela permet également à Elements d’afficher l’interface utilisateur du chargeur de squelette après son montage, mais avant que l’état de la session ne soit entièrement chargé.

Modifications connexes