# Tester Financial Connections

Comment tester votre intégration en simulant des comptes Financial Connections.

## Premiers pas avec les environnements de test

Consultez la documentation relative aux [tests](https://docs.stripe.com/testing.md) pour savoir comment tester votre intégration Stripe.

Pour tester Financial Connections, suivez le [guide des cas d’usage](https://docs.stripe.com/financial-connections/use-cases.md) à l’aide d’un *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) et des clés API de test associées. Les comptes et clients créés dans un environnement de test sont invisibles pour votre intégration du mode production.

> Le [flux d’authentification](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow) Financial Connections étant susceptible d’évoluer, nous ne recommandons pas les tests automatiques côté client. L’utilisation de l’API de Stripe avec des clés d’environnement de test est soumise à une [limite](https://docs.stripe.com/testing.md#rate-limits). Pensez à en tenir compte lors de vos tests.

## Comment utiliser des comptes et des établissements de test [Côté serveur]

Lorsque vous fournissez à [Stripe.js](https://docs.stripe.com/js.md) un token de session Financial Connections créé à l’aide de clés d’environnement de test, le [flux d’authentification](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow) présente exclusivement une sélection d’établissements de test gérés par Stripe. Le client peut ainsi associer des comptes de ces établissements, sans avoir à fournir d’informations d’identification.

Les fonctionnalités telles que les [soldes](https://docs.stripe.com/financial-connections/balances.md), la [propriété du compte](https://docs.stripe.com/financial-connections/ownership.md) et les [transactions](https://docs.stripe.com/financial-connections/transactions.md) fonctionnent de la même manière qu’en mode production, sauf qu’elles renvoient des données de test au lieu de données de compte réelles.

Les *webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) d’environnement de test sont distincts des webhooks dynamiques. Découvrez comment [tester vos intégrations de webhook](https://docs.stripe.com/webhooks.md#test-webhook).

## Test des différents scénarios d'authentification de l'utilisateur [Côté client]

Stripe propose un ensemble d’institutions de test simulant différents scénarios de succès et d’échec, chacun disponible soit dans la liste des institutions mises en avant, soit dans les résultats de recherche d’institutions du flux d’authentification.

#### Simuler une authentification réussie

- **Test (Non-OAuth)** : simule la connexion réussie de l’utilisateur à son établissement sur un formulaire hébergé par Stripe et contient un ensemble de comptes de test de base.
- **Test (OAuth)** : contient les mêmes comptes de test que Test (non-OAuth), mais plutôt que de proposer une authentification via la fenêtre modale, s’ouvre dans une fenêtre contextuelle OAuth.
- **Banque (non-OAuth)** : fournit un formulaire de connexion hébergé par Stripe pour simuler des établissements qui ne prennent pas en charge OAuth. Cette option est la plus représentative de l’association de comptes pour la majorité des établissements non-OAuth en mode production. Utilisez les identifiants de test suivants pour poursuivre :
  - L’invite initiale demande le nom d’utilisateur et le mot de passe. La saisie de n’importe quelle valeur simule une connexion réussie.
  - Dans le champ du mot de passe ou dans tout autre champ suivant, saisissez `options` (sélection dans une liste), `mfa` (saisie d’un code d’accès ponctuel), `confirm_mfa` (confirmation d’un code d’accès ponctuel) ou `security_question` (saisie d’une réponse secrète) pour accéder à d’autres invites de connexion.
  - La saisie de `error` dans n’importe quel champ met fin à la session de connexion ; `incorrect` vous permet d’effectuer un nouvel essai.
- **Bank (OAuth)** : fournit une fenêtre contextuelle OAuth d’un établissement test qui vous permet de sélectionner les comptes à associer. Cette option est la plus représentative de la liaison de comptes pour la majorité des établissements en mode production.
- **Comptes de propriété** : contient des comptes de test représentant différents états de propriété.
- **Comptes de paiement non valide** : contient des comptes de test qui ne peuvent pas être utilisés pour les paiements ACH.

#### Simuler un échec d’authentification

- **Interruption du système (Programmée)** : L’API de connexion de l’établissement est indisponible pendant une période préalablement communiquée à Stripe.
- **Interruption du système (non programmée)** : L’API de connexion de l’établissement n’est pas disponible, et aucune information sur les temps d’indisponibilité n’a été communiquée à Stripe.
- **Interruption du système (Erreur)** : Stripe rencontre une erreur inconnue dans la communication avec l’établissement.

> Nous vous recommandons de tester les institutions OAuth et non-OAuth manuellement pour vous assurer que ces deux flux d’interface utilisateur fonctionnent dans le contexte de votre application. Consultez la [documentation supplémentaire](https://docs.stripe.com/financial-connections/fundamentals.md#how-stripe-links-financial-accounts) pour connaître les différences entre les connexions OAuth et non-OAuth.

#### Simulation du comportement des numéros de compte tokenisés

Vous pouvez tester différents comportements des [numéros de compte tokenisés](https://docs.stripe.com/financial-connections/tokenized-account-numbers.md) en recherchant l’institution « Numéro de compte tokenisé » dans la barre de recherche. Chaque compte présente un comportement asynchrone différent :

- **Numéro de compte tokenisé expiré** : le TAN renvoyé par la session a l’état `deactivated`.
- **Numéro de compte tokenisé arrivant à expiration** : le TAN expirera dans 30 jours et déclenchera l’événement webhook `financial_connections.account.upcoming_account_number_expiry`.
- **Numéro de compte tokenisé arrivant à expiration immédiatement** : le TAN expirera immédiatement après la session et déclenchera l’événement webhook `financial_connections.account.account_numbers_updated`.

#### Simulation de la désactivation de compte

Cherchez l’institution « Comptes inactifs » et liez l’un des comptes disponibles. Peu après avoir terminé le flux d’authentification, les comptes liés à cette institution passent de `active` à `inactive`. [Réassociez](https://docs.stripe.com/financial-connections/relink.md) le compte pour le faire revenir à `active.

#### Simuler la sélection d’un autre compte lors de la réassociation

Pour tester le scénario dans lequel un client sélectionne un compte différent lors d’une session de réassociation dans un établissement OAuth :

1. Utilisez le flux d’authentification pour associer les comptes auprès de la **banque (OAuth)**, mais sélectionnez seulement certains des comptes disponibles dans la fenêtre modale OAuth.
1. Créez une session de réassociation pour l’un des comptes associés, ou pour l’autorisation.
1. Lors du flux de réassociation, sélectionnez, dans la fenêtre modale OAuth, un ensemble de comptes différent de celui choisi lors du flux d’authentification initial.