<- Object

Object

GiftCardActivity

Represents an action performed on a gift card that affects its state or balance.

A gift card activity contains information about a specific activity type. For example, a REDEEM activity includes a redeem_activity_details field that contains information about the redemption.

Link to section

Properties

Link to section

id

string

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

Link to section

type

string

Required

The type of gift card activity.

Link to section

location_id

string

Required

Link to section

created_at

string

Read only The timestamp when the gift card activity 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

Link to section

gift_card_id

string

The gift card ID. When creating a gift card activity, gift_card_id is not required if gift_card_gan is specified.

Link to section

gift_card_gan

string

The gift card account number (GAN). When creating a gift card activity, gift_card_gan is not required if gift_card_id is specified.

Link to section

gift_card_balance_money

Read only The final balance on the gift card after the action is completed.

Link to section

load_activity_details

Additional details about a LOAD activity, which is used to reload money onto a gift card.

Link to section

activate_activity_details

Additional details about an ACTIVATE activity, which is used to activate a gift card with an initial balance.

Link to section

redeem_activity_details

Additional details about a REDEEM activity, which is used to redeem a gift card for a purchase.

For applications that process payments using the Square Payments API, Square creates a REDEEM activity that updates the gift card balance after the corresponding CreatePayment request is completed. Applications that use a custom payment processing system must call CreateGiftCardActivity to create the REDEEM activity.

Link to section

clear_balance_activity_details

Additional details about a CLEAR_BALANCE activity, which is used to set the balance of a gift card to zero.

Link to section

deactivate_activity_details

Additional details about a DEACTIVATE activity, which is used to deactivate a gift card.

Link to section

adjust_increment_activity_details

Additional details about an ADJUST_INCREMENT activity, which is used to add money to a gift card outside of a typical ACTIVATE, LOAD, or REFUND activity flow.

Link to section

adjust_decrement_activity_details

Additional details about an ADJUST_DECREMENT activity, which is used to deduct money from a gift card outside of a typical REDEEM activity flow.

Link to section

refund_activity_details

Additional details about a REFUND activity, which is used to add money to a gift card when refunding a payment.

For applications that refund payments to a gift card using the Square Refunds API, Square automatically creates a REFUND activity that updates the gift card balance after a RefundPayment request is completed. Applications that use a custom processing system must call CreateGiftCardActivity to create the REFUND activity.

Link to section

unlinked_activity_refund_activity_details

Additional details about an UNLINKED_ACTIVITY_REFUND activity. This activity is used to add money to a gift card when refunding a payment that was processed using a custom payment processing system and not linked to the gift card.

Link to section

import_activity_details

Read only Additional details about an IMPORT activity, which Square uses to import a third-party gift card with a balance.

Link to section

block_activity_details

Read only Additional details about a BLOCK activity, which Square uses to temporarily block a gift card.

Link to section

unblock_activity_details

Read only Additional details about an UNBLOCK activity, which Square uses to unblock a gift card.

Link to section

import_reversal_activity_details

Read only Additional details about an IMPORT_REVERSAL activity, which Square uses to reverse the import of a third-party gift card.

Link to section

transfer_balance_to_activity_details

Read only Additional details about a TRANSFER_BALANCE_TO activity, which Square uses to add money to a gift card as the result of a transfer from another gift card.

Link to section

transfer_balance_from_activity_details

Read only Additional details about a TRANSFER_BALANCE_FROM activity, which Square uses to deduct money from a gift as the result of a transfer to another gift card.