---
title: "HistoryOfGiftCard"
description: "单个客户的礼品卡增减流水明细。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/history-of-gift-card'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/history-of-gift-card.md'
---
# HistoryOfGiftCard

单个客户的礼品卡增减流水明细。

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`HistoryOfGiftCard`

## Fields

* `currentBalance`

  [UnsignedInt64](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/unsigned-int-64.md)

  当前剩余可用礼品卡余额

* `orderCode`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  这条流水对应的订单编号

* `sceneType`

  [HistoryOfGiftCardSceneType](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/history-of-gift-card-scene-type.md)

  礼品卡变更场景类型

* `updateValue`

  [UnsignedInt64](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/unsigned-int-64.md)

  本次更新的礼品卡金额的绝对值。
  如果updateValue < 0，那么礼品卡余额减少。
  如果updateValue > 0，那么礼品卡余额减少。

* `updatedAt`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  更新这条流水记录的时间

## Schema Definition

```graphql
type HistoryOfGiftCard { 
	currentBalance: UnsignedInt64
	orderCode: String
	sceneType: HistoryOfGiftCardSceneType
	updateValue: UnsignedInt64
	updatedAt: Date 
}
```

## Field from

* [GiftCardHistoryConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/gift-card-history-connection.md).nodes

  节点列表

* [GiftCardHistoryEdge](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/gift-card-history-edge.md).node

  节点信息

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。