---
title: GiftCardTransaction - GraphQL Admin
description: Interface for a gift card transaction.
api_version: 2024-10
api_name: admin
type: interface
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/GiftCardTransaction
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/GiftCardTransaction.txt
---

# Gift​Card​Transaction

interface

Requires `read_gift_card_transactions` access scope.

Interface for a gift card transaction.

## Fields

* amount

  [Money​V2!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MoneyV2)

  non-null

  The amount of the transaction.

* gift​Card

  [Gift​Card!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/GiftCard)

  non-null

  The gift card that the transaction belongs to.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  non-null

  The unique ID for the transaction.

* metafield

  [Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Metafield)

  A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

* metafields

  [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MetafieldConnection)

  non-null

  A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

* note

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  A note about the transaction.

* processed​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/DateTime)

  non-null

  The date and time when the transaction was processed.

### Deprecated fields

* private​Metafield

  [Private​Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PrivateMetafield)

  Deprecated

* private​Metafields

  [Private​Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/PrivateMetafieldConnection)

  non-nullDeprecated

***

## Types implemented in

* [Gift​Card​Credit​Transaction](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/GiftCardCreditTransaction)

  OBJECT

  A credit transaction which increases the gift card balance.

  * amount

    [Money​V2!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MoneyV2)

    non-null

    The amount of the transaction.

  * gift​Card

    [Gift​Card!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/GiftCard)

    non-null

    The gift card that the transaction belongs to.

  * id

    [ID!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

    non-null

    A globally-unique ID.

  * metafield

    [Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Metafield)

    A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

  * metafields

    [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MetafieldConnection)

    non-null

    A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

  * note

    [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

    A note about the transaction.

  * processed​At

    [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/DateTime)

    non-null

    The date and time when the transaction was processed.

  * private​Metafield

    [Private​Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PrivateMetafield)

    Deprecated

  * private​Metafields

    [Private​Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/PrivateMetafieldConnection)

    non-nullDeprecated

* [Gift​Card​Debit​Transaction](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/GiftCardDebitTransaction)

  OBJECT

  A debit transaction which decreases the gift card balance.

  * amount

    [Money​V2!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MoneyV2)

    non-null

    The amount of the transaction.

  * gift​Card

    [Gift​Card!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/GiftCard)

    non-null

    The gift card that the transaction belongs to.

  * id

    [ID!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

    non-null

    A globally-unique ID.

  * metafield

    [Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Metafield)

    A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

  * metafields

    [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MetafieldConnection)

    non-null

    A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

  * note

    [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

    A note about the transaction.

  * processed​At

    [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/DateTime)

    non-null

    The date and time when the transaction was processed.

  * private​Metafield

    [Private​Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PrivateMetafield)

    Deprecated

  * private​Metafields

    [Private​Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/PrivateMetafieldConnection)

    non-nullDeprecated

***

```json
{
	"amount": "",
	"giftCard": "",
	"id": "",
	"metafield": {
		"namespace": "",
		"key": ""
	},
	"metafields": {
		"namespace": "",
		"keys": "",
		"first": "",
		"after": "",
		"last": "",
		"before": "",
		"reverse": ""
	},
	"note": "",
	"privateMetafield": {
		"namespace": "",
		"key": ""
	},
	"privateMetafields": {
		"namespace": "",
		"first": "",
		"after": "",
		"last": "",
		"before": "",
		"reverse": ""
	},
	"processedAt": ""
}
```