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

# Physical Gift Cards

Sell gift cards you ship by mail or in a box, with a real Shopify gift card behind each one

Physical Gift Cards turns a regular shipped product (a printed card, a card in a gift box) into a real Shopify gift card. Every card bought gets the number already printed on your card stock, or a code the app generates for you to put on the card, and the app creates the matching Shopify gift card for you. No more creating gift cards by hand for every order.

{% hint style="info" %}
Shopify's own gift card products are always digital: they are emailed and can't be shipped. Physical Gift Cards works with a normal product that ships, so shipping, taxes and inventory stay exactly as you have them. To email gift cards to a recipient instead, use [Gift Card Postman](https://docs.giftcardfactory.app/campaigns/gift-card-postman.md).
{% endhint %}

### How It Works

1. A customer buys your gift card product like any other shipped product.
2. When the order is paid, the campaign creates one run per card bought (an order with 2 × $50 cards gets 2 runs) and gives each card its code.
3. When packing, staff enter the numbers of pre-printed cards on the order (**More actions > Activate physical gift cards**), or copy the generated codes from the order's **Physical gift cards** block onto the cards.
4. The Shopify gift card is created with that code, worth the price of the variant bought. Depending on your settings this happens when the order is paid, when it ships, or as soon as staff enter the card number.

**Each gift card costs 25 campaign credits.**

### 💡Common Use Cases

**Mailed gift cards** — You already sell "$25 / $50 / $100 mailed gift card" as a shipped product and create the codes manually. Select that product and the app creates the codes and gift cards for every new order.

**Gift card in a box** — Sell a boxed card with a blank code area. Staff copy the generated code from the order onto a sticker or the card before packing.

**Pre-printed card stock** — You bought numbered plastic cards. Staff scan or type the number of the card they put in the parcel, and that number becomes the gift card code.

### Creating a Campaign

Navigate to **Campaigns > New Campaign > Physical Gift Cards**.

#### Gift card product

Each campaign uses **one product**. Every unit bought becomes one gift card worth the price of the variant bought, so **each variant's price must be the card's value** (for example variants $25, $50 and $100 priced $25, $50 and $100). Different card designs can be variants of the same product, or separate campaigns.

Choose one of two options:

* **Use a product you already sell** — choose this if you already sell mailed or boxed gift cards as a shipped product. Orders, shipping and inventory keep working as they do, and new orders also get a Shopify gift card. Orders placed before the campaign is activated are not affected. Shopify's digital gift card products and the Gift Card Postman product can't be selected.
* **Create a new gift card product** — choose this if you don't sell physical gift cards yet. Enter the amounts (for example `25, 50, 100`) and the app creates a **draft** shipped product called "Physical Gift Card" with one variant per amount. Add photos, edit the title and description, and make it active in Shopify when you're ready.

After a product is selected you can limit the campaign to some of its variants (**Edit** on the product row) or pick another product (**Change product**).

{% hint style="warning" %}
A product can be used by only one Physical Gift Cards campaign. Otherwise every card sold would get two gift cards, so saving a second campaign with the same product shows an error.
{% endhint %}

#### Title

A name for your own reference. Customers don't see it.

#### Gift card codes

**Card codes**

* **Generate a code for each card** (default) — the app creates a code for every card as soon as the order is paid. Codes use only capital letters and digits that are easy to read and type (no 0/O or 1/I/L). Staff copy each code from the order's **Physical gift cards** block onto the card (a sticker or by hand) before shipping. Use this for cards without a number.
  * **Code prefix** — optional letters and digits at the start of every code, e.g. `GC`, so staff recognize your cards.
  * **Code length** — 8 to 20 characters, prefix included. Default 16.
* **Use the number printed on my card stock** — for cards that already have a number on them. When packing, staff open the order, choose **More actions > Activate physical gift cards** and type or scan the number of each card they put in the parcel. The number can be 8 to 20 letters or digits (spaces and dashes are ignored). The gift card is created right away.
* **Use a list of my codes** (coming soon) — upload codes you already have and assign them to your amounts. Each card bought takes the next code from the list, and the product's inventory follows the codes left, so it sells out when the list runs out.

**Create the Shopify gift card** (generated codes only)

* **When the order ships** (default) — the code is on the order right after payment, so the card can be prepared, but the gift card only exists (and works) once the card ships. A refund before shipping leaves nothing to deactivate, and a card lost before shipping can't be spent.
* **When the order is paid** — the gift card works as soon as the order is paid.

With pre-printed cards, the gift card is always created when staff enter the number.

#### Gift card settings

* **Gift card expiry** — never, a period after the gift card is created, or a fixed date. With a period, it counts from when the gift card is created (for example when the order ships).
* **Match gift card value with amount paid** — lowers the gift card value by the discounts applied to the card, so a $50 card bought with 10% off is worth $45.
* **Reject discount codes on gift card orders** — discount codes entered at checkout are rejected with a message while this product is in the cart, so a code never makes a card cheaper than its value. Automatic discounts are not affected. See [Reject Discount Codes on Gift Cards](https://docs.giftcardfactory.app/extensions/reject-discount-codes.md).
* **Assign gift card to the buyer** — the gift card shows in the buyer's customer account. Leave it off when cards are usually bought as gifts.

#### Fraud protection

The same protection as in Gift Card Postman:

* **Hold gift cards for high-risk orders** — when Shopify rates an order as high risk, its cards wait with the **On hold** status until you release or cancel them.
* **Hold orders with gift cards worth at least** — orders whose cards add up to this amount are held for review whatever the risk rating.
* **Tags to add while the order is on hold** and **Notify the buyer that delivery is pending review** with its own email template.

Don't ship held orders. Release them from the campaign's runs (**Release and send**) after review. A released card then continues normally: it waits for shipment or for its card number if your settings require it. Read more in [Fraud protection (high-risk orders)](https://docs.giftcardfactory.app/campaigns/gift-card-postman/setup.md#fraud-protection-high-risk-orders).

#### Orders and notifications

* **Tags to add when the order is paid** and **Tags to add when the gift card is created** — comma-separated order tags, useful for filtering orders and for Shopify Flow.
* **Add gift card codes to order attributes** — adds each full code to the order's additional details (`Gift Card #1 (Product title)`). Everyone with access to orders, and apps that read them, can see the codes, so leave it off unless you need it.
* **Email staff when physical gift cards are ordered** — sends the addresses in **Staff emails** (comma-separated) a notice for every order with physical cards: which cards to prepare or activate, their values and a link to the order. Codes are masked in this email; the full code is only shown on the order in Shopify admin.

### Seeing the codes on the order

The **Physical gift cards** block on the order page lists every card on the order: product, variant and value, its status (for example **Created when the order ships** or **Gift card created**) and, for generated codes, the full code with a **Copy** button. Copy each code onto its card before shipping. With **When the order ships**, the code is there right after payment, before the gift card exists.

Add the block once: open any order, choose the apps icon in the order page's blocks area, add **Physical gift cards** and pin it. It stays collapsed on orders without physical gift cards.

{% hint style="info" %}
**Where codes are kept:** each card's code is saved on its order in Shopify, in a private app field that only Gift Card Factory can read (it isn't shown in the order details or to other apps). Gift Card Factory doesn't store full codes on its own servers: the campaign runs, emails and logs only show the last 4 characters.
{% endhint %}

### Activating pre-printed cards

On an order with cards waiting for their number, choose **More actions > Activate physical gift cards**:

1. Type or scan the number printed on each card next to its product and value.
2. Choose **Activate**. All numbers are checked first, so a typo doesn't save half of them.
3. The gift cards are created within a few seconds. Choose **Refresh** to see them.

If Shopify rejects a number (for example because a gift card with that code already exists), the card shows an error in the campaign runs and you can enter a different number from the same action.

### Refunds

When a card is refunded:

* If its gift card doesn't exist yet (waiting for shipment, waiting for card number, on hold), the run is cancelled and no gift card is created.
* If the gift card exists, it is deactivated.

### Campaign Dashboard

#### Metrics

* **Gift cards created** and **Value issued**
* **Gift cards redeemed**, **Redeemed value** and **Order total** of the orders paid with these gift cards

#### Campaign Runs

One run per card bought, showing the product and value, the order, and the gift card once it exists. Statuses:

* **Scheduled** — the gift card is about to be created
* **Waiting for shipment** — the code is on the order; the gift card is created when the order ships
* **Waiting for card number** — staff haven't entered the pre-printed card's number yet
* **On hold** — waiting for your fraud review
* **Completed** — the gift card was created
* **Error** — the gift card couldn't be created; the run log shows why. Select the run and choose **Retry**, or for pre-printed cards enter another number on the order.
* **Cancelled**, **Limits Error**

Select a waiting or held run to **Cancel run** if the card won't be sent.

#### Activate / Deactivate

Activating registers webhooks for paid orders and refunds of the campaign's product, plus shipments when gift cards are created on shipping. Shopify only sends orders that contain the product. Deactivating removes them, so new orders don't get gift cards. Cards already waiting are still created when they ship or when their number is entered.

### Tips

* **Test with a draft order** — create an order for the product, mark it as paid, check the code in the order's block, then fulfill the order to see the whole flow before you go live.
* **Prices are values** — keep each variant's price equal to the card's value: lowering the variant price lowers the card's value too. Discount codes and automatic discounts don't change the card's value unless **Match gift card value with amount paid** is on.
* **Pre-printed stock** — buy cards with 8 to 20 character numbers, letters and digits only, and make sure every number is unique.
* **Remind customers** — pair the campaign with [Gift Card Reminders](https://docs.giftcardfactory.app/campaigns/gift-card-reminders.md) so physical cards don't end up forgotten in a drawer.
