RemplacementsVersion bêta privée

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

L’application de financement Capital permet aux utilisateurs d’associer des données tierces afin de mettre à jour les offres proposées, dont le montant pourra par exemple être plus élevé. Lorsqu’un utilisateur reçoit une offre mise à jour, Stripe créée une offre de financement de remplacement.

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.

Bêta

Par défaut, les remplacements ne sont pas activés pour les plateformes API Capital. Après avoir mis à jour votre intégration de manière à en prendre en charge les remplacements, contactez-nous pour les activer.

Créer une offre livrée en mode test

Depuis le Dashboard, créez une nouvelle offre de financement à l’état « Livrée » en mode test.

Remplacer l'offre

Cliquez sur les trois points à la fin de la ligne correspondant à l’offre livrée, puis sélectionnez l’option Remplacer l’offre.

Note

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.