Allow customers to purchase gift cards on your store

Enable the gift card for purchase

1. 1

   Go to the Foxy admin and open the gift card you want customers to be able to buy.

2. 2

   Check Allow customers to buy this gift card.

3. 3

   Set the gift card’s SKU — you’ll use this when building the add-to-cart form.

4. 4

   Optionally, set a minimum and maximum purchase amount. If you set one, you must set both.

Set up the recipient notification email

Gift cards purchased through your store need an email template to notify the recipient.

1. 1

   In the Foxy admin, go to Settings > Emails.

2. 2

   In the Templates section, click Add Template.

3. 3

   Give the template a description (for your own reference) and confirm Send this email is selected.

4. 4

   Set a Subject the recipient will see, such as “A gift card, just for you!”

5. 5

   Leave the remaining settings as default, or customize the template further, then click Create.

6. 6

   Go to Categories, and open the category you’ll use for your gift card products.

7. 7

   Under the Emails section, set Message to the gift recipient to the template you just created.

8. 8

   If you don’t want to collect a shipping address for gift card purchases, set Delivery Type under Delivery Options to Not shipped.

You can use an existing category (including the Default category) or create a new one specifically for gift cards. Whichever category you use, you’ll need to pass it with the add-to-cart request below.

Build the add-to-cart form

Add a form to your website so customers can purchase the gift card. It works like a normal product add-to-cart, with these fields:

• name — the name of the product

• code — the gift card’s SKU, prefixed with gift_card_ (a SKU of widgets becomes gift_card_widgets)

• category — the category you set up above; optional only if you’re using the DEFAULT category

• gift_recipient_email — the recipient’s email address; must be a valid email

• gift_recipient_message — optional; a custom message included in the notification email

• price — the amount to load onto the gift card

<form method="POST" action="https://YOURSTORE.foxycart.com/cart">
  <input type="hidden" name="name" value="Widgets Gift Card">
  <input type="hidden" name="code" value="gift_card_widgets">
  <input type="hidden" name="category" value="your-gift-card-category">
  <label>Gift Card Recipient Email:
    <input type="text" name="gift_recipient_email">
  </label>
  <label>Gift Card Recipient Message:
    <input type="text" name="gift_recipient_message" value="" placeholder="Enter a custom message for your recipient">
  </label>
  <label>Gift Card Amount:
    <input type="number" name="price" value="10">
  </label>
  <input type="submit" value="Add Gift Card to Cart">
</form>

Fixed amount vs. customer-specified balance

• For a fixed amount, set price as a hidden input, or as a set of radio inputs with specific amounts. The customer won’t be able to change it.

• To let the customer choose their own amount, set price as a text input, as in the example above. The customer can enter any value, within any minimum or maximum you set when enabling purchase.

Notes

• If a customer tries to add a gift card below the minimum or above the maximum amount, the add-to-cart request fails and an error is shown.