<- Object

Object

GiftCard

Represents a Square gift card.

Link to section

Properties

Link to section

id

string

Read only The Square-assigned ID of the gift card.

Link to section

type

string

Required

The gift card type.

Link to section

gan_source

string

The source that generated the gift card account number (GAN). The default value is SQUARE.

Link to section

state

string

Read only The current gift card state.

Link to section

balance_money

Read only The current gift card balance. This balance is always greater than or equal to zero.

Link to section

gan

string

The gift card account number (GAN). Buyers can use the GAN to make purchases or check the gift card balance.

Link to section

created_at

string

Read only The timestamp when the gift card was created, in RFC 3339 format. In the case of a digital gift card, it is the time when you create a card (using the Square Point of Sale application, Seller Dashboard, or Gift Cards API).
In the case of a plastic gift card, it is the time when Square associates the card with the seller at the time of activation.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Link to section

customer_ids

string [ ]

Read only The IDs of the customer profiles to whom this gift card is linked.