Créer un programme Capital personnaliséVersion bêta privée

Tous les utilisateurs qui reçoivent des offres Capital verront le nom de votre entreprise, l’icône, le logo et la couleur de votre marque dans les e-mails d’offre, la page de demande de financement et la page de rapport sur les financements.

Accédez à vos paramètres Connect d’adaptation à votre marque et vérifiez que les paramètres d’image de marque de votre plateforme sont corrects.

Nous vous recommandons d’utiliser un environnement de test pour créer votre intégration. Dans un environnement de test, accédez au Dashboard Capital.

1. Cliquez sur Créer pour ouvrir la fenêtre modale Créer une offre de financement, qui vous permet de créer des offres de financement test. Les options par défaut permettent de créer une offre de financement non livrée d’un montant de 1 000 USD.
2. Conservez les options par défaut, puis cliquez sur Créer une offre de financement.
3. Dans le Dashboard, cliquez sur la ligne correspondant à l’offre ainsi créée.

La section Prêts et financements de la page d’information du compte connecté affiche des informations sur l’offre de financement de l’utilisateur.

Vous pouvez récupérer les offres de financement de tous les utilisateurs de votre plateforme à l’aide de l’endpoint de Liste des offres de financement.

curl https://api.stripe.com/v1/capital/financing_offers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Si la création de l’offre aboutit, vous recevez une réponse de ce type :

{
  "object": "list",
  "url": "/v1/capital/financing_offers",
  "has_more": false,
  "data": [
    {
      "id": "financingoffer_abc123",
      "object": "capital.financing_offer",
      ...,
    },
    {...}
  ]
}

Vous pouvez rechercher une offre de financement à l’aide de l’endpoint de récupération d’une offre de financement. Récupérez la première offre de financement de la liste ci-dessus.

curl https://api.stripe.com/v1/capital/financing_offers/financingoffer_abc123 \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Stripe envoie le webhook capital.financing_offer.created à la création d’une offre de financement. Mettez à jour votre intégration de webhook de manière à écouter le webhook capital.financing_offer.created. Ce webhook est particulièrement important si vous envoyez vos offres par e-mail vous-même, car il vous notifie lorsque vous devez communiquer une offre à un utilisateur.

Incluez dans l’e-mail un lien dirigeant l’utilisateur vers une section dédiée à Capital dans le Dashboard de votre plateforme. Les utilisateurs accèdent au formulaire de demande d’offre de financement Capital via des liens de compte. Ceux-ci expirent peu de temps après leur création. Vous devez donc offrir à vos utilisateurs la possibilité de générer un nouveau lien. Incluez un lien vers le formulaire de demande de financement dans le Dashboard de votre plateforme en générant un lien de compte de type capital_financing_offer.

curl https://api.stripe.com/v1/account_links \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d account=acct_123 \
  # The URL the user will be redirected to if the account link is expired, has been previously-visited, or is otherwise invalid.
  -d refresh_url="https://example.com/reauth" \
  # The URL the user will be redirected to after completing the linked flow.
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_offer

Si la création du lien de compte aboutit, vous recevez une réponse de ce type :

{
  "object": "account_link",
  "created": 1611264596,
  "expires_at": 1611264896,
  "url": "https://connect.stripe.com/capital/offer/SrjgLUfa0O7K"
}

Une fois votre intégration de webhook mise à jour, créez une autre offre dans le Dashboard et vérifiez que vous recevez le webhook capital.financing_offer.created.

Marquer l’offre comme livrée

Mettez à jour votre intégration de webhook de manière à marquer l’offre de financement comme livrée après envoi de l’offre par e-mail. Cette étape est obligatoire. Elle permet d’indiquer que vous avez communiqué l’offre à l’utilisateur.

curl https://api.stripe.com/v1/capital/financing_offers/financingoffer_abc123/mark_delivered \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Vérifiez que l’offre de financement est à l’état « Livrée » à l’aide du Dashboard ou de l’API d’offre de financement.

Après le webhook capital.financing_offer.created, Stripe envoie d’autres webhooks au fur et à mesure que l’offre de financement change d’état. Voici tous les différents webhooks que vous pouvez recevoir :

Dans le Dashboard, localisez l’offre de financement précédemment envoyée.

1. Cliquez sur le menu de débordement ().
2. Cliquez sur l’option Faire expirer l’offre, qui permet de simuler l’expiration d’une offre.
3. Vérifiez que vous avez reçu le webhook capital.financing_offer.expired.

À l’exception de capital.financing_offer.canceled, vous pouvez simuler tous les webhooks dans un environnement de test.

Pour simuler le webhook capital.financing_offer.accepted, vous devez effectuer une demande de financement.

1. Dans le Dashboard, créez une offre livrée d’un montant maximal de 20 000 USD.
2. Générez un lien de compte de type capital_financing_offer, puis cliquez sur le lien. La page qui s’affiche vous permet de voir à quoi ressemble le formulaire de demande de financement auquel accèdent les utilisateurs.
3. Allez jusqu’à la fin du formulaire, puis cliquez sur Envoyer.
4. Vérifiez que vous avez reçu le webhook capital.financing_offer.accepted.
5. Affichez l’offre dans le Dashboard et vérifiez que son état est « Acceptée ».

Afficher le suivi des demandes

Une offre de financement dont l’état est « Acceptée » est en attente de vérification par l’équipe de gestion de Stripe. En attendant que la demande soit vérifiée, vous pouvez diriger l’utilisateur vers la page de rapport sur les financements. Celle-ci inclut une section permettant de suivre l’état des demandes et précisant le délai approximatif d’examen de la demande.

Générez un lien de compte de type capital_financing_reporting.

curl https://api.stripe.com/v1/account_links \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d account=acct_123 \
  # When the user refreshes the page, where should we redirect them
  -d refresh_url="https://example.com/reauth" \
  # When the user completes the application, where should they return
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_reporting

Cliquez sur le lien, puis consultez l’outil de suivi des demandes.

Dans le Dashboard, recherchez la ligne correspondant à l’offre acceptée.

1. Cliquez sur le menu de débordement ().
2. Cliquez sur l’option Approuver et décaisser les fonds, qui permet de simuler l’acceptation d’une demande et le versement des fonds correspondants.
3. Vérifiez que vous avez reçu le webhook capital.financing_offer.paid_out, qui vous informe du versement du financement.
4. Générez un autre lien de compte de type capital_financing_reporting. Cette page de rapport fournit des informations sur le solde impayé et les virements et remboursements associés au financement en cours de l’utilisateur.
5. Cliquez sur Effectuer un paiement et créez un remboursement manuel.

Une fois la transaction traitée, consultez le remboursement dans le tableau des transactions. Vous pouvez consulter le montant du financement en cours remboursé par l’utilisateur de manière programmatique à l’aide de l’API Financing Summary.

curl https://api.stripe.com/v1/capital/financing_summary \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \

Si la récupération du récapitulatif de financement réussit, vous recevez une réponse de ce type :

{
  "object": "capital.financing_summary",
  "details": {
    "currency": "usd",
    "advance_amount": 1000000,
    "fee_amount": 100000,
    "withhold_rate": 0.2,
    "remaining_amount": 999950,
    "paid_amount": 50,
    "current_repayment_interval": {
      "due_at": 123456789,
      "remaining_amount": 50,
      "paid_amount": 50
    },
    "repayments_begin_at": 123456789,
    "advance_paid_out_at": 123456789
  }
}

Dans le Dashboard, localisez la ligne correspondant au financement versé.

1. Cliquez sur le menu de débordement ().
2. Cliquez sur l’option Rembourser l’offre, qui permet de simuler le remboursement intégral d’un solde de financement.
3. Vérifiez que vous avez reçu le webhook capital.financing_offer.fully_repaid, qui vous informe du remboursement intégral d’un financement.
4. Générez un autre lien de compte de type capital_financing_reporting.

Quand un utilisateur a remboursé la totalité de son financement, il peut à tout moment accéder aux détails de ses financements précédents.

Maintenant, votre intégration :

• Répond au webhook capital.financing_offer.created par l’envoi d’un e-mail d’offre et en marquant l’offre comme livrée
• Affiche un lien vers le formulaire de demande de financement dans le Dashboard de votre plateforme
• Affiche un lien vers le rapport sur les financements dans le Dashboard de votre plateforme

La section Capital du Dashboard de votre plateforme peut avoir une apparence différente selon la phase du financement de votre utilisateur. Vous trouverez la liste des états possibles des offres de financement dans le diagramme des états ci-dessous.

Si les offres automatiques sont activées en mode production, Stripe créée chaque jour des offres de financement pour vos utilisateurs, de manière automatique. Avant d’activer les offres automatiques, veillez à :

1. Confirmez et mettez à jour les adresses e-mail de vos utilisateurs via le Centre de communication si vous envisagez d’utiliser les e-mails d’offres comarquées et no-code de Stripe. Pour qu’un utilisateur puisse bénéficier d’une offre de financement Capital, son adresse e-mail doit figurer dans les registres de Stripe de façon à recevoir des e-mails transactionnels, par exemple des e-mails récapitulant les remboursements qu’il a effectués.
2. Contactez-nous pour activer l’accès à l’API d’offres de financement en mode production.

Activer d’autres fonctionnalités

Certains de vos utilisateurs finiront par bénéficier d’offres Refill. Les offres Refill sont des offres de financement supplémentaires envoyées aux utilisateurs qui ont déjà remboursé une grande partie de leurs prêts en cours. Suivez le guide d’intégration des offres Refill pour rendre votre intégration compatible avec les offres de financement Refill.

Si vous souhaitez inclure les transactions Capital dans le Dashboard de votre plateforme et mettre à jour le reporting concernant les virements de vos utilisateurs, consultez le guide de reporting et de rapprochement.