Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compteConnectez-vous
Démarrer
Paiements
Revenus
Plateformes et marketplaces
Gestion de fonds
Ressources pour les développeurs
API et SDKAide
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
Stripe pour Visual Studio Code
Terraform
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
Extensions Stripe
Créer des applications Stripe
Utiliser les applications de Stripe
Partenaires
Partner ecosystem
Certification des partenaires
États-Unis
Français (France)
AccueilRessources pour les développeursChangelogBasil2025-05-28.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.

Ajout de la prise en charge des paiements partiels sur les factures

Nouveautés

Vous pouvez désormais associer plusieurs Payment Intents à une facture. L’autorisation des paiements partiels et des paiements multiples sur les factures offre aux entreprises et aux clients une plus grande flexibilité dans la gestion des paiements et des flux de trésorerie. Nous avons également introduit le webhook invoice_payment.paid pour savoir quand un paiement associé passe à l’état paid. Pour prendre en charge l’émission d’avoirs pour des factures partiellement payées, nous avons ajouté un type mixed, un champ pre_payment_amount et un champ post_payment_amount aux objets Credit Note.

Impact

Associer plusieurs paiements à une facture

Vous pouvez désormais utiliser l’API Attach Payment pour joindre plusieurs paiements à une facture :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/invoices/{INVOICE_ID}/attach_payment \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d payment_intent={PAYMENT_INTENT_ID} \ -d "expand[]"=payments

Émettre des avoirs pour des factures partiellement payées

Vous pouvez continuer à utiliser la méthode créer un avoir pour émettre des avoirs de factures partiellement payées. Un avoir réduit d’abord les montants amount_remaining (et amount_due) de la facture, mais pas en dessous de zéro. Le champ pre_payment_amount de l’objet avoir suit cette partie. Le montant restant après avoir réduit l’amount_remaining de la facture à zéro s’applique au champ post_payment_amount de l’objet avoir. Un avoir a un type mixed si le pre_payment_amount et le post_payment_amount ne sont pas égaux à zéro.

Pour en savoir plus sur l’émission d’avoirs, consultez l’API Create Credit Notes.

Modifications

endpoint Modifierressource
attach_paymentAjouté
Invoice
paramètresModifierRessources ou endpoints
post_payment_amountpre_payment_amountAjouté
CreditNote
valeursModifierénumérations
invoice_payment.paidAjouté
Event.type
invoice_payment.paidAjouté
WebhookEndpoint#create.enabled_eventsWebhookEndpoint#update.enabled_events
mixedAjouté
CreditNote.type
ModifierEvent type
invoice_payment.paidAjouté
InvoicePayment

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-05-28.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.

Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc