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
Ressources pour les développeurs
Aperçu
Gestion des versions
Journal des modifications
    Présentation
    Clover
    Basil
    Acacia
    Versions précédentes
Mettre à niveau votre version de l'API
Actualiser votre version du SDK
Essentials
SDK
API
Tests
CLI Stripe
Exemples de projets
Outils
Dashboard Stripe
Workbench
Dashboard des développeurs
Shell Stripe
Stripe pour Visual Studio Code
Fonctionnalités
Workflows
Destinations d'événements
Alertes d'intégrité de StripeChargements de fichiers
Solutions d'IA
Boîte à outils des agents
Modèle de protocole contextuelCréer des flux de facturation SaaS avec l’IA agentique
Sécurité et confidentialité
Sécurité
Robot d'exploration Web Stripebot
Confidentialité
Extensions Stripe
Créer des applications Stripe
Utiliser les applications de Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilRessources pour les développeursChangelogBasil2025-03-31.basil

Suppression d'objets Refund dans les flux de capture partielle et d'annulation de paiementModifications majeures

Nouveautés

Les flux suivants ne donnent plus lieu à la création d’un objet Refund associé au paiement :

  • Capture partielle
  • Annulation de paiement (manuelle ou automatisée)

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

Cette modification peut interrompre votre intégration dans les cas suivants :

  • Si votre intégration prévoit qu’une capture partielle ou une annulation de paiement crée un objet de remboursement.
  • Si votre intégration prévoit qu’une capture partielle crée deux transactions de solde.

Pour en savoir plus sur les effets possibles sur votre intégration, consultez les informations suivantes.

Impact

Cette modification affecte votre intégration si vous dépendez de l’objet Refund ou de champs associés pour les annulations de capture ou de paiement. La suppression de l’objet Refund affecte les champs ou objets suivants.

Objet Refund

  • Un objet Refund représentant l’annulation ou l’annulation de capture ne sera plus créé.
  • Il ne sera pas retourné lorsqu’il est appelé pour obtenir tous les remboursements associés au paiement ou à l’intention de paiement.
  • Il ne sera présent dans aucun événement de webhook.
  • Il ne sera pas présent sur l’objet Charge dans les réponses d’API.
  • Il ne sera pas visible dans le Dashboard.

Objet PaymentIntent

  • Une nouvelle valeur cancellation_reason appelée expired sera introduite. Cette nouvelle valeur représente les paiements annulés en raison de l’expiration de l’autorisation. Elle remplace l’ancienne valeur automatic.

Objet Charge

  • amount_captured sera égal à 0 au lieu de nil dans les flux d’annulation de paiement.
  • amount_refunded ne sera plus mis à jour par ces actions.
  • refunded ne sera plus true pour les flux d’annulation de paiement.

Autres transactions associées

  • Il n’y aura qu’une seule opération sur solde pour les captures partielles. Il n’y aura plus d’opération sur solde représentant le montant et les frais annulés.
  • L’opération sur solde représentant la capture affichera le montant capturé au lieu du montant autorisé pour le paiement correspondant.

Webhooks

  • Nous n’enverrons plus les événements charge.refunded et charge.refund.updated.
  • Nous continuerons à envoyer les événements charge.expired, charge.captured et payment_intent.canceled pour leurs flux respectifs.

Vérification de paiement Radar

  • Le cas échéant, une vérification de paiement Radar sera clôturée en cas d’annulation de paiement avec le motif canceled au lieu de refunded.

Modifications

valeursModifierénumérations
canceledAjouté
Review.closed_reason
expiredAjouté
PaymentIntent.cancellation_reason

Mise à niveau

  1. Consultez la version actuelle de votre API dans Workbench.
  2. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
    • Si vous n’utilisez pas de SDK, mettez à jour vos requêtes API pour inclure la version Stripe : 2025-03-31.basil
  3. Mettez à niveau la version de l’API utilisée pour les endpoints de webhook.
  4. Testez votre intégration avec la nouvelle version.
  5. Si vous utilisez Connect, testez votre intégration Connect.
  6. Effectuez la mise à niveau dans Workbench. Vous pourrez revenir à la version précédente pendant 72 heures.

En savoir plus sur les mises à niveau de l’API Stripe.

Changements connexes

  • Met à jour l’API Vault and Forward de manière à renvoyer un code d’état 402 pour les expirations de requêtes en amont
  • Suppression de la méthode de capture manuelle des cartes Interac
  • Après la création d’un objet Payment Method, vous ne pouvez plus modifier ses champs Naver Pay
  • Ajout de la prise en charge de Klarna dans la page de facture hébergée
  • Ajout de la possibilité de configurer des moyens de paiement enregistrés pour les paiements ponctuels sur la page de facture hébergée
  • Ajout de la prise en charge de l’enregistrement et de la réutilisation des moyens de paiement Naver Pay
  • Ajout de la prise en charge du moyen de paiement local Billie
  • Ajout de la prise en charge du moyen de paiement local Satispay
  • Rend le paramètre client facultatif pour WeChat Pay jusqu’à confirmation
  • Ajout de la prise en charge du moyen de paiement local par prélèvement automatique BECS en Nouvelle-Zélande
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