Ajout de la prise en charge de paiements multiples (partiels) sur les facturesModifications majeures

Nouveautés

Nous introduisons la prise en charge de paiements multiples (partiels) sur les factures et les avoirs. Les factures permettent également de suivre les trop-perçus et peuvent désormais suivre les paiements effectués en dehors de Stripe. De plus, nous ajoutons un champ confirmation_secret sur l’objet Invoice afin d’améliorer la prise en charge de l’utilisation de Payment Element.

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

• Suppression des champs payment_intent, charge, paid et paid_out_of_band de l’objet Invoice.
• Suppression du champ invoice des objets Payment Intent et Charge.
• Le champ refund de l’objet Credit Note a été supprimé et remplacé par un tableau refunds
• Le champ amount_paid de l’objet Invoice reflète désormais les paiements effectués en dehors de Stripe.

Impact

Nous avons introduit l’objet Invoice Payment pour représenter le lien entre les paiements et les factures, et nous avons supprimé les pointeurs de facture et de paiement précédents sur les objets pertinents. Veillez à mettre à jour votre intégration afin de ne plus supposer qu’une seule facture doit être réglée par un paiement unique, et utilisez le nouvel objet Invoice Payment pour comprendre le lien entre les paiements et les factures.

Consultez le tableau invoice.payments pour les informations de paiement

Vous pouvez inspecter invoice.payments lorsque vous interagissez avec l’objet Invoice en développant la propriété payments :

curl -G https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=payments

Le tableau invoice.payments fournit une liste de tous les paiements associés à la facture, ainsi que leur affectation et leur état de paiement respectifs.

Utilisez les nouveaux endpoints de paiement de facture pour associer les paiements aux factures

Pour comprendre le lien entre un objet Payment Intent et un objet Invoice, vous pouvez utiliser l’endpoint Liste de paiements de facture :

curl -G https://api.stripe.com/v1/invoice_payments \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment[type]"=payment_intent \
  -d "payment[payment_intent]"={PAYMENT_INTENT_ID}

Utiliser confirmation_secret pour les intégrations Payment Element

Pour les intégrations Payment Element, en particulier les intégrations d’abonnement, qui reposaient auparavant sur le développement de invoice.payment_intent.client_secret ou latest_invoice.payments.data.payment.payment_intent.client_secret, vous pouvez désormais utiliser le nouveau champ invoice.confirmation_secret.client_secret de l’objet Invoice en développant confirmation_secret :

curl -G https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=confirmation_secret

Modifications

Mise à niveau