Giftcards

Get Gift Cards for a store

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Query parameters

limitinteger · int32 · min: 1 · max: 100Optional

The maximum number of items to return in a single request.

afterstring · flake-idOptional

Returns items after the specified ID. Used for forward pagination through results.

Example: 411486491630370816

beforestring · flake-idOptional

Returns items before the specified ID. Used for backward pagination through results.

Example: 411486491630370816

ascbooleanOptional

Determines the sort order of returned items. When true, items are returned in ascending order. When false, items are returned in descending order.

codestringOptional

A gift card code to filter by.

include_canceledbooleanOptional

Should canceled gift cards be included in the response?

Responses

200

OK

application/json

Represents a gift card in the PayNow system.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the gift card is currently enabled and can be used.

codestringRequired

The unique code that customers use to redeem the gift card.

Example: GIFT-2024-ABCD1234

notestring · nullableOptional

Optional note or description associated with the gift card.

balanceinteger · int64Required

The current balance remaining on the gift card in cents.

Example: 2500

starting_balanceinteger · int64Required

The original balance when the gift card was first created in cents.

Example: 5000

usable_atstring · date-timeRequired

The date and time when the gift card becomes usable.

expires_atstring · nullableOptional

The date and time when the gift card expires, if applicable.

created_atstring · nullableOptional

The date and time when the gift card was created.

updated_atstring · nullableOptional

The date and time when the gift card was last updated, if applicable.

canceled_atstring · nullableOptional

The date and time when the gift card was canceled, if applicable.

default

Error response

application/json

get

/v1/stores/{storeId}/giftcards

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/giftcards HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": "411486491630370816",
    "store_id": "411486491630370816",
    "enabled": true,
    "code": "GIFT-2024-ABCD1234",
    "note": null,
    "balance": 2500,
    "starting_balance": 5000,
    "usable_at": "2026-02-18T23:17:18.548Z",
    "expires_at": null,
    "created_at": null,
    "created_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "updated_at": null,
    "updated_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "canceled_at": null,
    "canceled_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    }
  }
]

Create a Gift Card for a store

post

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

enabledbooleanRequired

codestringRequired

notestringOptional

balanceinteger · int64Required

usable_atstring · date-timeRequired

expires_atstring · nullableOptional

Responses

200

OK

application/json

Represents a gift card in the PayNow system.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the gift card is currently enabled and can be used.

codestringRequired

The unique code that customers use to redeem the gift card.

Example: GIFT-2024-ABCD1234

notestring · nullableOptional

Optional note or description associated with the gift card.

balanceinteger · int64Required

The current balance remaining on the gift card in cents.

Example: 2500

starting_balanceinteger · int64Required

The original balance when the gift card was first created in cents.

Example: 5000

usable_atstring · date-timeRequired

The date and time when the gift card becomes usable.

expires_atstring · nullableOptional

The date and time when the gift card expires, if applicable.

created_atstring · nullableOptional

The date and time when the gift card was created.

updated_atstring · nullableOptional

The date and time when the gift card was last updated, if applicable.

canceled_atstring · nullableOptional

The date and time when the gift card was canceled, if applicable.

default

Error response

application/json

post

/v1/stores/{storeId}/giftcards

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/giftcards HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "enabled": true,
  "code": "text",
  "note": "text",
  "balance": 1,
  "usable_at": "2026-02-18T23:17:18.548Z",
  "expires_at": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "GIFT-2024-ABCD1234",
  "note": null,
  "balance": 2500,
  "starting_balance": 5000,
  "usable_at": "2026-02-18T23:17:18.548Z",
  "expires_at": null,
  "created_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "canceled_at": null,
  "canceled_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Get a Gift Card By ID for a store

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

giftCardIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

Represents a gift card in the PayNow system.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the gift card is currently enabled and can be used.

codestringRequired

The unique code that customers use to redeem the gift card.

Example: GIFT-2024-ABCD1234

notestring · nullableOptional

Optional note or description associated with the gift card.

balanceinteger · int64Required

The current balance remaining on the gift card in cents.

Example: 2500

starting_balanceinteger · int64Required

The original balance when the gift card was first created in cents.

Example: 5000

usable_atstring · date-timeRequired

The date and time when the gift card becomes usable.

expires_atstring · nullableOptional

The date and time when the gift card expires, if applicable.

created_atstring · nullableOptional

The date and time when the gift card was created.

updated_atstring · nullableOptional

The date and time when the gift card was last updated, if applicable.

canceled_atstring · nullableOptional

The date and time when the gift card was canceled, if applicable.

default

Error response

application/json

get

/v1/stores/{storeId}/giftcards/{giftCardId}

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/giftcards/{giftCardId} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "GIFT-2024-ABCD1234",
  "note": null,
  "balance": 2500,
  "starting_balance": 5000,
  "usable_at": "2026-02-18T23:17:18.548Z",
  "expires_at": null,
  "created_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "canceled_at": null,
  "canceled_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Delete a Gift Card By ID for a store

delete

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

giftCardIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

Represents a gift card in the PayNow system.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the gift card is currently enabled and can be used.

codestringRequired

The unique code that customers use to redeem the gift card.

Example: GIFT-2024-ABCD1234

notestring · nullableOptional

Optional note or description associated with the gift card.

balanceinteger · int64Required

The current balance remaining on the gift card in cents.

Example: 2500

starting_balanceinteger · int64Required

The original balance when the gift card was first created in cents.

Example: 5000

usable_atstring · date-timeRequired

The date and time when the gift card becomes usable.

expires_atstring · nullableOptional

The date and time when the gift card expires, if applicable.

created_atstring · nullableOptional

The date and time when the gift card was created.

updated_atstring · nullableOptional

The date and time when the gift card was last updated, if applicable.

canceled_atstring · nullableOptional

The date and time when the gift card was canceled, if applicable.

default

Error response

application/json

delete

/v1/stores/{storeId}/giftcards/{giftCardId}

HTTPcURLJavaScriptPython

DELETE /v1/stores/{storeId}/giftcards/{giftCardId} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "GIFT-2024-ABCD1234",
  "note": null,
  "balance": 2500,
  "starting_balance": 5000,
  "usable_at": "2026-02-18T23:17:18.548Z",
  "expires_at": null,
  "created_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "canceled_at": null,
  "canceled_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Update a Gift Card By ID for a store

patch

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

giftCardIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

enabledbooleanOptional

codestringOptional

notestringOptional

balanceinteger · int64Optional

usable_atstring · date-timeOptional

expires_atstring · nullableOptional

Responses

200

OK

application/json

Represents a gift card in the PayNow system.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the gift card is currently enabled and can be used.

codestringRequired

The unique code that customers use to redeem the gift card.

Example: GIFT-2024-ABCD1234

notestring · nullableOptional

Optional note or description associated with the gift card.

balanceinteger · int64Required

The current balance remaining on the gift card in cents.

Example: 2500

starting_balanceinteger · int64Required

The original balance when the gift card was first created in cents.

Example: 5000

usable_atstring · date-timeRequired

The date and time when the gift card becomes usable.

expires_atstring · nullableOptional

The date and time when the gift card expires, if applicable.

created_atstring · nullableOptional

The date and time when the gift card was created.

updated_atstring · nullableOptional

The date and time when the gift card was last updated, if applicable.

canceled_atstring · nullableOptional

The date and time when the gift card was canceled, if applicable.

default

Error response

application/json

patch

/v1/stores/{storeId}/giftcards/{giftCardId}

HTTPcURLJavaScriptPython

PATCH /v1/stores/{storeId}/giftcards/{giftCardId} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "enabled": true,
  "code": "text",
  "note": "text",
  "balance": 1,
  "usable_at": "2026-02-18T23:17:18.548Z",
  "expires_at": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "GIFT-2024-ABCD1234",
  "note": null,
  "balance": 2500,
  "starting_balance": 5000,
  "usable_at": "2026-02-18T23:17:18.548Z",
  "expires_at": null,
  "created_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "canceled_at": null,
  "canceled_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}