Providing Omnichannel Giftcards to customers

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Goal: enable in-store use of Shopify Gift Cards on a bespoke POS (omnichannel).

Current state:

  • Issuing/selling gift cards works via Admin GraphQL mutation giftCardCreate (API version 2022-10).
  • Next needs: check balance and redeem (consume) gift cards presented by customers.

Problem:

  • Available queries are giftCard (requires the gift card ID) and giftCards (supports filters like lastCharacters).
  • The POS only has the customer’s original gift card code, not the internal ID.
  • Filtering by lastCharacters could return multiple cards, creating ambiguity and not reliably identifying a single card.

Key question:

  • Is there a way to locate a gift card by its full original code using Admin GraphQL, to then check balance or consume it?

Status: No solution or workaround provided yet; the request remains open.

Summarized with AI on February 6. AI used: gpt-5.
1

Hi, we want to be able to allow Shopify Gift Cards to be used in store. We’re on our own bespoke POS.

We need to be able to issue/sale Gift Cards, that is fine using this:

https://shopify.dev/api/admin-graphql/2022-10/mutations/giftCardCreate

We need to be able to check the balance of a Gift Card or consume it.

Which is where the problem is, the only ways to query a Gift Card are these:

https://shopify.dev/api/admin-graphql/2022-10/queries/giftCard

https://shopify.dev/api/admin-graphql/2022-10/queries/giftCards

First one doesn’t work as it requires the ID, second one, we could potentially query by the “lastCharacters” characters, but that does allow for overlap of multiple Gift Cards, querying by the “Code” is it possible.

What could we do to locate a Gift Card by it’s original code the customer has?