> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取礼品卡购买记录

要查看您账户中的历史礼品卡购买和虚拟卡，请使用 `getUserPurchases` [查询](https://storage.googleapis.com/fluz-public-docs/api-reference.html#group-Reference-Queries)。该查询需要 `LIST_PURCHASES` scope。此查询的响应可能较大，因此我们要求您提供分页输入，以及可选的筛选输入：

## 拉取购买历史

您可以使用以下查询来查看您的交易。

1. `getUserPurchases` — 获取用户购买记录

<StickyContactSalesBanner />

## 分页输入

`OffsetInput` 参数用于管理 API 响应的分页，允许您控制每页返回的项目数量，以及从列表开头应跳过多少项目。

### 字段

**`limit`** **(Int)**：此字段指定每页返回的项目数量。每页最多可请求 20 个项目。如果未指定 limit 的值，则默认为 20。

**`offset`** **(Int)**：此字段指定在开始返回项目之前要跳过的项目数量。如果未指定 offset 的值，则默认为 0，表示从列表中的第一个项目开始。

## 筛选输入

`UserPurchaseFilterInput` 参数用于筛选响应中返回的购买记录。它允许您检索与您的应用关联的用户所做的购买，或与您的应用关联的账户下所做的购买等。它是可选的。如果未提供，响应将返回与您的应用关联的用户在所有账户中的购买记录。

### 字段

**`scope`** **(由 `PurchaseScopeFilter` 组成的数组)**：此字段指定要使用的筛选类型。

##### `PurchaseScopeFilter` 枚举

* TOKEN\_USER：基于 userId 筛选
* TOKEN\_ACCOUNT：基于 accountId 筛选

### 示例

```javascript theme={null}
// QUERY VARIABLES
// returns purchases made by the user across all accounts
{
  "filter": {
	"scope": ["TOKEN_USER"] 
  }	
}
```

```javascript theme={null}
// QUERY VARIABLES
// returns purchases made under the account across all users
{
  "filter": {
	"scope": ["TOKEN_ACCOUNT"] 
  }	
}
```

```javascript theme={null}
// QUERY VARIABLES
// returns purchases made by the user and account
{
  "filter": {
	"scope": ["TOKEN_USER", "TOKEN_ACCOUNT"] 
  }	
}
```

# 响应

当您运行此查询时，它将返回一个数组，其中包含您的历史礼品卡购买和生成的虚拟卡。

```json theme={null}
{
  "data": {
    "getUserPurchases": [
      {
        "purchaseId": "255f8245-02c7-4817-901e-15fe265f6968",
        "purchaseDisplayId": "1019688",
        "purchaseBankCardId": "255f8245-02c7-4817-901e-15fe265f6968",
        "bankAccountId": "255f8245-02c7-4817-901e-15fe265f6968",
        "purchaseAmount": 987.65,
        "fluzpayAmount": 123.45,
        "seatRewardValue": 987.65,
        "paypalVaultId": "255f8245-02c7-4817-901e-15fe265f6968",
        "createdAt": "2007-12-03T10:15:30Z",
        "purchaserUserId": "4c42e368-d150-492d-8dec-6cda1b58ffa9",
				"accountId": "d67af480-21dc-4c23-93ff-3b7288e52e1a",
        "giftCard": {
          // GiftCardFragment details
        },
        "virtualCard": {
          // VirtualCardFragment details
        }
      },
      {
        "purchaseId": "4f4b3c5d-6f7e-8a9b-0c1d-23e4f5678a90",
        "purchaseDisplayId": "1019688",
        "purchaseBankCardId": "4f4b3c5d-6f7e-8a9b-0c1d-23e4f5678a90",
        "bankAccountId": "4f4b3c5d-6f7e-8a9b-0c1d-23e4f5678a90",
        "purchaseAmount": 250.00,
        "fluzpayAmount": 50.00,
        "seatRewardValue": 10.00,
        "paypalVaultId": "4f4b3c5d-6f7e-8a9b-0c1d-23e4f5678a90",
        "createdAt": "2024-01-10T08:20:00Z",
        "giftCard": {
          // GiftCardFragment details
        },
        "virtualCard": {
          // VirtualCardFragment details
        }
      },
      {
        "purchaseId": "7e8f9a0b-1c2d-3e4f-5g6h-789i0jklm1no",
        "purchaseDisplayId": "1019688",
        "purchaseBankCardId": "7e8f9a0b-1c2d-3e4f-5g6h-789i0jklm1no",
        "bankAccountId": "7e8f9a0b-1c2d-3e4f-5g6h-789i0jklm1no",
        "purchaseAmount": 450.75,
        "fluzpayAmount": 75.00,
        "seatRewardValue": 30.00,
        "paypalVaultId": "7e8f9a0b-1c2d-3e4f-5g6h-789i0jklm1no",
        "createdAt": "2024-02-15T14:45:00Z",
        "giftCard": {
          // GiftCardFragment details
        },
        "virtualCard": {
          // VirtualCardFragment details
        }
      }
    ]
  }
}
```

## UserPurchase 对象中的字段

| 字段名                | 类型          | 描述                                           |
| :----------------- | :---------- | :------------------------------------------- |
| purchaseId         | String      | 购买记录的唯一标识符。                                  |
| purchaseDisplayId  | String      | 购买记录的显示 ID。                                  |
| purchaseBankCardId | String      | 用于此次购买的银行卡标识符。                               |
| bankAccountId      | String      | 与此次购买关联的银行账户标识符。                             |
| purchaseAmount     | Float       | 此次购买的总支出金额。                                  |
| fluzpayAmount      | Float       | 交易中使用的可用 Fluz 余额金额。                          |
| seatRewardValue    | Float       | 由此次购买产生的任何网络席位奖励的数值。                         |
| paypalVaultId      | String      | 此次购买所使用的 PayPal 保险库标识符。                      |
| createdAt          | DateTime    | 指示购买发生时间的时间戳。                                |
| purchaserUserId    | String      | 进行此次购买的用户标识符。                                |
| accountId          | String      | 进行此次购买的账户标识符。                                |
| giftCard           | GiftCard    | 包含购买中使用的任何礼品卡的详细信息，由 GiftCardFragment 表示。    |
| virtualCard        | VirtualCard | 包含购买中使用的任何虚拟卡的详细信息，由 VirtualCardFragment 表示。 |