Represents an action performed on a gift card that affects its state or balance.
<- Object
Object
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.
The ID of the business location where the activity occurred.
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
The gift card ID. When creating a gift card activity, gift_card_id
is not required if gift_card_gan
is specified.
The gift card account number (GAN). When creating a gift card activity, gift_card_gan
is not required if gift_card_id
is specified.
Read only The final balance on the gift card after the action is completed.
Additional details about a LOAD
activity, which is used to reload money onto a gift card.
Additional details about an ACTIVATE
activity, which is used to activate a gift card with an initial balance.
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.
Additional details about a CLEAR_BALANCE
activity, which is used to set the balance of a gift card to zero.
Additional details about a DEACTIVATE
activity, which is used to deactivate a gift card.
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.
Additional details about an ADJUST_DECREMENT
activity, which is used to deduct money from a gift card outside of a typical REDEEM
activity flow.
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.
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.
Read only Additional details about an IMPORT
activity, which Square uses to import a third-party gift card with a balance.
Read only Additional details about a BLOCK
activity, which Square uses to temporarily block a gift card.
Read only Additional details about an UNBLOCK
activity, which Square uses to unblock a gift card.
Read only Additional details about an IMPORT_REVERSAL
activity, which Square uses to reverse the import of a third-party gift card.
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.