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 l’API Financing Transactions pour inclure des informations détaillées sur les transactions spécifiques à Capital.

Surveiller les transactions Capital

Les types de transactions suivants sont liés au financement de vos comptes connectés, y compris les avances de fonds et les prêts aux marchands :

Virement : payout
Remboursement : payment
Annulation : reversal

Virement

Chaque virement de financement possède un objet transaction de financement de type payout. Une fois qu’une transaction de financement par virement est créée, Stripe envoie un webhook capital.financing_transaction.created. Les fonds ACH peuvent mettre plusieurs jours ouvrables à arriver sur le compte bancaire d’un compte connecté.

Écoutez l’événement webhook et, une fois reçu, mettez à jour vos rapports de virement personnalisés pour afficher le montant du financement envoyé sur le compte bancaire externe du compte connecté.

Remboursement

Pour afficher les transactions de retenue à la source dans votre interface utilisateur :

Récupérez les transactions de financement et filtrez par type de transaction.
Fournissez l’ID du compte connecté dans l’en-tête Stripe-Account.

Si la récupération de la liste des transactions de financement aboutit, vous recevez une réponse de ce type :

{
  "object": "list",
  "url": "/v1/capital/financing_transactions?financing_offer=financingoffer_1NAdVWJQ3aJgxqz5nh90Zqrs&charge=ch_1HoZftJQ3aJgxqz50EbvL8zU",
  "has_more": false,
  "data": [
    {
      "id": "cptxn_1NAdVWJQ3aJgxqz5FSScvJaF",
      "object": "capital.financing_transaction",
      "account": "acct_1HLGiXJQ3aJgxqz5",
      "created_at": 1684780258,
      "details": {
        "advance_amount": 10000,
        "currency": "usd",
        "fee_amount": 1000,
        "linked_payment": "ch_1HoZftJQ3aJgxqz50EbvL8zU",
        "reason": "automatic_withholding",
        "total_amount": 11000,
        "transaction": {
          "charge": "ch_1HoZftJQ3aJgxqz50EbvL8zU"
        }
      },
      "financing_offer": "financingoffer_1NAdVWJQ3aJgxqz5nh90Zqrs",
      "livemode": true,
      "type": "payment",
      "user_facing_description": "Paydown of your loan"
    },
    {...},
    {...}
  ]
}

La réponse contient des informations décrivant l’incidence de ce remboursement spécifique sur le montant impayé du financement. Si le remboursement est dû à "details.reason": "automatic_withholding", il contient également une référence au paiement Stripe d’origine dans le champ details.transaction.

Annulation

Chaque annulation comporte un objet transaction financière de type 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.

Paiements indirects

Si votre plateforme traite des paiements à l’aide de paiements indirects et que vous souhaitez rapprocher le remboursement de la transaction de financement avec le paiement initial qui a eu lieu sur votre plateforme, extrayez l’ID du paiement dans le champ details.transaction de la transaction de financement. Ce paramètre est défini sur l’ID de paiement qui a été généré à la suite du transfert automatique vers le compte connecté :

{
  "id": "cptxn_1NBJQR2eZvKYlo2CBUy2GQ1S",
  "object": "capital.financing_transaction",
  "details": {
    "reason": "automatic_withholding",
    "transaction": {
      "charge": "py_1NBJI62c99H72o8MUEN0fIZx"
    },
    ...
  },
  "type": "payment",
  ...
}

Vous pouvez ensuite utiliser l’API Retrieve Charge pour récupérer l’objet paiement :

{
  "id": "py_1NBJI62c99H72o8MUEN0fIZx",
  "object": "charge",
  "source_transfer": "tr_3NBJGW2eZvKYlo2C1jQOxNwF",
  ...
}

Puisqu’il s’agit d’un paiement indirect, le champ source_transfer est renseigné avec l’ID du transfert. Utilisez l’API Retrieve Transfer pour obtenir l’objet Transférer :

{
  "id": "tr_3NBJGW2eZvKYlo2C1jQOxNwF",
  "object": "transfer",
  "source_transaction": "ch_3NBJGW2eZvKYlo2C17oDFajw",
  ...
}

Le champ source_transaction contient l’ID du paiement réalisé sur votre plateforme, déclenchant un transfert vers le compte connecté.

Fournir des rapports

Vous pouvez afficher les remboursements dans n’importe quelle liste de transactions de financement ou des modèles équivalents que vous avez 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 permet aux comptes connectés de rapprocher le total de leurs ventes entrantes traitées, déduction faite de la retenue à la source (et 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.