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

# Toggle gift card redemption

> Accept Toggle gift cards in storekit. Guests can redeem gift cards at online checkout or when paying a bill, with partial balances and split payments.

Toggle lets your guests redeem their Toggle gift cards when placing an order or paying a bill online. The integration connects at the account level and is then enabled per venue, adding a gift card code input to the checkout flow.

## Capabilities

### Gift Card Redemption

Once enabled, guests can enter a Toggle gift card code at checkout with two redemption modes:

| Mode                   | Description                                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Full redemption**    | The gift card balance covers the whole order, and the order is paid entirely with the card.                    |
| **Partial redemption** | Only the amount needed is deducted from the gift card. The remaining balance stays on the card for future use. |

### Supported Payment Scenarios

<CardGroup cols={2}>
  <Card title="Order Payments" icon="basket-shopping">
    Apply gift cards during checkout for delivery, pickup, or dine-in orders
  </Card>

  <Card title="Bill Payments" icon="receipt">
    Apply gift cards when paying a bill online through a storekit payment link
  </Card>
</CardGroup>

### Split Payments

When a gift card doesn't cover the full amount:

1. The gift card balance is applied first
2. The remaining balance is charged to another payment method (card, Apple Pay, etc.)

This lets guests use gift cards of any value without needing an exact match.

### Balance Enquiry

The card's remaining balance is looked up and validated before redemption, so guests can see the available balance when they apply their card.

### Refunds

When an order paid with a Toggle gift card is refunded, the full gift card redemption is reversed and the balance is restored to the card automatically. Toggle supports full refunds of a gift card transaction only — partial refunds of a gift card redemption are not supported.

<Note>
  Toggle handles redemption only. Purchasing new gift cards and topping up existing cards are not supported through storekit.
</Note>

## How It Works

1. Guest enters their Toggle gift card code at checkout
2. storekit looks up the card and returns the available balance
3. The requested amount is deducted from the card
4. Any remaining order total is charged to another payment method
5. The order or bill is updated, and the redemption is recorded in your reports

## What You'll Need

Before connecting, make sure you have:

* A **Toggle account**. Don't have one? [Create one here](https://www.usetoggle.com/).
* Your Toggle **Username** and **Password** (used to connect your account).
* For each venue you want to enable: your Toggle **Unit EPOS Reference**, available from Toggle.

<Note>
  Toggle is available on eligible storekit plans. If **Toggle** does not appear under **Settings > Integrations**, [contact support](/docs/getting-started/contact-support) to have it enabled for your account. Only one gift card provider can be active per venue.
</Note>

## Configuration

### 1. Connect your account

1. Go to **Settings > Integrations** in your dashboard and open **Toggle**
2. Click **Connect to Toggle**
3. Enter your Toggle **Username** and **Password**, then click **Connect**

Your credentials are verified with Toggle when you connect. If they're rejected, double-check them and try again.

### 2. Enable Toggle for a venue

Once your account is connected, configure each venue that should accept gift cards:

1. Turn on **Integration enabled for this venue**
2. Enter your **Unit EPOS Reference**
3. Click **Save Configuration**

The gift card code input appears at checkout for that venue as soon as it's enabled. To stop accepting gift cards at a venue, turn the venue switch off.


## Related topics

- [Voucher Connect gift card and voucher redemption](/docs/guides/integrations/voucher-connect.md)
- [Loyalty Programs](/docs/guides/increasing-sales/loyalty-programs.md)
- [Loyalty & Gift Cards](/docs/guides/integrations/loyalty-gift-cards.md)
- [Integrations Overview](/docs/guides/integrations/overview.md)
- [Blocked Orders](/docs/guides/orders/advanced/blocked-orders.md)