Guide de migration de l’en-tête bêta

Comment ne plus utiliser l’en-tête bêta de l’API pour les prélèvements automatiques BECS en Nouvelle-Zélande.

Les prélèvements automatiques BECS néo-zélandais sont mis à la disposition du public. Nous avons besoin que les utilisateurs de la version bêta cessent de transmettre l’en-tête bêta de l’API. Ce guide passe en revue les modifications requises pour la migration.

Étape 1 - Stripe.js - Modifications à venir le 31 mars 2025

Le 31 mars 2025, Stripe modifiera le cycle de publication de stripe.js. À l’heure actuelle, nous ne disposons que d’une seule version de stripe.js, à savoir v3. Désormais, stripe.js suivra un cycle de publication mensuel, coordonné avec le cycle de publication de l’API.

Chaque version mensuelle de stripe.js est liée à la version mensuelle de l’API qui est publiée en même temps. Par exemple, la version 2025-03-31.basil de stripe.js utilise la version 2025-03-31.basil de l’API.

Cela signifie également que vous ne pourrez plus transmettre d’en-têtes bêta de l’API lors de l’initialisation de stripe.js.

Modifications requises

Lorsque vous utilisez stripe.js v3, vous devez transmettre à la fois l’indicateur nz_bank_account_beta_2 bêta de front-end et l’en-tête nz_bank_account_beta=v2 bêta de l’API.

Lors de la mise à niveau vers stripe.js version 2025-03-31.basil, vous devez cesser de transmettre à la fois l’indicateur bêta de front-end et l’en-tête bêta de l’API.

checkout.js
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: ['nz_bank_account_beta_2'],
  apiVersion: "2025-05-28.basil;nz_bank_account_beta=v2"
});

Étape 2 - API et SDK - Modifications requises d’ici le 30 juin 2025

Le 31 mars 2025, dans la version 2025-03-31.basil de l’API, Stripe mettra le moyen de paiement nz_bank_account à la disposition du public.

Cela signifie qu’il n’est plus nécessaire de transmettre l’en-tête bêta de l’API pour accéder au moyen de paiement nz_bank_account.

Stripe demande aux utilisateurs de la version bêta de cesser de transmettre l’en-tête bêta d’ici le 30 juin 2025.

Modifications requises

Vous devez arrêter de transmettre l’en-tête bêta dans toutes les requêtes à tous les endpoints - /v1/payment_intents, /v1/setup_intents, /v1/checkout/sessions, /v1/customers, et ainsi de suite

Command Line
curl https://api.stripe.com/v1/payment_intents \
-u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
-H "Stripe-Version: 2025-05-28.basil;nz_bank_account_beta=v2"
-d amount=1099 \
-d currency=eur