> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The GiftCard Object

The `GiftCard` object encapsulates information about a gift card offered by a merchant as a means of paying for a recurring subscription (`AutoBill`) or a one-time transaction. Payment with a gift card does not involve a monetary transaction. Instead, when you successfully redeem a gift card, Subscribe adds credit to an `Account` or `AutoBill`. With the credit available to an `Account`, you can conduct a one-time transaction for that `Account`. Similarly, an `AutoBill` deducts credit available to it for every periodically recurring transaction it generates. The `AutoBill` offers entitlements to the subscriber as long as enough credit is available to sustain the offer. For more information, see the [Account.grantCredit](Account_grantCredit) method. For more information on how gift cards work within the Subscribe system, see Credit Grants and Gift Cards in the Subscribe Programming Guide.

With the `redeemGiftCard()` method of both the `Account` and `AutoBill` objects, you can redeem a gift card against those objects. For example, if you call `redeemGiftCard()` on an `AutoBill` object, the credit will be added to the `AutoBill`. See the [Account.redeemGiftCard](Account_redeemGiftCard), and [AutoBill.redeemGiftCard](AutoBill_redeemGiftCard) methods.

Subscribe determines how much credit to grant to an `AutoBill` or an `Account` by looking up a `Product` object. Create the `Product` object in advance in Subscribe. The `merchantProductId` of this `Product` object should match the SKU (UPC) number returned by the gift card processor company (where supported). The SKU/UPC number the processor returns when a gift card is redeemed is decided by a prior agreement between you and the gift card processor company. Before you start accepting gift cards from your customers, create a `Product` object in Subscribe with a matching `merchantProductId`. When you create the `Product`, set its `creditsGranted` attribute to the amount of credit you want granted when the corresponding gift card is redeemed. See [The Product Object](The_Product_Object) for more information.

As discussed in Working with Gift Cards in the Subscribe Programming Guide, gift card redemption is a two-step process. In step 1, determine the status of the gift card by calling the `statusInquiry()` method, discussed below. If the status is `Active`, in the second step, redeem the card by calling `redeemGiftCard()` from the `Account` or `AutoBill` object.

* **[GiftCard Data Members](../topics/GiftCard_Data_Members)**

* **[GiftCard Subobjects](../topics/GiftCard_Subobjects)**

* **[GiftCard Methods](../topics/GiftCard_Methods)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.