# Effectuer des recherches dans le Dashboard Le Dashboard vous permet de rechercher des paiements, des clients, et bien plus. [Stripe Sigma](https://docs.stripe.com/stripe-data.md) met à disposition toutes les données de votre entreprise sous la forme d’un environnement SQL interactif dans le Dashboard. Vous pouvez l’utiliser pour effectuer des recherches très avancées et générer des rapports personnalisés. Utilisez la fonction de recherche du Dashboard pour trouver des ressources importantes et parcourir les différentes ressources Stripe, comme les *comptes connectés* (A person or business accepting payments or receiving payouts on a Connect platform), *clients* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments), *factures* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice), *virements* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) et *produits* (Products represent what your business sells—whether that's a good or a service). Lorsque vous effectuez une recherche, les premiers résultats sont affichés immédiatement. Affichez tous les résultats en cliquant sur **Afficher tous les résultats** ou en appuyant sur **Entrée**. Dans les résultats de la recherche, cliquez sur **Afficher tout** pour voir une liste détaillée organisée en colonnes dont certaines sont dotées d’options de tri. ## Démarrer Utiliser différents éléments d’information comme termes de recherche - Les quatre derniers chiffres d’une carte ou d’un numéro de compte (**4242**). - Le type de moyen de paiement (**iDEAL**). - Nom de l’entreprise d’un compte Stripe connecté (**Rocketship**). - Le numéro de reçu par courriel (**1817-9523**). Pour les recherches qui nécessitent des dates, vous pouvez utiliser différents formats, comme **08/22**, **2020-07-12** ou **la semaine dernière**. Utilisez les identifiants d’objet (ID de litige) pour être dirigé directement vers l’objet que vous recherchez. La plupart des recherches ne nécessitent aucun contexte supplémentaire. Le Dashboard recherche automatiquement les informations les plus pertinentes en fonction de votre requête. Vous pouvez utiliser des filtres et des opérateurs de recherche pour un contrôle plus granulaire. ## Filtres et opérateurs de recherche Par défaut, le Dashboard recherche des valeurs qui correspondent à votre terme de recherche dans les champs les plus logiques des objets. (Par exemple, il recherchera une adresse courriel dans le champ `email` ou une description d’objet.) Vous pouvez utiliser des filtres et des opérateurs pour affiner vos recherches. Plus vous fournissez de termes dans votre requête de recherche, moins le nombre de résultats sera élevé. #### Filtres Utilisez des filtres pour limiter vos termes de recherche de façon à ce qu’ils ne s’appliquent qu’à des champs précis d’objets donnés. Faites précéder un terme de recherche par l’un de ces filtres. Si le terme de recherche doit comporter un espace, mettez-le entre guillemets, (`name:"John Doe"`). Des objets différents ont parfois des champs en commun. Par exemple, le champ `amount` s’applique, par exemple, aux paiements, aux factures et aux virements. | Filtrer | Description | Exemple | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | | `amount:` | Le montant d’un objet. Pour les devises à décimales, veuillez utiliser un séparateur décimal entre les deux unités monétaires (par exemple, les euros et les centimes). | **amount:149,99** | | `brand:` | La marque de la carte associée à un objet. | **brand:visa** | | `country:` | Le [code ISO](https://en.wikipedia.org/wiki/ISO_3166-1) à deux lettres qui désigne le pays associé à un objet. | **country:RU** | | `created:` | La date de création d’un objet (identique à `date`). | **created:12/07/2020** | | `currency:` | Le [code ISO](https://en.wikipedia.org/wiki/ISO_4217) à trois lettres qui désigne la devise d’un objet. | **currency:EUR** | | `date:` | La date de création d’un objet (identique à `created`). | **date:hier** | | `email:` | L’adresse de courriel (complète ou partielle) d’un objet. | **email:jenny.rosen@example.com** | | `exp:` | La date d’expiration de la carte associée à un objet. | **exp:22/08** | | `flow:` | Le type de [flux ou d’action client](https://docs.stripe.com/sources.md#flow-for-customer-action) qui s’applique à un paiement [Sources](https://docs.stripe.com/sources.md). | **flow:redirection** | | `last4:` | Les quatre derniers chiffres de la carte ou du numéro de compte associé à un objet. | **last4:4080** | | `metadata:` | La valeur des [métadonnées](https://docs.stripe.com/api.md#metadata) liées à un objet pris en charge. Des [options de recherche](https://docs.stripe.com/dashboard/search.md#metadata-searches) supplémentaires liées aux métadonnées sont disponibles. | **metadata:555-5555** | | `name:` | Le nom du titulaire de la carte ou du client associé à un objet. | **name:jenny** | | `number:` | Le numéro unique qui identifie une facture. | **number:06b2b1a642-0023** | | `postal:` | Le code postal associé à un objet. | **postal:12345** | | `receipt:` | Le numéro d’un reçu de paiement ou de remboursement transmis par courriel. | **receipt:3330-2392** | | `risk_level:` | Le [niveau de risque](https://docs.stripe.com/radar/risk-evaluation.md) d’un paiement déterminé par [Radar](https://docs.stripe.com/radar.md). | **risk\_level:elevated** | | `status:` | L’état d’un objet. | **status:canceled** | | `type:` | Le type de [PaymentMethod](https://docs.stripe.com/payments/payment-methods.md) ou [Source](https://docs.stripe.com/sources.md) utilisé pour créer un paiement. | **type:ideal** | | `usage:` | La fréquence [d’utilisation](https://docs.stripe.com/sources.md#single-use-or-reusable) d’un moyen de paiement [Sources](https://docs.stripe.com/sources.md). | **usage:single\_use** | | `zip:` | Le code postal associé à un objet. | **zip:12345** | #### Opérateurs Lorsque vous recherchez les montants suivants et les dates suivantes, ces opérateurs vous permettent d’affiner votre recherche sur une fourchette donnée. | Opérateur | Description | Exemple | | --------- | ------------------------------------------------------------- | ---------------------- | | `>` | Supérieur à un montant donné ou postérieur à une date donnée. | **amount:>149,99** | | `<` | Inférieur à un montant donné ou antérieur à une date donnée. | **date:<12-07-2020** | | `..` | Compris dans une fourchette de dates ou de montants. | **amount:50,00…99,99** | Vous pouvez également utiliser l’opérateur booléen `is:` pour filtrer les résultats en fonction d’un type d’objet ou d’un état précis. Utilisez `is:` avec un type d’objet pour afficher uniquement les résultats de ce type. | Opérateur | Description | Exemple | | ------------------ | ---------------------------------------------------- | ------------------------ | | `account` | Un compte connecté. | **is:account** | | `charge` | Un paiement (identique à `payment`). | **is:charge** | | `checkout_session` | Une session de paiement. | **is:checkout\_session** | | `coupon` | Un bon de réduction. | **is:coupon** | | `credit_note` | Une note de crédit. | **is:credit\_note** | | `customer` | Un client. | **is:customer** | | `dispute` | Une contestation. | **is:dispute** | | `document` | Un document. | **is:document** | | `invoice` | Une facture. | **is:invoice** | | `invoiceitem` | Un poste de facture. | **is:invoiceitem** | | `order` | Une commande. | **is:order** | | `payment` | Un paiement (identique à `charge`). | **is:payment** | | `payment_intent` | Une intention de paiement | **is:payment\_intent** | | `payment_link` | Un lien de paiement. | **is:payment\_link** | | `payment_method` | Une mode de paiement. | **is:payment\_method** | | `payout` | Un virement. | **is:payout** | | `plan` | Un plan d’abonnement. | **is:plan** | | `price` | Un tarif. | **is:price** | | `product` | Un produit. | **is:product** | | `promotion_code` | Un code promotionnel. | **is:promotion\_code** | | `quote` | Un devis. | **is:quote** | | `refund` | Un remboursement. | **is:refund** | | `setup_intent` | Une intention de configuration | **is:setup\_intent** | | `source` | Une [source](https://docs.stripe.com/sources.md). | **is:source** | | `subscription` | Un abonnement. | **is:subscription** | | `transfer` | Un transfert de fonds d’un compte Stripe à un autre. | **is:transfer** | Utilisez `is:` avec un état pour afficher uniquement les résultats correspondant à cet état. | Opérateur | Description | Exemple | | ----------- | ------------------------------------------------------------- | ---------------- | | `active` | Un forfait, un prix ou une carte-cadeau en cours de validité. | **is:active** | | `captured` | Un paiement qui a été capturé. | **is:captured** | | `disputed` | Un paiement qui a été contesté. | **is:disputed** | | `paid` | Un paiement effectué ou une facture réglée. | **is:paid** | | `recurring` | Un prix récurrent. | **is:recurring** | | `refunded` | Un paiement qui a été remboursé. | **is:refunded** | ### Combiner et ignorer des termes de recherche Utilisez plusieurs termes de recherche pour affiner votre recherche. Vous pouvez également annuler un filtre de recherche par un trait d’union (`-`) afin que les résultats correspondant à ce filtre ne soient pas pris en compte. | Exemple | Description | | --------------------------------- | ---------------------------------------------------------------------------------------------------- | | `type:card last4:4242 exp:08/22` | Les quatre derniers chiffres de la carte sont `4242` et la date d’expiration est `08/22`. | | `type:card last4:4242 -exp:08/22` | Les quatre derniers chiffres de la carte sont `4242` et la date d’expiration n’est *pas* `08/22`. | | `type:ideal status:annulé` | Les paiements iDEAL dont la source a été annulée et n’a pas été utilisée pour effectuer un paiement. | Pour rechercher une expression, utilisez des guillemets. Par exemple, **« Stripe Shop »** donne les résultats liés à cette expression complète, mais **Stripe Shop** recherche les mots **Stripe** et **Shop** séparément. ### Recherche dans les métadonnées Vous pouvez effectuer des recherches sur des [métadonnées](https://docs.stripe.com/api.md#metadata) que vous avez ajoutées aux objets qui les prennent en charge. Par exemple, vous pouvez trouver des documents qui ont la clé de métadonnées `order_id` avec la valeur de métadonnées correspondante `xyn712` à l’aide de l’une des requêtes de recherche suivantes : - `xyn712` - `order_id:xyn712` - `metadata:xyn712` - `metadata:order_id=xyn712` ## Recherche au sein d’une organisation Une fois que vous avez ajouté plusieurs comptes Stripe à une [organisation](https://docs.stripe.com/get-started/account/orgs.md), les membres de votre équipe peuvent effectuer une recherche dans tous les comptes auxquels ils ont accès. Par défaut, les recherches affichent les résultats relatifs à tous ces comptes. Si un membre de l’équipe consulte le Dashboard à partir d’un compte, il peut effectuer une recherche uniquement dans ce compte à partir de l’option à cet effet dans le menu déroulant de recherche. ## Bonnes pratiques Il est possible d’effectuer de nombreuses recherches à l’aide d’un seul terme. Veuillez utiliser un élément précis, comme un nom ou une adresse de courriel. Si le nombre de résultats est insuffisant, veuillez utiliser un terme moins précis. Si les résultats sont trop nombreux, veuillez ajouter d’autres termes à raison d’un à la fois. Veuillez élargir la fourchette de valeurs lorsque vos termes de recherche sont des dates ou des montants. Les conversions de devise et le décalage horaire entre vous et votre client sont souvent une source de confusion lors d’une recherche portant sur un paiement. Dans ces cas, des termes de recherche supplémentaires, voire des termes différents en même temps, peuvent être utiles. > #### Recherches de signets > > Les termes de recherche étant inclus dans l’URL, vous pouvez ajouter la recherche à vos favoris ou la communiquer à vos collègues comme vous le feriez avec une autre page Web.