Offres RefillVersion bêta privée

Les offres Refill sont des offres de financement supplémentaire proposées aux clients ayant un prêt en cours, dont ils ont déjà remboursé une grande partie. Lorsqu’elles sont acceptées, les offres Refill remboursent le solde restant du prêt en cours et permettent de réduire les frais restant à payer sur le prêt.

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 Refill se voient proposer une réduction, exprimée en pourcentage de la prime restante de leur prêt en cours. Le taux de cette réduction est calculé comme suit : offered_terms sur previous_financing_fee_discount_rate.

6. Si le client accepte l’offre Refill, nous envoyons un capital.financing_offer.accepted webhook. La charge utile du webhook comporte un champ accepted_terms indiquant les montants sélectionnés par le client. Le champ previous_financing_fee_discount_amount conserve la valeur null tant que le financement précédent n’a pas été entièrement remboursé et que le montant de la réduction n’a pas été déterminé.

   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é