Qu'est-ce qui change?

Nous uniformisons le comportement des opérations sur solde pour tous les moyens de paiement par prélèvement en 2024. Les opérations sur solde sont des objets de l'API qui représentent les fonds entrant et sortant du solde d'un compte Stripe. Actuellement, pour certains moyens de paiement par prélèvement, les opérations sur solde sont créées uniquement en cas de paiement réussi. Cela se produit généralement quelques jours après la création du paiement et est déterminé par le système et le partenaire bancaire.

Dorénavant, Stripe créera les opérations sur solde plus tôt. Au lieu d'attendre la réussite d'un paiement, les opérations sur solde seront créées lorsque Stripe soumettra le paiement au réseau bancaire. Cela signifie qu'une fois qu'une opération sur solde est créée, elle reste en attente jusqu'à ce que le paiement passe à l'état de réussite. En outre, les opérations sur solde ont un attribut appelé available_on qui indique le moment où l'opération sur solde est disponible pour virement sur votre compte bancaire externe. Les dates available_on des opérations sur solde resteront constantes pendant toute la durée de ce changement.

Conséquences pour l'API

S'appuyer sur l'état du paiement comme indicateur de réussite

Si votre intégration attend actuellement qu'un paiement réussisse avant d'exécuter les commandes, vous devez surveiller les événements charge.succeeded ou payment_intent.succeeded pour confirmer de manière fiable que les paiements ont réussi.

Bien que peu courant, il était auparavant possible de s'appuyer sur la présence de l'opération sur solde comme indicateur de réussite du paiement. Cette pratique n'est plus recommandée, étant donné que les paiements en attente peuvent également comporter des opérations sur solde et que ces fonds ne sont pas considérés comme réglés tant que le paiement n'a pas abouti. Notez également que le paramètre available_on de l'opération sur solde ne doit pas être utilisé comme un signal de réussite du paiement : il représente le moment où les fonds seront débloqués sur votre solde Stripe.

Les échecs de paiement peuvent donner lieu à deux opérations sur solde

Avant ce changement, aucune opération sur solde n'était émise en cas d'échec de paiement. Après ce changement, les paiements refusés qui ont été soumis à des rails bancaires comporteront 2 opérations sur solde : une balance_transaction positive et une seconde failure_balance_transaction négative dans l'objet Charge.

Si votre intégration interroge les soldes ou les données d'attribution des virements, vous devrez peut-être traiter ce nouveau type d'opération sur solde dans vos processus de comptabilité ou de rapprochement.

(Connect uniquement) Les transferts Connect sont exécutés de manière anticipée

Cette section s'applique uniquement aux plateformes Connect qui effectuent des paiements indirects. Lorsqu'un paiement génère une opération sur solde, les transferts sont exécutés en tandem. Après ce changement, les transferts en attente seront créés avant la réussite du paiement. Bien qu'il soit créé plus tôt, Stripe veillera à ce que la valeur available_on du transfert corresponde à la transaction source.

(Connect uniquement) Paiements & transferts distincts

Si vous êtes une plateforme Connect qui effectue des paiements & transferts distincts avec l'option de transfert source_transaction, vous aurez également la possibilité d'initier des transferts contre des paiements en attente après ce changement. Vous n'avez pas besoin de modifier votre intégration si vous souhaitez conserver votre comportement actuel.

Mode test

Nous activerons le mode test d'ici le 29 avril 2024. Après cette date, vous pourrez initier des transactions test par le biais du Dashboard ou de l'API, ce qui vous permettra d'observer les changements de délais des opérations sur solde. Notez qu'en mode test, les transactions sont réglées de manière accélérée.

Pourquoi nous procédons ainsi

Nous uniformisons le fonctionnement de tous les paiements par prélèvement, ce qui facilitera l'intégration des moyens de paiement par prélèvement, notamment si vous en activez plusieurs. Le fait de créer l'opération sur solde plus tôt permet également d'avoir une meilleure visibilité sur le cycle de vie du paiement, ce qui peut permettre d'établir des rapports financiers/comptables plus précis.