# Remplacements

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

> Capital pour les plateformes est disponible en [version bêta publique](https://docs.stripe.com/release-phases.md).

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](https://docs.stripe.com/api/capital/connect_financing_object.md) 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é :

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

## Before you begin

- Dans ce guide, nous partons du principe que vous avez effectué une [intégration API](https://docs.stripe.com/capital/api-integration.md).
- Les remplacements d’offres de financement ne sont pas activés par défaut. Après avoir mis à jour votre intégration afin de prendre en charge ces remplacements, vous devez soumettre à Stripe les informations relatives à votre intégration et à votre utilisation de l’API pour une revue de conformité, via le [formulaire de demande de modification](https://form.asana.com/?k=8K51UWmWhttehNFD5qBLdg&d=974470123217835).

## Créer une offre de financement test livrée

1. [Créer un environnement de test]](/sandboxes/dashboard/manage#create-a-sandbox).

1. Accédez à la page [Capital](https://dashboard.stripe.com/test/connect/capital) dans le Dashboard.

1. 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](https://docs.stripe.com/connect/dashboard/managing-individual-accounts.md#creating-accounts).
   - 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`.

1. 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.

1. 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 `delivered`. Dans le Dashboard, vous pouvez consulter chaque offre de financement pour vos comptes connectés sur la page [Financing Reporting](https://dashboard.stripe.com/test/connect/capital/financing_offers). Vous pouvez consulter les [metrics](https://docs.stripe.com/capital/reporting.md) sur la page [Financing Overview](https://dashboard.stripe.com/test/connect/capital).

## Remplacer l'offre

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

   > L’option **Remplacer l’offre** s’affiche uniquement pour les offres qui n’ont jamais été remplacées et dont le `status` est `undelivered` ou `delivered`.

1. 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](https://docs.stripe.com/api/capital/connect_financing_object.md) de remplacement. Le corps du webhook contient des informations sur l’offre de financement de remplacement.

   ```json
   {
       "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.

1. Mettez à jour votre intégration du *webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) 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.

[Retrieve](https://docs.stripe.com/api/capital/financing_offers/retrieve.md#retrieve_financing_offer) `financingoffer_abc123`. Veuillez noter que l’état est `replaced` et que l’attribut `remplacement` a la valeur `financingoffer_xyz456`, indiquant que `financingoffer_xyz456` a remplacé `financingoffer_abc123`.

```json
{
  "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.

## See also

- [Configurer une intégration API](https://docs.stripe.com/capital/api-integration.md)