Update gift card

PUT 
/openapi/2025-06/gift_cards/:id

Updates the details of a specific gift card using its unique ID.

Request

Path Parameters

id stringrequired

Gift card's unique ID

application/json

Body

Bodyrequired

gift_card objectrequired

Gift card

expires_onstring

The date when the gift card expires (e.g., 2018-11-02T12:30:10Z)

notestring

An optional note that a merchant can attach to the gift card

template_suffixstring

The suffix of the Liquid template used to render the gift card

Example

{
  "gift_card": {
    "expires_on": "string",
    "note": "string",
    "template_suffix": "string"
  }
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

gift_card object

Gift card

idstring

Gift card ID

last_charactersstring

Last four characters of the gift card code

balancestring

Current balance of the gift card

initial_valuestring

The initial value of the gift card

notestring

Note attached to the gift card

expires_onstring

Expiration date of the gift card (e.g., 2018-11-02T12:30:10Z)

disabled_atstring

Time when the gift card was disabled (e.g., 2018-11-02T12:30:10Z)

enabledboolean

Whether the gift card is currently enabled

created_atstring

Time when the gift card was created (e.g., 2018-11-02T12:30:10Z)

updated_atstring

Time when the gift card was last updated (e.g., 2018-11-02T12:30:10Z)

statusstring

Status of the gift card:

• enable: gift card is active and usable
• disable: gift card is disabled and cannot be used

currencystring

Currency in which the gift card is denominated

line_item_idstring

ID of the line item associated with the gift card

order_idstring

ID of the order associated with the gift card

user_idstring

User ID of the creator or owner of the gift card

template_suffixstring

Suffix of the template used to render the gift card online

customer_idstring

Customer ID associated with the gift card

codestring

The gift card code, consisting of alphanumeric characters (minimum: 8 characters, maximum: 20 characters)

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "gift_card": {
      "id": "string",
      "last_characters": "string",
      "balance": "string",
      "initial_value": "string",
      "note": "string",
      "expires_on": "string",
      "disabled_at": "string",
      "enabled": true,
      "created_at": "string",
      "updated_at": "string",
      "status": "string",
      "currency": "string",
      "line_item_id": "string",
      "order_id": "string",
      "user_id": "string",
      "template_suffix": "string",
      "customer_id": "string",
      "code": "string"
    }
  }
}