<- Object

Object

GiftCardActivityType

Link to section

Values

Link to section

ACTIVATE

Activated a gift card with a balance. When a gift card is activated, Square changes the gift card state from PENDING to ACTIVE. A gift card must be in the ACTIVE state to be used for other balance-changing activities.

Link to section

LOAD

Loaded a gift card with additional funds.

Link to section

REDEEM

Redeemed a gift card for a purchase.

Link to section

CLEAR_BALANCE

Set the balance of a gift card to zero.

Link to section

DEACTIVATE

Permanently blocked a gift card from balance-changing activities.

Link to section

ADJUST_INCREMENT

Added money to a gift card outside of a typical ACTIVATE, LOAD, or REFUND activity flow.

Link to section

ADJUST_DECREMENT

Deducted money from a gift card outside of a typical REDEEM activity flow.

Link to section

REFUND

Added money to a gift card from a refunded transaction. A REFUND activity might be linked to a Square payment, depending on how the payment and refund are processed. For example:

  • A gift card payment processed by Square can be refunded to the same gift card using Square Point of Sale, the Square Seller Dashboard, or the Refunds API.
  • A cross-tender payment processed by Square can be refunded to a gift card using Square Point of Sale or the Square Seller Dashboard. The payment source might be a credit card or different gift card.
  • A payment processed using a custom payment processing system can be refunded to the same gift card.
Link to section

UNLINKED_ACTIVITY_REFUND

Added money to a gift card from a refunded transaction that was processed using a custom payment processing system and not linked to the gift card.

Link to section

IMPORT

Imported a third-party gift card with a balance. IMPORT activities are managed by Square and cannot be created using the Gift Card Activities API.

Link to section

BLOCK

Temporarily blocked a gift card from balance-changing activities. BLOCK activities are managed by Square and cannot be created using the Gift Card Activities API.

Link to section

UNBLOCK

Unblocked a gift card, which enables it to resume balance-changing activities. UNBLOCK activities are managed by Square and cannot be created using the Gift Card Activities API.

Link to section

IMPORT_REVERSAL

Reversed the import of a third-party gift card, which sets the gift card state to PENDING and clears the balance. IMPORT_REVERSAL activities are managed by Square and cannot be created using the Gift Card Activities API.

Link to section

TRANSFER_BALANCE_FROM

Deducted money from a gift card as the result of a transfer to the balance of another gift card. TRANSFER_BALANCE_FROM activities are managed by Square and cannot be created using the Gift Card Activities API.

Link to section

TRANSFER_BALANCE_TO

Added money to a gift card as the result of a transfer from the balance of another gift card. TRANSFER_BALANCE_TO activities are managed by Square and cannot be created using the Gift Card Activities API.