RemplacementsVersion bêta privée

Découvrez comment gérer les offres de financement de remplacement.

Version bêta privée

Les remplacements d’offres de financement ne sont pas activés par défaut. Après avoir mis à jour votre intégration pour prendre en charge les remplacements, vous devez nous contacter pour les activer.

L’application de financement Capital offre aux utilisateurs de comptes connectés la possibilité de lier des données de tiers pour recevoir de nouvelles conditions d’offre, telles qu’un montant de prêt plus élevé. Les remplacements d’offres de financement donnent à une plateforme une visibilité sur l’historique des offres de ses utilisateurs.

Sans remplacement, lorsqu’un compte reçoit une offre avec de nouvelles conditions, Stripe met à jour l’offre de financement existante. La plateforme ne peut accéder à aucun enregistrement des offres précédentes.

Lorsque les remplacements sont activés, Stripe crée à la place un objet FinancingOffer représentant la nouvelle offre. La plateforme peut accéder à la fois aux offres existantes et aux nouvelles offres.

L’exemple suivant illustre la réception d’une offre de remplacement par un utilisateur :

Stripe créée une offre de financement non livrée pour l’utilisateur, d’un montant de maximal de 5 000 $.
Votre plateforme envoie l’offre à l’utilisateur par e-mail et marque l’offre comme envoyée.
L’utilisateur accède à la demande d’offre de financement Capital et associe son compte bancaire.
Stripe détermine que l’utilisateur peut désormais bénéficier d’un prêt de 10 000 $ maximum.
Stripe remplace l’offre initiale de l’utilisateur, dont le montant était de 5 000 $, par une nouvelle offre de 10 000 $.

Ce guide explique comment gérer les remplacements d’offre. Nous partons du principe que vous avez suivi le guide de configuration de l’API.

Créer une offre de financement test livrée

Dans un environnement de test, accédez au Dashboard Capital pour créer une nouvelle offre de financement test avec l’état livré.

Remplacer l'offre

Cliquez sur le menu de débordement () en regard de l’offre reçue, puis sélectionnez Remplacer l’offre.

Remarque

L’option Remplacer l’offre s’affiche uniquement pour les offres à l’état « Livrée » ou « Non livrée » qui n’ont encore jamais été remplacées.

Cliquez sur Remplacer en bas de la fenêtre pour remplacer l’offre.

Stripe envoie le webhook capital.financing_offer.replacement_created à la création d’une offre de financement de remplacement. Le corps du webhook contient des informations sur l’offre de financement de remplacement.

{
    "type": "capital.financing_offer.replacement_created",
    "data": {
        "object": {
            "id": "financingoffer_xyz456",
            "object": "capital.financing_offer",
            "account": "acct_efg678",
            "status": "delivered",
            "financing_type": "flex_loan",
            "offered_terms": {
                "currency": "usd",
                "advance_amount": 100000,
                "fee_amount": 10000,
                "withhold_rate": 0.15,
            },
            "replacement_for": "financingoffer_abc123",
            ...
        }
    }
}

Notez que l’offre de remplacement est à l’état « Livrée ». Quand un utilisateur reçoit une offre de financement de remplacement, celle-ci devient son offre active en cours.

Mettez à jour votre intégration des webhooks pour gérer le webhook capital.financing_offer.replacement_created. Si vos modèles de données internes stockent l’ID de l’offre de financement active de l’utilisateur, veillez à mettre à jour l’ID avec l’offre de remplacement de l’utilisateur.

Récupérer l'offre remplacée

Une fois l’offre remplacée, vous êtes redirigé(e) vers une page contenant des informations sur l’offre de remplacement. Le tableau des événements contient un événement Le Compte acct_egg678 dispose d’une offre de financement pour financingoffer_abc123, indiquant l’ID de l’offre initiale de l’utilisateur.

Récupérez financingoffer_abc123. Notez que son état est « Remplacée » et que la valeur de l’attribut replacement est financingoffer_xyz456, ce qui signifie que financingoffer_xyz456 a remplacé financingoffer_abc123.

{
  "id": "financingoffer_abc123",
  "object": "capital.financing_offer",
  "status": "replaced",
  "replacement": "financingoffer_xyz456",
  ...
}

L’état « Remplacée » est définitif. Si un utilisateur accepte son offre de remplacement, tous les états ultérieurs de l’offre affecteront l’offre de remplacement.