# 查找交易（快速搜索）

在几秒钟内基于特定搜索参数获取交易列表。此为以JSON、CSV或XLS格式返回该数据的查找交易API调用的另一选择。


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

Endpoint: GET /merchants/{merchant_id}/reports/transactions/simple_search
Version: 2.0
Security: basicAuth

## Path parameters:

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

## Query parameters:

  - `transaction_id` (integer)
    交易ID。必须提供此参数或external_id，但不要同时提供两者。

  - `external_id` (string)
    游戏中的交易ID。对每个付款唯一。必须提供此参数或transaction_id，但不要同时提供两者。

## Response 200 fields (application/json):

  - `payment_details` (object)
    支付详细信息。

  - `payment_details.payment` (object)

  - `payment_details.payment.amount` (number)
    付款金额。

  - `payment_details.payment.currency` (string)
    支付币种。参照[ISO 4217](https://developers.xsolla.com/zh/doc/pay-station/references/supported-currencies/)标准的三字母货币代码。

  - `transaction` (object)
    交易详细信息。

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

  - `transaction.id` (integer)
    交易ID。

  - `transaction.payment_date` (string)
    YY-MM-DD（年-月-日）格式的支付日期。

  - `transaction.project` (object)

  - `transaction.project.id` (integer)
    游戏的艾克索拉ID。可以在发布商帐户中找到该ID。

  - `transaction.project.name` (string)
    项目名。

  - `transaction.refund_reason` (string)
    退款原因。

  - `transaction.status` (string)
    Enum: "created", "processing", "review", "error", "done", "awaitingRefund", "refunded", "canceled", "partiallyRefunded"

  - `user` (object)
    带用户相关数据的对象。

  - `user.country` (string)
    使用[ISO 3166-1 alpha-2标准](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)规定的2字母组合表示国家/地区。

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

  - `user.id` (string)
    用户ID。

  - `user.name` (string)
    用户名。


## Response 403 fields

## Response 404 fields

## Response 422 fields