Offres RefillVersion bêta privée

Recherchez votre dans Stripe en basculant entre les comptes vers vos organisations et en accédant à Paramètres > Gestion des organisations. Si elles sont approuvées, les offres Refill soldent le prêt en cours.

Ce guide part du principe que vous avez suivi le guide de configuration de l’API.

Cycle de vie des offres Refill

1. L’admissibilité aux offres Refill des utilisateurs actifs de Capital est évaluée quotidiennement par Stripe, comme pour les offres standard.

2. Lorsqu’une offre de recharge est créée, vous recevez un capital.financing_offer.created webhook qui contient "product_type": "refill" pour indiquer qu’il s’agit bien d’une offre de recharge.

3. En fonction des champs product_type et offered_terms.campaign_type, utilisez des messages approuvés pour communiquer l’offre de financement au client.

4. Le client accède au formulaire de demande de financement Refill avec la configuration de lien de compte illustrée dans le guide de configuration de l’API. L’utilisateur peut déplacer un curseur personnalisé jusqu’au montant maximal de l’offre.

   

   Demande de financement Refill

   

   Demande de financement Refill

5. Les clients qui acceptent l’offre de renouvellement peuvent se voir proposer une réduction, pris sous la forme d’un pourcentage sur la prime restante de leur prêt en cours. Ce taux de réduction est indiqué sous la rubrique previous_financing_fee_discount_rate sous offered_terms.

6. Si le client accepte l’offre de renouvellement, nous envoyons un webhook capital.financing_offer.accepted. La charge du webhook contient un champ accepted_terms avec les montants sélectionnés par le client. Le champ previous_financing_fee_discount_amountest défini sur null tant que le financement précédent n’a pas été entièrement remboursé et que nous n’avons pas déterminé le montant de la réduction. S’il n’y a pas de réduction, le champ previous_financing_fee_discount_amount reste sur null même après que le financement précédent a été entièrement remboursé.

   Exemple de webhook :

   {
       "type": "capital.financing_offer.accepted",
       "api_version": "2022-02-28",
       "created": 123456789,
       "data": {
           "object": {
               "id": "financingoffer_abcdef123456",
               "object": "capital.financing_offer",
               "account": "acct_abcdef123456",
               "created_at": 123456789,
               "expires_after": 123456789,
               "livemode": true,
               "status": "accepted",
               "accepted_terms": {
                   "currency": "usd",
                   "advance_amount": 100000,
                   "fee_amount": 10000,
                   "withhold_rate": 0.15,
                   "previous_financing_fee_discount_amount": null
               },
               "financing_type": "flex_loan",
               "offered_terms": {
                   "currency": "usd",
                   "advance_amount": 100000,
                   "fee_amount": 10000,
                   "withhold_rate": 0.15,
                   "campaign_type": "repeat_user",
                   "previous_financing_fee_discount_rate": 0.5
               },
               "product_type": "refill"
           }
       }
   }

7. Le nouveau prêt permet tout d’abord de rembourser et de clôturer le prêt en cours du client, qui perçoit la différence. Le virement correspondant au nouveau prêt génère l’envoi du webhook capital.financing_offer.paid_out. Le champ previous_financing_fee_discount_amount est alors défini.

8. Récupérez le récapitulatif du financement pour afficher des informations sur le montant de financement remboursé (paid_out) du client.

   Exemple de réponse :

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

9. Vous trouverez également des informations sur le financement Refill ainsi que sur le financement initial sur la page de rapport sur les financements.

Rapport hébergé du prêt initial

Rapport hébergé sur le nouveau prêt rechargé