• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”
You are viewing an old version of the API

Gift card created

EVENT gift_card.created

Published when a gift card is created.


Permissions
GIFTCARDS_READ
Name Description
merchant_id
string

The ID of the Square seller associated with the event.

type
string

The type of event. For this event, the value is gift_card.created.

event_id
string

The unique ID of the event, which is used for idempotency support.

created_at
string

Read only The timestamp of when the event was created, in RFC 3339 format.

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

data
GiftCardCreatedSquareEventData

The data associated with the event.

Examples

You are viewing an old version of the API
Example payload
{
  "merchant_id": "C337NFWQT2A6W",
  "type": "gift_card.created",
  "event_id": "875f2038-6015-492e-9f29-d040b3809e49",
  "created_at": "2020-12-17T01:41:35.157Z",
  "data": {
    "type": "gift_card",
    "id": "gftc:00113070ba5745f0b2377c1b9570cb03",
    "object": {
      "gift_card": {
        "id": "gftc:00113070ba5745f0b2377c1b9570cb03",
        "type": "DIGITAL",
        "gan_source": "SQUARE",
        "state": "NOT_ACTIVE",
        "balance_money": {
          "amount": 0,
          "currency": "USD"
        },
        "gan": "7783320007480908",
        "created_at": "2020-12-17T01:41:35.157Z"
      }
    }
  }
}