<- Object

Object

All versions ->

GiftCardBeta

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

Indicates the gift card type.

Link to section

gan_source

string

Read only Indicates whether the gift card account number (GAN) is generated by Square or imported from a non-Square system. For more information, see Third-party gift cards.

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.

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 customers to whom this gift card is linked.