Rapports et rapprochementVersion bêta privée

Découvrez comment déclarer et rapprocher les transactions Capital.

Tout au long du cycle de vie d’une offre de financement Capital, il existe trois types de transactions :

Virement : un virement est réalisé lorsque les fonds sont versés sur le compte connecté, conformément au contrat de financement accepté.
Remboursement : un remboursement permet de rembourser le montant du financement.
Annulation : une annulation se produit lorsqu’un virement ou un remboursement est annulé.

Stripe expose les transactions Capital afin que vous puissiez fournir des rapports aux comptes connectés (utilisateurs). Vous pouvez inclure les transactions Capital dans votre plateforme ou logiciel de comptabilité afin que vos utilisateurs puissent rapprocher leurs transactions.

Deux options vous permettent de récupérer des transactions :

API Financing Transactions : nous vous recommandons d’utiliser l’API Financing Transactions, qui inclut des informations supplémentaires sur les transactions propres à Capital.
API Balance Transactions : si vous disposez déjà d’une intégration avec l’API Balance Transactions, les opérations sur solde de Capital renvoient la plupart des types de transactions, mais des détails supplémentaires sont manquants (comme l’offre de financement Capital associée).

Transactions par virement

Lorsque vous activez une fréquence de virements automatique, votre compte connecté reçoit automatiquement le virement de son financement. Sinon, vous devez créer un virement de type source_type=financing pour verser manuellement le financement à l’utilisateur.

Les virements de financement sont associés à une transaction de financement de type payout. Lorsqu’une transaction de financement payout est créée, Stripe envoie un webhook capital.financing_transaction.created. Cependant, plusieurs jours ouvrables peuvent être nécessaires pour que les fonds ACH arrivent sur le compte bancaire du compte connecté.

Transactions de remboursement

Capital distingue entre trois types de transactions de remboursement :

Retenue à des fins de remboursement : lorsque vos comptes connectés (vos utilisateurs) font une demande de financement, ils acceptent que Stripe prélève un pourcentage fixe de leurs gains futurs jusqu’à ce qu’ils aient remboursé le montant total du financement.
Remboursements initiés par l’utilisateur : les utilisateurs peuvent effectuer un remboursement manuel de leur financement sur la page de reporting Capital hébergée.
Tentatives de recouvrement : l’équipe de service Stripe peut initier des remboursements, conformément à la Politique de recouvrement de Capital.

Tous les remboursements sont associés à une transaction de financement de type payment. Vous pouvez récupérer les transactions de financement et filtrer par type de transaction si vous souhaitez afficher les transactions de prélèvement dans votre interface utilisateur. Assurez-vous de fournir 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.

Paiements indirects

Si votre plateforme utilise des paiements indirects et que vous souhaitez rapprocher le remboursement d’une transaction de financement et le paiement initial survenu sur votre plateforme, vous pouvez le faire en extrayant d’abord l’ID de paiement dans le champ details.transaction de la transaction de financement. Sa valeur correspondra à l’ID de paiement généré à la suite du automatique transfert 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 Charge :

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

Étant donné qu’il s’agit d’un paiement indirect, le paramètre source_transfer est renseigné avec l’ID du transfert. Enfin, vous pouvez utiliser l’API Retrieve Transfer pour récupérer l’objet Transfer :

{
  "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é.

Opérations d’annulation

Les virements et remboursements peuvent être annulés pour l’une des raisons suivantes :

Échec du prélèvement ACH : le compte bancaire d’un compte connecté ne dispose peut-être pas des fonds suffisants pour couvrir le remboursement.
Annulation du financement : si un compte connecté annule l’offre de financement après acceptation, nous émettons un débit pour récupérer les fonds et annuler le virement du financement.
Annulations manuelles ponctuelles : lorsqu’un paiement est remboursé, nous n’annulons pas le remboursement de la transaction de financement. Cependant, les utilisateurs peuvent contacter capital-support@stripe.com pour nous demander d’annuler le remboursement. Selon la nature de l’annulation, nous pouvons répondre favorablement à cette demande. Dans ce cas, nous vous demandons de fournir autant d’informations que possible sur le paiement initial et la raison pour laquelle il a été remboursé.

L’annulation d’un remboursement ou d’un virement crée une transaction de financement de type reversal.