# 在管理平台内执行搜索操作

用管理平台搜索付款、客户等等

[Stripe Sigma](https://docs.stripe.com/stripe-data.md) 可以让您在管理平台的一个交互式 SQL 环境下获取您的所有业务数据。您可以用它执行高级搜索并生成自定义报告。

使用管理平台的搜索功能查找重要资源，并浏览不同的 Stripe 资源，例如 *Connect 子账户* (A person or business accepting payments or receiving payouts on a Connect platform)、*客户* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)、*账单* (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)、*提现* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)和*产品* (Products represent what your business sells—whether that's a good or a service)。

执行搜索时，最前面的结果会立即出现。点击**查看所有结果**或按下**回车键**来查看所有匹配的内容。从搜索结果分组中，可以点击**查看全部**来查看包含列标题的扩展结果，其中有些提供了筛选选项。

## 开始

使用不同信息片段作为关键词：

- 银行卡或账号的最后四位 (**4242**)。
- 支付方式类型 (**iDEAL**)。
- Connect 子账户的商家名称 (**Rocketship**)。
- 邮件收据编号 (**1817-9523**)。

执行需要日期的搜索操作时，可提供不同日期格式，例如 **08/22**、**2020-07-12** 或**上周**。使用对象标识符（争议 ID），可直接找到要查找的对象。多数搜索不需要额外的上下文。管理平台会根据您的搜索查询自动查找最相关的信息。利用搜索筛选器和运算符可以进行更细度的控制。

## 搜索筛选器和运算符

默认情况下，管理平台会在对象的大多数逻辑字段中查找与您的搜索词匹配的值。（例如，它会在 `email` 字段中查找电子邮件地址或对象描述。)可以用筛选器和运算符使搜索结果更加精确。在搜索查询中提供的条件越多，搜索结果就越少。

#### 筛选器

用筛选器限制关键词，仅应用到适用对象内的特定字段。用其中某个筛选器作为关键词的开头。如果您的关键词必须包含空格，则把它包在引号中 (`name:"John Doe"`)。不同对象中有很多共用字段。例如，`amount` 适用于付款、账单、提现等。

| 筛选            | 描述                                                                                                                                     | 示例                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `amount:`     | 某个对象的金额。对于十进制货币，货币单位都要用小数点（例如，美元和美分）。                                                                                                  | **amount:149.99**                 |
| `brand:`      | 某个对象关联的银行卡的品牌。                                                                                                                         | **brand:visa**                    |
| `country:`    | 表示某个对象关联的国家的两字母 [ISO 代码](https://en.wikipedia.org/wiki/ISO_3166-1)。                                                                    | **country:GB**                    |
| `created:`    | 某个对象的创建日期（同 `date`）。                                                                                                                   | **created:2020/07/12**            |
| `currency:`   | 表示某个对象的货币三字母 [ISO 代码](https://en.wikipedia.org/wiki/ISO_4217)。                                                                         | **currency:EUR**                  |
| `date:`       | 某个对象的创建日期（同 `created`）。                                                                                                                | **date:yesterday**                |
| `email:`      | 某个对象的邮件地址（完整地址或部分）。                                                                                                                    | **email:jenny.rosen@example.com** |
| `exp:`        | 某个对象关联的银行卡的有效期。                                                                                                                        | **exp:08/22**                     |
| `flow:`       | 应用到 [Source](https://docs.stripe.com/sources.md) 支付方式的[客户操作流程](https://docs.stripe.com/sources.md#flow-for-customer-action)的类型。        | **flow:redirect**                 |
| `last4:`      | 与某个对象关联的卡号或账号末四位数字。                                                                                                                    | **last4:4080**                    |
| `metadata:`   | 支持的对象的[元数据](https://docs.stripe.com/api.md#metadata)值。为元数据提供有额外的[搜索选项](https://docs.stripe.com/dashboard/search.md#metadata-searches)。 | **metadata:555-5555**             |
| `name:`       | 某个对象关联的持卡人或客户的名字。                                                                                                                      | **name:jenny**                    |
| `number:`     | 识别账单的唯一号码。                                                                                                                             | **number:06b2b1a642-0023**        |
| `postal:`     | 某个对象关联的邮编。                                                                                                                             | **postal:12345**                  |
| `receipt:`    | 付款或退款的邮件收据中使用的收据编号。                                                                                                                    | **receipt:3330-2392**             |
| `risk_level:` | [Radar](https://docs.stripe.com/radar.md) 判定的某笔付款的[风险等级](https://docs.stripe.com/radar/risk-evaluation.md)。                            | **risk\_level:elevated**          |
| `status:`     | 某个对象的状态。                                                                                                                               | **status:canceled**               |
| `type:`       | 用于创建付款的 [PaymentMethod](https://docs.stripe.com/payments/payment-methods.md) 或 [Source](https://docs.stripe.com/sources.md) 的类型。       | **type:ideal**                    |
| `usage:`      | [Source](https://docs.stripe.com/sources.md) 支付方式可以使用的[用法](https://docs.stripe.com/sources.md#single-use-or-reusable)。                 | **usage:single\_use**             |
| `zip:`        | 某个对象关联的邮编。                                                                                                                             | **zip:12345**                     |

#### 运算符

搜索金额和日期时可以用以下运算符将搜索结果精确到特定范围。

| 运算符  | 描述                | 示例                     |
| ---- | ----------------- | ---------------------- |
| `>`  | 大于某个金额，或晚于某个特定日期。 | **amount:>149.99**     |
| `<`  | 小于某个金额，或早于某个特定日期。 | **date:<2020-07-12**   |
| `..` | 特定日期或金额范围之内。      | **amount:50.00…99.99** |

您还可以使用布尔运算符 `is:`，按特定的对象类型或状态筛选搜索结果。

将 `is:` 与对象类型搭配使用，可仅显示该类型的结果。

| 运算符                | 描述                                          | 示例                       |
| ------------------ | ------------------------------------------- | ------------------------ |
| `account`          | 关联的 Connect 子账户。                            | **is:account**           |
| `charge`           | 付款（同 `payment`）。                            | **is:charge**            |
| `checkout_session` | 结账会话。                                       | **is:checkout\_session** |
| `coupon`           | 优惠券。                                        | **is:coupon**            |
| `credit_note`      | 贷项通知单。                                      | **is:credit\_note**      |
| `customer`         | 客户。                                         | **is:customer**          |
| `dispute`          | 争议。                                         | **is:dispute**           |
| `document`         | 文档。                                         | **is:document**          |
| `invoice`          | 账单。                                         | **is:invoice**           |
| `invoiceitem`      | 账单明细项。                                      | **is:invoiceitem**       |
| `order`            | 订单。                                         | **is:order**             |
| `payment`          | 付款（同 `charge`）。                             | **is:payment**           |
| `payment_intent`   | PaymentIntent。                              | **is:payment\_intent**   |
| `payment_link`     | 支付链接。                                       | **is:payment\_link**     |
| `payment_method`   | PaymentMethod。                              | **is:payment\_method**   |
| `payout`           | 提现。                                         | **is:payout**            |
| `plan`             | 订阅计划。                                       | **is:plan**              |
| `price`            | 价格。                                         | **is:price**             |
| `product`          | 产品。                                         | **is:product**           |
| `promotion_code`   | 促销码。                                        | **is:promotion\_code**   |
| `quote`            | 报价。                                         | **is:quote**             |
| `refund`           | 退款。                                         | **is:refund**            |
| `setup_intent`     | SetupIntent。                                | **is:setup\_intent**     |
| `source`           | [支付来源](https://docs.stripe.com/sources.md)。 | **is:source**            |
| `subscription`     | 订阅。                                         | **is:subscription**      |
| `transfer`         | Stripe 账户之间的资金流动。                           | **is:transfer**          |

将 `is:` 与状态搭配使用，可仅显示符合该状态的结果。

| 运算符         | 描述            | 示例               |
| ----------- | ------------- | ---------------- |
| `active`    | 有效的套餐、价格或礼品卡。 | **is:active**    |
| `captured`  | 已被捕获的付款。      | **is:captured**  |
| `disputed`  | 已被提出争议的付款。    | **is:disputed**  |
| `paid`      | 已支付的付款或账单。    | **is:paid**      |
| `recurring` | 周期性价格。        | **is:recurring** |
| `refunded`  | 已退款的付款。       | **is:refunded**  |

### 组合与否定关键词

使用多个搜索词来缩小搜索范围。还可以用连字符 (`-`) 来否定任何搜索筛选器，排除与之匹配的结果。

| 示例                                | 描述                               |
| --------------------------------- | -------------------------------- |
| `type:card last4:4242 exp:08/22`  | 该卡的后四位是 `4242`，但有效期_是_ `08/22`。  |
| `type:card last4:4242 -exp:08/22` | 该卡的后四位是 `4242`，但有效期_不是_ `08/22`。 |
| `type:ideal status:canceled`      | 来源被取消，因而未用于完成付款的 iDEAL 付款。       |

要搜索整个短语，使用引号。例如，**“Stripe Shop”** 会搜索出与整个短语匹配的结果，但 **Stripe Shop** 是单独搜索 **Stripe** 和 **Shop** 这两个单词。

### 元数据搜索

您可以搜索添加到支持它的对象中的[元数据](https://docs.stripe.com/api.md#metadata)。例如，可以使用以下任何一个搜索查询找到具有元数据键 `order_id` 和相应的元数据值 `xyn712` 的文档：

- `xyn712`
- `order_id:xyn712`
- `metadata:xyn712`
- `metadata:order_id=xyn712`

## 跨组织搜索

将多个 Stripe 账户添加到[组织](https://docs.stripe.com/get-started/account/orgs.md)后，您的团队成员可以在其中搜索他们有权访问的所有账户。默认情况下，搜索会显示所有账户结果。如果团队成员从某个账户查看管理平台，则搜索下拉列表中会有一个用于仅在该账户中搜索的选项。

## 最佳实践

很多搜索通过单个关键词就可执行。使用一些相当具体的东西，例如名字或邮件地址。如果看到的结果太少，那就把关键字变模糊一些。如果结果太多，则加入额外的关键词，一次加一个。

使用日期或金额作为关键词时，使用一个较宽范围的值。搜索有关付款的信息时，您与客户之间的货币兑换和时差往往是造成混淆的主要原因。这些情况下，可使用额外的关键词，甚至同时使用若干个会比较有效。

> #### 书签搜索
> 
> 由于 URL 中包含关键词，因此可以将搜索标记为书签或分享给其他团队成员，就可以任何其他网页一样。