RemplacementsVersion bêta publique

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

Version bêta publique

Capital pour les plateformes est disponible en version bêta publique. Inscrivez-vous pour rejoindre Capital.

Les demandes de financement Capital permettent aux comptes connectés d’associer des données tierces pour recevoir des conditions de financement mises à jour, par exemple un montant de financement plus élevé. Les remplacements d’offres de financement donnent à votre plateforme une visibilité sur l’historique des offres de vos comptes connectés. Ce guide décrit comment gérer les remplacements d’offres de financement.

Sans remplacement, lorsqu’un compte reçoit une offre avec de nouvelles conditions, Stripe met à jour l’offre de financement en cours. Votre plateforme ne peut accéder à aucune trace des offres précédentes. Avec les remplacements, Stripe crée un objet FinancingOffer représentant la nouvelle offre, ce qui donne à votre plateforme la possibilité d’accéder à la fois aux offres en cours et nouvelles.

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

Stripe crée une offre de financement non livrée pour le compte connecté, d’un montant de prêt maximal de 5 000 USD.
Votre plateforme envoie l’offre au compte connecté par e-mail et marque l’offre comme envoyée.
Le compte connecté accède à la demande de financement Capital et lie son compte bancaire.
Stripe détermine que le compte connecté est admissible à un nouveau montant maximal de prêt de 10 000 USD.
Stripe remplace l’offre initiale de 5 000 USD du compte connecté par une nouvelle offre de 10 000 USD.

Avant de commencer

Dans ce guide, nous partons du principe que vous avez effectué une intégration API.
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.

Créer une offre de financement test livrée

[Créer un environnement de test]](/sandboxes/dashboard/manage#create-a-sandbox).
Accédez à la page Capital dans le Dashboard.
Pour générer une offre test, cliquez sur Créer et sélectionnez les paramètres de création de l’offre.
- Pour le compte connecté, sélectionnez un compte connecté existant en recherchant l’ID du compte ou laissez ce champ vide pour que Stripe crée un compte pour vous.
- Vous pouvez sélectionner le type d’offre et, s’il s’agit d’une recharge, le compte test. Vous pouvez également sélectionner les conditions de l’offre (montant, frais et taux de remboursement).
- Si vous préférez, créez un compte connecté dans le Dashboard Stripe.
- Pour les offres de test, il n’est pas nécessaire d’associer le compte bancaire.
- Affichez les détails du compte connecté que vous venez de créer : https://dashboard.stripe.com/test/connect/accounts/:merchant_id.
Avant de finaliser la création de l’offre en cliquant sur Créer une offre de financement, définissez d’abord l’état de l’offre sur delivered, car l’envoi réel de l’offre par e-mail n’est pas nécessaire pour les tests.
Cliquez sur Créer une offre de financement afin de créer l’offre pour le compte connecté de test.
Le résultat est une offre de financement test livrée. Dans le Dashboard, vous pouvez consulter chaque offre de financement pour vos comptes connectés sur la page Rapports financiers. Vous pouvez consulter les indicateurs sur la page Aperçu du financement.

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 qui n’ont jamais été remplacées et dont l’état est « Livrée » ou « Non livrée ».

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",
            ...
        }
    }
}

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

Mettez à jour votre intégration du webhooks pour gérer le webhook capital.financing_offer.replacement_created. Si vos modèles de données internes stockent l’identifiant de l’offre de financement active de l’utilisateur, veillez à mettre à jour l’identifiant 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. Veuillez noter que l’état est remplacé et que l’attribut remplacement a la valeur financingoffer_xyz456, indiquant 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 le compte connecté accepte son offre de remplacement, tous les états ultérieurs de l’offre affecteront l’offre de remplacement.

Voir aussi

Configurer une intégration API