> For the complete documentation index, see [llms.txt](https://docs.podplay.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podplay.app/payments/square-gift-cards.md).

# Square Gift Cards

### Overview

Customers can redeem Square Gift Cards by going to the More tab of the app and clicking on Redeem Gift Card.

<figure><img src="/files/sJgRGbLnIW5NjRZ0Gkwl" alt=""><figcaption></figcaption></figure>

On the next page, enter in the 16-digit code received in the Square email received by the Gift Card recipient.

<figure><img src="/files/xhJo6vASBFM64xbHxx5p" alt=""><figcaption></figcaption></figure>

Once redeemed, the Gift Card will automatically be converted to Credits.

{% hint style="warning" %}
The email that Square sends out includes a QR code and barcode, which are not relevant. ONLY THE 16-DIGIT code is necessary to redeem the gift card. You may be asked about this by Customers. Guide the Customer. We are speaking to Square about this in an attempt to reach a UI resolution on their email sent to the Customer.
{% endhint %}

### Sign Up For Square Gift Cards

To enable Square Gift Cards, ssign your Club up for a free Square account by going to [https://squareup.com](https://squareup.com/).

Once your Square account has been created and is active, you can set up gift cards by going to <https://app.squareup.com/dashboard/gift-cards>.

#### Configuration in Square

The first step is to turn on “Sell eGift Cards Online” in order.

Once toggled on you’ll be given a URL that Customers can go to in order to purchase Gift Cards online. You can either use that URL or embed it on your site (see example at [City Pickle](https://www.city-pickle.com/gift-cards)). You will need to use this URL to embed the Gift Card Purchase Page on your marketing website or add it to the Company Settings page to allow Customers to buy Gift Cards within your App.

<figure><img src="/files/34KxT5X3PtoFykZoCuSY" alt=""><figcaption></figcaption></figure>

At the bottom of the page you can choose which Gift Card designs you want to appear on your digital purchase page or upload your own branded images.

On the Gift Card Settings <https://app.squareup.com/dashboard/gift-cards/settings> you should:

1. Choose what denominations of gift cards you want to sell ($25, $50, $100, etc.)
2. Add text to the “Additional Policy” field which the Gift Card recipient will see in their email with the gift; we recommend the following text if you adding the Buy Gift Card button to your App

> “To activate your gift card, create or log in to your CLUBNAME account and click on More --> Redeem Gift Card Page or visit this link: <https://yourclub.podplay.app/account/redeem-gift-card> . Simply add the 16-digit number associated with your gift card, and credit will automatically be added to your account. Questions? You can contact us at <help@yourclub.com>”

The next step of setting up Gift Cards will be allow for API Access to your Square account which you can do by going to: <https://developer.squareup.com/console/en/apps>

Once on this page:

1. Click on the `+` button to make a new Application
2. Name Your Application “PodPlay Gift Cards”
3. Hit “Next”
4. Select “Build Customer Relationships"
5. Hit “Next”
6. Click the “Skip” button on the “Find Your Audience” screen where you will then be shown a “Credentials” screen
7. Click on the “Production” tab
8. Click the copy button next to the “Production Access token” whose value will be hidden on the page
9. Paste the Product Access token (the token will begin with the letters EAAA) in the Company Settings page of the Dashboard

<figure><img src="/files/ifpuqN4mkgzGGKDwsQVh" alt=""><figcaption></figcaption></figure>

Now there will be a "Buy a Gift Card" linked button at the bottom of the "Redeem Gift Card" page in the App.

<figure><img src="/files/keER85zsbt4VqBgXmb0i" alt=""><figcaption></figcaption></figure>

### **AddingSquare Gift Cards to Your App**

To add the Square Gift Card to your App, anyone with the Owner role in the Dashboard can

1. Navigate to to the Company Settings page
2. Click on the Integrations tab (or search at the top of the page for "square")
3. Turn on the toggle for Square Gift Cards
4. Add the "Gift Card Purchase Page" URL from Square to the "Buy Gift Cards URL" text box
5. Click on the pencil icon to the right of the "Square Access Token"
6. Add the "Production Access token" to the text box
7. Click the update button
8. Click the blue `Save Changes` button at the top of the page

<figure><img src="/files/FSewqTdbtV3FfDhbZiCX" alt=""><figcaption></figcaption></figure>

### **Embedding Square Gift Cards on Your Marketing Site**

The Square Gift Card Purchase page can be embedded on your Club's website as follows by replacing the square URL below with your Square URL:

`<div class="container">`

`<iframe src="`[`https://app.squareup.com/gift/MLR9SRVW704MX/order`](https://app.squareup.com/gift/MLR9SRVW704MX/order)`"></iframe> </div>`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podplay.app/payments/square-gift-cards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
