Offres RefillVersion bêta publique

Les offres de renouvellement sont des offres de financement supplémentaires envoyées aux comptes connectés qui ont fait des progrès substantiels dans le remboursement de leur solde d’offre de financement en cours. Si elles sont approuvées, les offres de renouvellement remboursent le solde restant sur le solde en cours.

Avant de commencer

• Dans ce guide, nous partons du principe que vous avez effectué une intégration API.
• Les renouvellements ne sont pas activés par défaut. Après avoir mis à jour votre intégration pour prendre en charge les renouvellements, vous devez nous contacter pour activer les offres de renouvellement.

Cycle de vie des offres Refill

1. Stripe évalue quotidiennement l’éligibilité au renouvellement de financement des comptes connectés actifs à Capital.

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 compte connecté accède à l’application Refill avec la même configuration de lien de compte que celle du guide de configuration de l’API. Le compte connecté peut ajuster un curseur personnalisé jusqu’au montant maximal de l’offre admissible.

   

   Demande de financement Refill

   

   Demande de financement Refill

5. Connected accounts who accept the refill offer might be offered a discount (taken as a percentage on the remaining premium of their existing balance). This discount rate is exposed as previous_financing_fee_discount_rate under 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 financement permet tout d’abord de rembourser et de clôturer le financement en cours du client, qui perçoit la différence. Le virement correspondant au nouveau financement génère l 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.

   

   Rapports hébergés de l’offre de financement initiale

   

   Rapports hébergés sur l’offre de financement nouvellement renouvelée