# POS Claim Block

The POS Claim block lets customers claim giveaway entries from in-store purchases. They enter their receipt number and email on your website, and Giveaway Gator matches it to the POS order and awards entries — bridging the gap between your physical store and your online giveaway.

## Why Use It?

- **Include in-store customers** — POS purchases don't automatically create online accounts, so customers would otherwise miss out on giveaway entries
- **Drive online engagement** — Customers visit your website to claim entries, giving you an opportunity to capture their email and keep them engaged
- **Same entry math** — POS orders go through the same calculation engine as online orders, so all bonuses, multipliers, and bonus periods apply

## How It Works

1. A customer makes a purchase at your physical store via Shopify POS.
2. They visit the POS Claim page on your website and enter their receipt number, name, and email.
3. Giveaway Gator looks up the order in Shopify, calculates entries using your promotion rules, and awards them.
4. The customer sees a confirmation with the number of entries earned.

Each receipt can only be claimed once per promotion — repeat attempts show a friendly "already claimed" message.

## Setting It Up

1. In Shopify, go to **Online Store > Themes > Customize**.
2. Create a new **page template** (or use an existing one) for your POS claim page.
3. Add the **POS Claim** block from the Giveaway Gator section.
4. Customize the appearance to match your store (see options below).
5. Create a page in **Online Store > Pages** that uses this template (e.g., "Claim In-Store Entries").
6. Link to the page from your store — consider adding it to your navigation, printing the URL on receipts, or including it in post-purchase emails to POS customers.

## What Customers See

The block shows a clean form with fields for:
- **Receipt Number** — The order number from their POS receipt
- **First Name** and **Last Name**
- **Email Address**
- **Phone Number** (optional — you can toggle this on or off)

After submitting, the customer sees one of these messages:
- **Success** — The number of entries awarded across all active promotions
- **Already claimed** — The receipt has already been used to claim entries
- **Not found** — No matching order was found (prompts them to double-check the receipt number)
- **No active promotions** — The order was found but there are no active promotions to award entries to

## Customization Options

All settings are available in the theme editor when you select the POS Claim block.

### Content

| Setting | Default | Description |
|---------|---------|-------------|
| Title | "Claim Your POS Entries" | Heading displayed above the form |
| Description | "Enter your receipt information to unlock your giveaway entries." | Subheading text below the title |
| Receipt Placeholder | — | Custom placeholder text for the receipt number field |
| Phone Placeholder | — | Custom placeholder text for the phone field |
| Collect phone | Off | Whether to show the phone number field |
| Button Text | "Claim Entries" | Text on the submit button |

### Input Styling

| Setting | Default | Description |
|---------|---------|-------------|
| Custom input styling | On | Toggle custom styles on/off (uses theme defaults when off) |
| Border color | Light gray | Border color for input fields |
| Background color | White | Background color for input fields |
| Text color | Dark gray | Text color for input fields |
| Focus border color | Shopify green | Border color when an input is focused |
| Border radius | 8px | Corner roundness (0–20px) |
| Vertical padding | 12px | Top/bottom padding inside inputs (6–24px) |
| Horizontal padding | 16px | Left/right padding inside inputs (8–28px) |

### Button Styling

| Setting | Default | Description |
|---------|---------|-------------|
| Custom button styling | On | Toggle custom styles on/off (uses theme defaults when off) |
| Background color | Shopify green | Button background color |
| Hover color | Darker green | Button color on hover |
| Text color | White | Button text color |
| Border radius | 8px | Corner roundness (0–24px) |
| Vertical padding | 12px | Top/bottom padding (8–24px) |
| Horizontal padding | 20px | Left/right padding (12–36px) |

## Tips

- **Print the claim URL on receipts** — The easiest way to drive adoption is to include a short URL (e.g., `yourstore.com/pages/claim-entries`) on your POS receipts. Customers are most likely to claim entries right after a purchase.
- **Mention it at checkout** — Train your in-store staff to let customers know they can claim giveaway entries online with their receipt.
- **Turn on phone collection** if you want to capture phone numbers for SMS marketing while customers are already filling out the form.
- **Turn off custom styling** if you want the form to fully inherit your theme's input and button styles instead of using Giveaway Gator's defaults.

## For Developers

If you're building a custom integration (kiosk, mobile app, etc.) rather than using the theme block, see the [POS Claim API](pos-claim-api.md) for the endpoint reference.