Fournir et rapprocher des rapportsVersion bêta privée

Découvrez comment fournir des rapports Capital à vos comptes connectés et rapprocher les transactions Capital dans les rapports existants.

Version bêta privée

Capital pour les plateformes est en version bêta privée. Vous pouvez vous inscrire pour y accéder.

Utilisez ce guide pour :

Fournir des rapports Capital : Fournissez des rapports sur les transactions Capital à vos comptes connectés. Ils peuvent utiliser ces rapports pour consulter leur solde impayé, l’historique de leurs paiements et d’autres données telles que leur contrat de financement. Vous pouvez fournir des rapports à vos comptes connectés de plusieurs manières.
Rapprocher les rapports existants pour inclure les transactions Capital : Si vous fournissez déjà des rapports à vos comptes connectés dans l’interface utilisateur de votre plateforme, utilisez les API Stripe pour synchroniser les données de transaction Capital dans ces rapports existants.

Les offres de financement comportent trois types de transactions : un virement, un remboursement et une annulation. Si vous souhaitez fournir des rapports à l’aide des API Stripe, nous décrivons ces transactions plus en détail ci-dessous.

Options pour fournir des rapports

Vous pouvez fournir des rapports Capital à vos comptes connectés de plusieurs manières, et vous pouvez utiliser plusieurs options :

E-mail	Les comptes connectés reçoivent des notifications par e-mail concernant l’acceptation des offres et le décaissement des virements, ainsi que des mises à jour hebdomadaires sur l’avancement des paiements. Ces e-mails co-marqués contiennent un lien qui redirige un compte connecté vers une page Capital distincte hébergée par Stripe, où celui-ci peut consulter ses transactions Capital et l’avancement de son paiement. Cette page n’inclut pas les informations de traitement des paiements standard (telles que les montants débités initiaux, les frais de plateforme et de traitement, les remboursements ou les litiges). Nous le faisons automatiquement pour vous (si vous choisissez que Stripe envoie des courriels en votre nom lors de l’inscription).
Composant intégré	Intégrez le composant Capital Financing à l’interface utilisateur de votre plateforme. Cela vous permet d’afficher des rapports de transactions auxquels vos comptes connectés peuvent accéder directement dans l’interface utilisateur de votre plateforme. Le composant n’inclut pas les informations standard de traitement des paiements (paiements, remboursements ou litiges). Pour implémenter ce composant, consultez la page Financement Capital.
API	Surveillez et affichez les transactions Capital ainsi que des données de paiement détaillées (y compris les informations de traitement des paiements standard telles que les paiements, les remboursements et les litiges) à l’aide de l’API Financing Transactions. Vous pouvez également créer vos propres interfaces de reporting personnalisées. Pour utiliser ces API, continuez à lire ce guide.

E-mail

Les comptes connectés reçoivent des notifications par e-mail concernant l’acceptation des offres et le décaissement des virements, ainsi que des mises à jour hebdomadaires sur l’avancement des paiements. Ces e-mails co-marqués contiennent un lien qui redirige un compte connecté vers une page Capital distincte hébergée par Stripe, où celui-ci peut consulter ses transactions Capital et l’avancement de son paiement. Cette page n’inclut pas les informations de traitement des paiements standard (telles que les montants débités initiaux, les frais de plateforme et de traitement, les remboursements ou les litiges).

Nous le faisons automatiquement pour vous (si vous choisissez que Stripe envoie des courriels en votre nom lors de l’inscription).

Composant intégré

Intégrez le composant Capital Financing à l’interface utilisateur de votre plateforme. Cela vous permet d’afficher des rapports de transactions auxquels vos comptes connectés peuvent accéder directement dans l’interface utilisateur de votre plateforme. Le composant n’inclut pas les informations standard de traitement des paiements (paiements, remboursements ou litiges).

Pour implémenter ce composant, consultez la page Financement Capital.

API

Surveillez et affichez les transactions Capital ainsi que des données de paiement détaillées (y compris les informations de traitement des paiements standard telles que les paiements, les remboursements et les litiges) à l’aide de l’API Financing Transactions. Vous pouvez également créer vos propres interfaces de reporting personnalisées.

Pour utiliser ces API, continuez à lire ce guide.

Vous pouvez également fournir des rapports ad hoc.

Avant de commencer

Si vous souhaitez fournir des rapports à l’aide d’API, examinez les types de transactions suivants :

Virement	Stripe (avec notre partenaire financier) distribue automatiquement les fonds pour un virement (pour une offre de financement approuvée et acceptée) conformément aux conditions du contrat de financement à un compte connecté. Un virement de financement Capital est indépendant des virements réguliers du compte connecté. Aucune action supplémentaire n’est requise de votre plateforme afin de faciliter ces virements.
Remboursement	Paiement utilisé pour rembourser un montant financé. Trois types de transactions de remboursement sont disponibles : Retenue à la source : Pourcentage fixe des paiements qui sont automatiquement prélevés pour rembourser le financement jusqu’à ce que le compte connecté paie le montant total du financement. Lorsque les comptes connectés demandent un financement, ceux-ci acceptent que Stripe prélève un pourcentage fixe de leurs gains futurs jusqu’au remboursement intégral du financement. Initié par l’utilisateur : Les utilisateurs peuvent effectuer manuellement un paiement pour leur financement sur la page Capital hébergée par Stripe ou dans le composant intégré de financement Stripe. Tentatives de recouvrement : L’équipe Service de Stripe peut initier des remboursements conformément à la politique de recouvrement de Capital. La retenue sur le capital a lieu simultanément au traitement des paiements, tandis que les frais de volume Connect et les frais d’application de la plateforme sont calculés sur la base du montant débité total. Le montant final transféré vers un compte connecté correspond au paiement initial, déduction faite des frais de l’application de la plateforme et de la retenue d’impôt Capital. Par exemple, votre compte connecté accepte une offre de financement avec un taux de retenue de 15 %. S’il accepte cinq paiements de 100 USD par jour, son virement total, après déduction des frais de l’application de votre plateforme et de la retenue Capital, est de 405 USD.
Annulation	Stripe peut annuler une transaction de virement ou de remboursement dans les situations suivantes : Échec de la transaction ACH : Se produit soit lorsqu’un compte connecté ne dispose pas de fonds suffisants pour effectuer un remboursement manuel à partir de son compte bancaire externe, soit lorsque le paiement ACH de son client échoue pendant ou après le règlement. Annulation du financement : Si un compte connecté annule une offre de financement acceptée, Stripe annule le virement initial. Annulation manuelle : Bien que les remboursements de paiement ne déclenchent pas automatiquement les annulations de remboursement Capital, les comptes connectés peuvent demander une annulation manuelle en contactant capital-support@stripe.com. Ces demandes sont évaluées au cas par cas et nécessitent des détails sur le paiement initial, une explication du motif du remboursement et tout justificatif pertinent.

Virement

Stripe (avec notre partenaire financier) distribue automatiquement les fonds pour un virement (pour une offre de financement approuvée et acceptée) conformément aux conditions du contrat de financement à un compte connecté. Un virement de financement Capital est indépendant des virements réguliers du compte connecté. Aucune action supplémentaire n’est requise de votre plateforme afin de faciliter ces virements.

Remboursement

Paiement utilisé pour rembourser un montant financé. Trois types de transactions de remboursement sont disponibles :

Retenue à la source : Pourcentage fixe des paiements qui sont automatiquement prélevés pour rembourser le financement jusqu’à ce que le compte connecté paie le montant total du financement. Lorsque les comptes connectés demandent un financement, ceux-ci acceptent que Stripe prélève un pourcentage fixe de leurs gains futurs jusqu’au remboursement intégral du financement.
Initié par l’utilisateur : Les utilisateurs peuvent effectuer manuellement un paiement pour leur financement sur la page Capital hébergée par Stripe ou dans le composant intégré de financement Stripe.
Tentatives de recouvrement : L’équipe Service de Stripe peut initier des remboursements conformément à la politique de recouvrement de Capital.

La retenue sur le capital a lieu simultanément au traitement des paiements, tandis que les frais de volume Connect et les frais d’application de la plateforme sont calculés sur la base du montant débité total. Le montant final transféré vers un compte connecté correspond au paiement initial, déduction faite des frais de l’application de la plateforme et de la retenue d’impôt Capital. Par exemple, votre compte connecté accepte une offre de financement avec un taux de retenue de 15 %. S’il accepte cinq paiements de 100 USD par jour, son virement total, après déduction des frais de l’application de votre plateforme et de la retenue Capital, est de 405 USD.

Annulation

Stripe peut annuler une transaction de virement ou de remboursement dans les situations suivantes :

Échec de la transaction ACH : Se produit soit lorsqu’un compte connecté ne dispose pas de fonds suffisants pour effectuer un remboursement manuel à partir de son compte bancaire externe, soit lorsque le paiement ACH de son client échoue pendant ou après le règlement.
Annulation du financement : Si un compte connecté annule une offre de financement acceptée, Stripe annule le virement initial.
Annulation manuelle : Bien que les remboursements de paiement ne déclenchent pas automatiquement les annulations de remboursement Capital, les comptes connectés peuvent demander une annulation manuelle en contactant capital-support@stripe.com. Ces demandes sont évaluées au cas par cas et nécessitent des détails sur le paiement initial, une explication du motif du remboursement et tout justificatif pertinent.

Vous pouvez récupérer des transactions à l’aide de l’API Financing Transactions ou de l’API Balance Transactions.

Pour commencer, choisissez une API :

Utilisez cette option d’intégration si vous avez déjà une intégration existante qui utilise l’API Balance Transactions. Elle renvoie la plupart des types de transactions, mais ne contient pas d’informations supplémentaires telles que l’offre de financement d’un compte connecté.

Surveiller les transactions Capital

Les types d’opérations sur solde suivants sont liés au financement de vos comptes connectés, y compris les avances de fonds et les prêts aux marchands.

Virement : financing_payout
Remboursement : financing_paydown
Annulation : financing_payout_reversal ou financing_paydown_reversal

Virement

Chaque opération de virement possède un objet Opération sur solde de type financing_payout. Vous pouvez afficher les virements dans n’importe quelle liste d’opérations sur solde ou des modèles équivalents que vous avez dans l’interface utilisateur de votre plateforme.

Remboursement

Chaque opération de virement possède un objet Opération sur solde de type financing_paydown. Pour afficher les transactions de retenue à la source dans l’interface utilisateur de votre plateforme :

Retrouvez une opération sur solde et filtrez par type d’opération.
Fournissez l’ID du compte connecté dans l’en-tête Stripe-Account.

Par exemple :

Si vous récupérez la liste de l’opération sur solde, vous recevez une réponse telle que :

{
 "object": "list",
 "data": [
 {
  "id": "txn_abcdef123456",
  "object": "balance_transaction",
  "amount": -1550,
  "available_on": 123456789,
  "created": 123456789,
  "currency": "usd",
  "description": "Withheld funds from py_abcdef123456 to pay down flex loan flxln_abcdef123456",
  "exchange_rate": null,
  "fee": 0,
  "fee_details": [],
  "net": -1550,
  "reporting_category": "financing_paydown",
  "source": "cptxn_abcdef123456",
  "status": "available",
  "type": "financing_paydown"
 },
 ...
 ],
 "has_more": false,
 "url": "/v1/balance_transactions"
}

Si ce remboursement a eu lieu en raison d’une retenue Capital sur le paiement Stripe, le champ description de la réponse fait référence à ce paiement Stripe. Par exemple, un remboursement peut avoir la description suivante : « Fonds prélevés sur ch_123abc pour rembourser le prêt flxln_123abc ».

Vous pouvez récupérer l’objet de transaction financière applicable en développant le champ source de l’opération sur solde :

Lorsque vous développez le champ source, les détails de la transaction de financement s’affichent :

{
 "object": "list",
 "data": [
 {
  "id": "txn_abcdef123456",
  "object": "balance_transaction",
  "source": {
     "id": "cptxn_1NAyja2eZvKYlo2CGPcd8FIX",
     "object": "capital.financing_transaction",
     "account": "acct_1032D82eZvKYlo2C",
     "created_at": 1684861854,
     "details": {
       "advance_amount": 10000,
       "currency": "usd",
       "fee_amount": 1000,
       "linked_payment": "ch_1032Rp2eZvKYlo2Cv6jPGmkF",
       "reason": "automatic_withholding",
       "total_amount": 11000,
       "transaction": {
         "charge": "ch_1032Rp2eZvKYlo2Cv6jPGmkF"
       }
     },
     ...
   },
  "status": "available",
  "type": "financing_paydown"
 },
 ...
 ],
 "has_more": false,
 "url": "/v1/balance_transactions"
}

Annulation

Chaque opération d’annulation possède un objet Opération sur solde de type financing_payout_reversal ou financing_paydown_reversal. Une annulation peut survenir en raison d’un échec de transaction ACH, d’une annulation de financement ou d’une demande d’annulation manuelle. La fourniture de transactions d’annulation répond à deux objectifs :

Elles peuvent indiquer un financement annulé. Si vous avez inclus le virement de financement initial dans vos rapports, incluez les annulations éventuelles. De cette façon, les comptes connectés peuvent voir que les deux transactions s’annulent.
Ils peuvent restituer les fonds précédemment retenus sur le solde d’un compte connecté.

L’omission des annulations dans vos rapports peut entraîner des problèmes de rapprochement pour les comptes connectés, car les rapports peuvent refléter un financement inexact.

Fournir des rapports

Vous pouvez afficher les remboursements dans n’importe quelle liste d’opérations sur solde ou des modèles équivalents que vous pourriez avoir dans l’interface utilisateur de votre plateforme. Par exemple :

Rapports existants : Pour les rapports existants qui indiquent les transactions individuelles d’un compte connecté (y compris la commission de plateforme ou les frais d’interchange), envisagez d’ajouter un montant de retenue au rapport. Nouveaux rapports : Pour les nouveaux rapports, indiquez tous les montants retenus pour une période donnée. Cela permet à vos comptes connectés de voir quelle part de leur traitement des ventes est consacrée à leur financement. Pour les rapports de virement, vous pouvez inclure une somme totale retenue. Cela aide les comptes connectés à rapprocher le total de leurs ventes entrantes traitées, déduction faite de la retenue à la source (ainsi que des éventuelles commissions de plateforme que vous débitez), pour obtenir le montant du virement qu’ils s’attendent à voir apparaître sur leur compte bancaire externe.

Pour en savoir plus, consultez la page Rapprochement des virements.

Tests

Vous pouvez utiliser un environnement de test pour créer des offres de financement dans différents États pour les comptes connectés.

Pour créer des scénarios de test :

Créez un environnement de test dans votre environnement de test.
Générez des offres de test via le Dashboard Capital.
Mettez à jour les offres telles que livrées et simulez leur acceptation.
Testez les virements automatiques en approuvant et en décaissant les fonds.
Testez un virement ou un remboursement. Vous ne pouvez pas tester une annulation, car elle n’est initiée que par Stripe dans des circonstances spécifiques.
- Virements
  1. Vérifiez que les virements automatiques ont lieu après l’acceptation de l’offre
  2. Surveiller les webhooks capital.financing_transaction.created
  3. Confirmez que les transactions par virement apparaissent dans vos rapports
- Remboursements
  1. Testez la retenue automatique en traitant les paiements test
  2. Simulez des remboursements manuels via le Dashboard Capital
  3. Vérifiez que les transactions de remboursement apparaissent dans votre intégration de reporting
Vérifiez que les détails de la transaction apparaissent correctement dans votre interface de reporting.
Vérifiez la gestion des webhooks pour les notifications de transaction.
Testez les liens de compte ou les composants intégrés, le cas échéant.
Validez les processus de rapprochement des transactions.

Après les tests, envoyez manuellement une offre réelle pour vérifier vos rapports avant d’activer les offres automatiques pour tous les comptes connectés admissibles. Pour en savoir plus, consultez la page Tests.