Gift Card
Requires access scope.
Represents an issued gift card.
Anchor to Fields and connectionsFields and connections
- Anchor to balancebalance•Money
V2!non-null The gift card's remaining balance.
- Anchor to createdAtcreated•
At DateTime!non-null The date and time at which the gift card was created.
- Anchor to customercustomer•
The customer who will receive the gift card.
- Anchor to deactivatedAtdeactivated•
At The date and time at which the gift card was deactivated.
- Anchor to enabledenabled•Boolean!non-null
Whether the gift card is enabled.
- Anchor to expiresOnexpires•
On The date at which the gift card will expire.
- •ID!non-null
A globally-unique ID.
- Anchor to initialValueinitial•
Value MoneyV2!non-null The initial value of the gift card.
- Anchor to lastCharacterslast•
Characters String!non-null The final four characters of the gift card code.
- Anchor to maskedCodemasked•
Code String!non-null The gift card code. Everything but the final four characters is masked.
- Anchor to notenote•
The note associated with the gift card, which isn't visible to the customer.
- Anchor to orderorder•
The order associated with the gift card. This value is
null
if the gift card was issued manually.- Anchor to recipientAttributesrecipient•
Attributes The recipient who will receive the gift card.
- Anchor to templateSuffixtemplate•
Suffix The theme template used to render the gift card online.
- Anchor to transactionstransactions•
The transaction history of the gift card.
- Anchor to updatedAtupdated•
At DateTime!non-null The date and time at which the gift card was updated.
Anchor to QueriesQueries
- •query
Returns a gift card resource by ID.
- •query
Returns a list of gift cards.
Anchor to MutationsMutations
- •mutation
Create a gift card.
- Anchor to inputinput•Gift
Card Create Input!required The input fields to create a gift card.
Arguments
- Anchor to giftCardgift•
Card The created gift card.
- Anchor to giftCardCodegift•
Card Code The created gift card's code.
- Anchor to userErrorsuser•
Errors [GiftCard User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Deactivate a gift card. A deactivated gift card cannot be used by a customer. A deactivated gift card cannot be re-enabled.
- •ID!required
The ID of the gift card to deactivate.
Arguments
- Anchor to giftCardgift•
Card The deactivated gift card.
- Anchor to userErrorsuser•
Errors [GiftCard Deactivate User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Send notification to the customer of a gift card.
- •ID!required
The ID of the gift card to send.
Arguments
- Anchor to giftCardgift•
Card The gift card that was sent.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Send notification to the recipient of a gift card.
- •ID!required
The ID of the gift card to send.
Arguments
- Anchor to giftCardgift•
Card The gift card that was sent.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Update a gift card.
- •ID!required
The ID of the gift card to be updated.
- Anchor to inputinput•Gift
Card Update Input!required The input fields to update the gift card.
Arguments
- Anchor to giftCardgift•
Card The updated gift card.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •