gift_card

A gift card that's been issued to a customer or a recipient.

Properties

balance number: The remaining balance of the gift card in the currency's subunit.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip
Use money filters to output a formatted amount.
Tip: Use <a href="/docs/api/liquid/filters/money-filters">money filters</a> to output a formatted amount.
code string: The code used to redeem the gift card.
currency string: The ISO code of the currency that the gift card was issued in.
customer customer: The customer associated with the gift card.
enabled boolean: Returns true if the gift card is enabled. Returns false if not.
expired boolean: Returns true if the gift card is expired. Returns false if not.
expires_on string: A timestamp for when the gift card expires.

If the gift card never expires, then nil is returned.

Tip
Use the date filter to format the timestamp.
Tip: Use the <a href="/docs/api/liquid/filters/date"><code>date</code> filter</a> to format the timestamp.
initial_value number: The initial balance of the gift card in the currency's subunit.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip
Use money filters to output a formatted amount.
Tip: Use <a href="/docs/api/liquid/filters/money-filters">money filters</a> to output a formatted amount.
last_four_characters string: The last 4 characters of the code used to redeem the gift card.
message string: The personalized message intended for the recipient.

If there is no message intended for the recipient, then nil is returned.
pass_url string: The URL to download the gift card as an Apple Wallet Pass.
product product: The product associated with the gift card.
properties: The line item properties assigned to the gift card.

If there aren't any line item properties, then an EmptyDrop is returned.
qr_identifier string: A string used to generate a QR code for the gift card.
recipient recipient: The recipient associated with the gift card.

If there is no recipient associated with the gift card, then nil is returned.
send_on string: The scheduled date on which the gift card will be sent to the recipient.

If the gift card does not have a scheduled date, then nil is returned.

Tip
Use the date filter to format the date.
Tip: Use the <a href="/docs/api/liquid/filters/date"><code>date</code> filter</a> to format the date.
template_suffix string: The name of the custom template assigned to the gift card.

The name doesn't include the gift_card. prefix, or the .liquid file extension.

If a custom template isn't assigned to the gift card, then nil is returned.
url string: The URL to view the gift card. This URL is on the checkout.shopify.com domain.

Tip
The page at this URL is rendered through the gift_card.liquid template of the theme.
Tip: The page at this URL is rendered through the <a href="/themes/architecture/templates/gift-card-liquid"><code><span class="PreventFireFoxApplyingGapToWBR">gift<wbr/>_card.liquid</span></code> template</a> of the theme.
variant variant: The variant associated with the gift card.

If there is no variant associated with the gift card, then nil is returned.

{

"balance": 5000,

"code": "WCGX 7X97 K9HJ DFR8",

"currency": "CAD",

"customer": {},

"enabled": true,

"expired": false,

"expires_on": null,

"initial_value": 5000,

"last_four_characters": "DFR8",

"message": null,

"send_on": null,

"pass_url": "https://polinas-potent-potions.myshopify.com/v1/passes/pass.com.shopify.giftcardnext/94af7fbe55d010130df8d8bc4a338d36/",

"product": {},

"variant": {},

"properties": {},

"qr_identifier": "shopify-giftcard-v1-3TKWJKJBM3X7PBRK",

"recipient": null,

"template_suffix": null,

"url": "https://checkout.shopify.com/gift_cards/56174706753/0011c591fc720d0a51b80cdb694f969e"

}

Example

{
  "balance": 5000,
  "code": "WCGX 7X97 K9HJ DFR8",
  "currency": "CAD",
  "customer": {},
  "enabled": true,
  "expired": false,
  "expires_on": null,
  "initial_value": 5000,
  "last_four_characters": "DFR8",
  "message": null,
  "send_on": null,
  "pass_url": "https://polinas-potent-potions.myshopify.com/v1/passes/pass.com.shopify.giftcardnext/94af7fbe55d010130df8d8bc4a338d36/",
  "product": {},
  "variant": {},
  "properties": {},
  "qr_identifier": "shopify-giftcard-v1-3TKWJKJBM3X7PBRK",
  "recipient": null,
  "template_suffix": null,
  "url": "https://checkout.shopify.com/gift_cards/56174706753/0011c591fc720d0a51b80cdb694f969e"
}

Anchor to

Templates using gift_card

Theme architecturegift_card.liquid template

Was this section helpful?