# 查找交易

根据具体搜索参数返回交易列表。您将在响应中获得游戏中所有付款的数据，包括未成功完成的付款。您不仅可以指定交易时间段，还可以指定其他参数，例如搜索某个用户进行的交
易或处于某个付款状态下的交易。您可以获取JSON或CSV格式的列表。


注意此API调用不包含project_id路径参数，因此您需要使用在您公司的所有项目中都有效的API密钥来设置授权。

Endpoint: GET /merchants/{merchant_id}/reports/transactions/search.{format}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    商户ID。

  - `format` (string, required)
    数据格式。
    Enum: "json", "csv", "xls"

## Query parameters:

  - `datetime_from` (string)
    日期范围的开始时间。

  - `datetime_to` (string)
    日期范围的结束时间。

  - `project_id` (integer)
    项目ID。

  - `transaction_id` (integer)
    交易ID。

  - `type` (string)
    在搜索结果中显示的交易类型：
    Enum: "all", "transferred", "canceled", "test"

  - `phone` (string)
    用户电话号码（采用国际格式）。

  - `user_id` (string)
    存储在己侧的游戏内唯一用户ID。请确保传入现有用户ID。如遇到错误，请参阅常见问题回答。

  - `user_name` (string)
    用户名。

  - `user_custom` (string)
    用户标识的自定义参数。

  - `email` (string)
    用户电子邮件。

  - `external_id` (string)
    游戏中的交易ID。值对于每个用户付款必须唯一。

  - `order_id` (integer)
    订单ID。您可以使用它调用获取订单 API方法。
    Example: 1234

  - `offset` (integer)
    元素编号，从该元素开始生成列表（从0开始数）。

  - `limit` (integer)
    页面上元素数量的限制。

  - `status` (string)
    一种交易状态。
    Enum: "created", "processing", "review", "error", "done", "awaitingRefund", "refunded", "canceled", "partiallyRefunded"


## Response 200 fields