Ségrégation des fonds pour les paiements et transferts distinctsVersion bêta privée

La ségrégation des fonds vous permet d’affecter les fonds des paiements et transfers distincts à un état de retenue sur le compte de votre plateforme avant de les transférer vers les comptes connectés. Les fonds dans cet état n’apparaissent pas dans le solde de votre plateforme, et vous ne pouvez les transférer que vers un compte connecté.

Vous pouvez consulter le solde attribué d’un paiement spécifique, ce qui vous permet de suivre le flux complet de ces fonds.

L’affectation de fonds empêche leur utilisation à d’autres fins, par exemple :

• Virements automatiques au niveau de la plateforme
• Remboursements et contestations de paiement non liés
• Frais Stripe
• Autres prélèvements sur le solde des paiements de votre plateforme

Disponible dans :

Conditions préalables et limitations

Avant de mettre en œuvre la séparation des fonds, passez en revue ces exigences et limitations :

Exigences

• Votre plateforme doit assumer la responsabilité des soldes négatifs sur les comptes connectés.
• Vous devez inclure l’en-tête de prévisualisation allocated_funds_preview=v1 dans toutes les requêtes API.

Limitations

• Le Dashboard de Stripe n’identifie pas les fonds alloués. Les soldes et les transactions sur le Dashboard peuvent combiner des fonds alloués et d’autres fonds.
• Toutes les factures de frais sont asynchrones ; les frais peuvent ne pas s’afficher en même temps que le paiement. Les frais sont ensuite facturés sur le solde Stripe de la plateforme.
• Vous pouvez uniquement consulter les détails des fonds alloués en développant des objets Charge individuels.
• Évitez d’utiliser le paramètre automatic_payment_methods. Les fonds alloués ne peuvent provenir que de paiements effectués avec les moyens de paiement Visa, Mastercard, Discover, American Express et Swish.
• Vous ne pouvez pas utiliser la ségrégation des fonds avec surcapture, multicapture ou autorisation complémentaire.
• Vous ne pouvez pas utiliser les virements internationaux avec la ségrégation des fonds aux États-Unis. Vous pouvez uniquement transférer des fonds alloués vers des comptes connectés américains.

Créer des paiements avec les fonds attribués

Pour utiliser la ségrégation des fonds, créez une PaymentIntent avec allocated_funds définie sur enabled: true. Lors de la capture du paiement, Stripe attribue les fonds.

Vous pouvez suivre le flux des fonds alloués en spécifiant une valeur transfer_group unique.

Une fois la capture réussie, le montant total devient disponible (sous réserve du délai de règlement du moyen de paiement) sous forme de fonds alloués que vous pouvez transférer vers un compte connecté.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d "allocated_funds[enabled]"=true \
  -d amount=10000 \
  -d currency=eur \
  -d payment_method=pm_xxxxxxxxx \
  -d transfer_group=ORDER100 \
  -d confirm=true \
  -d capture_method=automatic

Afficher les fonds alloués à un paiement spécifique

Pour voir le solde des fonds alloués d’un paiement spécifique, développez la propriété allocated_funds.balance du débité :

curl -G https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d "expand[]"="latest_charge.allocated_funds.balance"

{
  "id": "{{PaymentIntent ID}}",
  "object": "payment_intent",
  "latest_charge": {
    "id": "{{Charge ID}}",
    "object": "charge",
    "allocated_funds": {
      "enabled": true,
      "balance": {
        "available": 0,
        "pending": 10000,
        "currency": "eur"
      }
    }
  }
}

Transférer les fonds attribués

Lorsque vous transférez des fonds attribués, vous devez définir le paramètre source_transaction sur l’ID du débité associé et le paramètre destination sur l’ID du compte connecté associé.

Si vous spécifiez un montant de commission de plateforme, ce montant est débité des fonds alloués et crédité sur le solde des paiements de votre plateforme. La réponse de création de transfert inclut des détails sur la commission de plateforme.

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d destination="{{Connected Account ID}}" \
  -d source_transaction="{{Charge ID}}" \
  -d amount=3800 \
  -d currency=eur \
  -d application_fee_amount=200

Vous n’avez pas besoin de transférer le montant total du paiement en un seul transfert ou vers un seul compte connecté. Vous pouvez répartir les fonds alloués sur plusieurs transferts, tant que le total ne dépasse pas le montant du paiement initial.

La réponse du transfert inclut des détails sur la commission de la plateforme lorsque cela est spécifié :

{
  "id": "{{Transfer ID}}",
  "object": "transfer",
  "amount": 3800,
  "currency": "eur",
  "destination": "{{Connected Account ID}}",
  "source_transaction": "{{Charge ID}}",
  "application_fee_amount": 200,
  "application_fee": {
    "id": "{{Application Fee ID}}",
    "object": "application_fee",
    "amount": 200,
    "currency": "eur",
    "fee_source": {
      "type": "transfer",
      "transfer": "{{Transfer ID}}"
    }
  }
}

L’encaissement de commissions de la plateforme sur les transferts déplace directement les fonds des fonds alloués vers le solde du compte plateforme. Cela permet d’éviter des conversions de devise (FX) inutiles lorsque la devise de la plateforme et celle du compte connecté sont différentes, car les commissions de la plateforme ne quittent jamais le compte plateforme.

Gérez les litiges et les remboursements

Les Remboursements et les litiges concernant des paiements pour lesquels des fonds ont été alloués puisent dans ces fonds avant d’utiliser les fonds du solde de votre compte de plateforme. Stripe ne débite du solde de votre compte de plateforme que si les fonds alloués restants du paiement associé ne peuvent couvrir le remboursement ou le litige.

Par exemple, si vous avez transféré 60 EUR d’un paiement de 100 EUR, puis traité un remboursement de 100 EUR :

• 40 EUR proviennent des fonds restants attribués.
• Les 60 EUR proviennent du solde du compte de votre plateforme.

Les frais de litige sont toujours débités du solde de votre compte de plateforme et n’affectent pas les fonds alloués.

Vous pouvez utiliser les annulations de transfert pour restituer des fonds d’un compte connecté vers le solde des fonds alloués avant de traiter un remboursement ou dans l’attente de l’issue d’un litige :

curl https://api.stripe.com/v1/transfers/
{{TRANSFER_ID}}
/reversals \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=6000 \
  -d refund_application_fee=true

Les annulations de transfert font toujours basculer les fonds dans un état attribué si le paiement a été initialement attribué.

Si vous définissez le paramètre refund_application_fee sur true, Stripe débite également le montant des frais de candidature du solde des paiements de votre plateforme et le remet dans l’état attribué.

Si vous annulez un transfert de fonds attribués qui sont impliqués dans un litige, ils restent attribués quelle que soit l’issue du litige. Vous ne pouvez pas récupérer les frais de litige auprès d’eux.

Si le litige est remporté, vous pouvez retransférer les fonds alloués sur votre compte connecté. Si le litige est perdu, alors vous pouvez contacter Stripe pour demander que nous désaffections les fonds et les ajoutions au solde de votre compte de plateforme.

Transférer manuellement les fonds alloués vers le solde de votre compte de plateforme

Vous pouvez utiliser des transferts de solde pour transférer des fonds depuis vos fonds alloués vers le solde de votre compte sur la plateforme. Cela est utile pour régler un solde en suspens ou percevoir des frais de plateforme à un moment autre que celui où les frais ont été facturés ou transférés. La devise sélectionnée doit correspondre à la devise dans laquelle les frais ont été réglés.

Par exemple, un solde de fonds alloués en attente peut survenir si un litige client a d’abord été remboursé à partir du solde de votre compte plateforme, puis que vous avez ensuite annulé le transfert depuis le marchand. Dans ce cas, les fonds récupérés se trouvent dans vos fonds alloués, mais comme le client a déjà été remboursé, vous souhaiterez probablement transférer ces fonds alloués vers le solde de votre compte plateforme.

curl https://api.stripe.com/v1/balance_transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d amount=6000 \
  -d currency=eur \
  -d "destination_balance[type]"=payments \
  -d "source_balance[type]"=allocated_funds \
  -d "source_balance[allocated_funds][type]"=charge \
  -d "source_balance[allocated_funds][charge]"="{{Charge ID}}"

Ségrégation des fonds de test

Vous pouvez tester uniquement les fonds attribués dans des environnements environnements de test, et non en mode test. Reportez-vous au guide de test pour simuler des paiements pour votre intégration.