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 PaymentIntent et Charge.
• Suppression des champs application_fee_amount et transfer_data de l’objet Invoice. Pour les paiements effectués sur Stripe, ces champs sont désormais accessibles via le PaymentIntent sous-jacent en développant payments.data.payment.payment_intent sur l’objet Invoice.
• 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

Accéder à application_fee_amount et transfer_data via PaymentIntents

Avec la suppression des champs application_fee_amount et transfer_data de l’objet Invoice, vous pouvez désormais accéder à ces champs pour les paiements effectués sur Stripe via le PaymentIntent sous-jacent. Développez payments.data.payment.payment_intent lors de la récupération de la facture :

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

Vous pouvez ensuite accéder à invoice.payments.data[i].payment.payment_intent.application_fee_amount et invoice.payments.data[i].payment.payment_intent.transfer_data depuis l’objet PaymentIntent développé. Ces champs ne sont disponibles que pour les paiements effectués sur Stripe lorsque le type de paiement est payment_intent.

Identifier les factures avec des paiements hors Stripe

Avec la suppression du champ paid_out_of_band, vous pouvez désormais identifier les factures avec des paiements Stripe à l’aide de l’icône facture.payments.

Pour vérifier si une facture est entièrement payée hors Stripe, vérifiez si lestatus de la facture est paid, si amount_due est supérieur à 0, et la somme des paiements de type PaymentIntent dans le tableau invoice.payments est égal à 0.

Pour vérifier si une facture est partiellement payée hors Stripe, vérifiez si amount_due est supérieur à 0, et si la somme des paiements de type PaymentIntent dans le tableau invoice.payments est inférieure àamount_paid.

Modifications

Mise à niveau