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

# 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/unstable/objects/MoneyV2)

  non-null

  The amount of the transaction.

* gift​Card

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

  non-null

  The gift card that the transaction belongs to.

* id

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

  non-null

  The unique ID for the transaction.

* metafield

  [Metafield](https://shopify.dev/docs/api/admin-graphql/unstable/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/unstable/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.

* metafields​By​Identifiers

  [\[Metafield\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield)

  non-null

  The metafields associated with the resource matching the supplied list of namespaces and keys.

* note

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

  A note about the transaction.

* processed​At

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

  non-null

  The date and time when the transaction was processed.

***

## Types implemented in

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

  OBJECT

  A credit transaction which increases the gift card balance.

  * amount

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

    non-null

    The amount of the transaction.

  * gift​Card

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

    non-null

    The gift card that the transaction belongs to.

  * id

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

    non-null

    A globally-unique ID.

  * metafield

    [Metafield](https://shopify.dev/docs/api/admin-graphql/unstable/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/unstable/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.

  * metafields​By​Identifiers

    [\[Metafield\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield)

    non-null

    The metafields associated with the resource matching the supplied list of namespaces and keys.

  * note

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

    A note about the transaction.

  * processed​At

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

    non-null

    The date and time when the transaction was processed.

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

  OBJECT

  A debit transaction which decreases the gift card balance.

  * amount

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

    non-null

    The amount of the transaction.

  * gift​Card

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

    non-null

    The gift card that the transaction belongs to.

  * id

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

    non-null

    A globally-unique ID.

  * metafield

    [Metafield](https://shopify.dev/docs/api/admin-graphql/unstable/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/unstable/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.

  * metafields​By​Identifiers

    [\[Metafield\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield)

    non-null

    The metafields associated with the resource matching the supplied list of namespaces and keys.

  * note

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

    A note about the transaction.

  * processed​At

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

    non-null

    The date and time when the transaction was processed.

***

##### Variables

```json
{
	"amount": "",
	"giftCard": "",
	"id": "",
	"metafield": {
		"namespace": "",
		"key": ""
	},
	"metafields": {
		"namespace": "",
		"keys": "",
		"first": "",
		"after": "",
		"last": "",
		"before": "",
		"reverse": ""
	},
	"metafieldsByIdentifiers": [
		{
			"identifiers": ""
		}
	],
	"note": "",
	"processedAt": ""
}
```

##### Schema

```graphql
interface GiftCardTransaction {
  amount: MoneyV2!
  giftCard: GiftCard!
  id: ID!
  metafield: Metafield
  metafields: MetafieldConnection!
  metafieldsByIdentifiers: [Metafield]!
  note: String
  processedAt: DateTime!
}
```