Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Outils de développement
Aperçu
Gestion des versions
Journal des modifications
    Présentation
    Basil
    Acacia
    Versions précédentes
Mettre à niveau votre version de l'API
Actualiser votre version du SDK
Outils de développement
SDK
API
Tests
Workbench
Destinations d'événements
Workflows
CLI Stripe
Shell Stripe
Dashboard des développeurs
Boîte à outils des agents
Intégrer des LLMStripe pour Visual Studio CodeAlertes d'intégrité de StripeChargements de fichiers
Sécurité et confidentialité
Sécurité
Confidentialité
Extensions Stripe
Stripe Apps
Connecteurs Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilOutils de développementChangelogBasil2025-03-31.basil

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.

Updates the Vault and Forward API to return a 402 status code for upstream request timeoutsBreaking changes

What’s new

The Vault and Forward API now returns a 402 error instead of 502 and 504 errors for specific scenarios.

Why is this a breaking change?

Some users might expect either 502 or 504 statuses for upstream errors. Update your code to expect 402 statuses as well.

Impact

Previously, the Vault and Forward API returned a 502 or 504 error for any errors with the upstream destination endpoint, regardless of connection status. Now, you receive a 402 error if a request times out before Stripe establishes a connection with the upstream, allowing for safe retries. Stripe continues returning 502 or 504 errors for all other upstream errors.

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Removes manual capture method for Interac cards
  • Payment Methods won’t allow modifying fields for Naver Pay after the object is first created
  • Partially capturing or canceling payments no longer creates a Refund
  • Adds support for Klarna in the Hosted Invoice Page
  • Adds ability to configure saved payment methods for one-time payments on the Hosted Invoice Page
  • Adds support for saving and reusing Naver Pay payment methods
  • Adds support for the Billie local payment method
  • Adds support for the Satispay local payment method
  • Makes the client parameter optional for WeChat Pay until confirmation
  • Adds support for the New Zealand BECS Direct Debit local payment method
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc