---
title: "Action: Gift cards"
description: "Imports existing gift cards with their balance and sale date so they can be redeemed in Sapera."
url: https://support.sapera.io/en/articles/610-action-gift-cards
collection: "SyncTool"
updated: 2026-09-25
language: en
alternates: [da]
---

# Action: Gift cards

Imports existing gift cards with their balance and sale date so they can be redeemed in Sapera.

Imports existing gift cards with their balance and sale date so they can be redeemed in Sapera.

## How to use the action

1\. Select the action in the **Action** field. 2. Point to your data source – a **file** (CSV or Excel) or a **SQL query**. 3. Map the source columns to Sapera's fields in the column mapping (see _Source fields_ below). 4. Run **Compare** to see what will be created, changed or stay unchanged – without writing to Sapera. 5. Run **Update Sapera** to perform the import.

Use the **Allow create** and **Allow update** parameters to control whether new rows are created and whether existing ones are updated.

## How matching and updating works

Each row is matched on the gift card's **identifier** (Identifier). The action is used to **load existing gift cards** with balance and sale date – e.g. at start-up or when migrating from another system.

-   If the card does not exist it is created. Existing gift cards are **not updated** by the action. Direction: from file/SQL into Sapera.
    

## Key parameters

<table data-id="edc531cb-16ae-4af6-8b69-4ba946803189" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="e8ff8554-354f-49c1-9d07-52ea7bd6ba50" style="text-align: left;"><strong>Parameter</strong></p></td><td colspan="1" rowspan="1"><p data-id="728e7b1f-e936-4fcf-8b32-e1d6362e1c17" style="text-align: left;"><strong>Explanation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="1a69ddab-701a-492e-9cd3-e12fb50b843b" style="text-align: left;">AllowCreate</p></td><td colspan="1" rowspan="1"><p data-id="2e8b1bae-74d6-4e7e-961b-5b12f10293cb" style="text-align: left;">When enabled, gift cards that do not exist are registered.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0f2294ac-22b8-4f76-bb6d-8b26f4ba6482" style="text-align: left;">AllowUpdate</p></td><td colspan="1" rowspan="1"><p data-id="59aac966-5072-443b-b2c7-adf760e9f7d3" style="text-align: left;">When enabled, existing gift cards are updated.</p></td></tr></tbody></table>

## Source fields

<table data-id="9a784adc-a845-4fa1-a37d-b0000bf70b77" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="af37e12c-e9e9-453a-b166-7322116cf1f9" style="text-align: left;"><strong>Field</strong></p></td><td colspan="1" rowspan="1"><p data-id="d251bc75-773c-49e5-a502-1b83ea2b80a9" style="text-align: left;"><strong>Explanation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0c0c8cb0-ff10-435f-9036-ae8ea4c249c0" style="text-align: left;">Amount</p></td><td colspan="1" rowspan="1"><p data-id="90d33251-6f97-4909-a3de-de93d161f15d" style="text-align: left;">The original face value the gift card was issued with.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="02c051e7-3df7-48d2-9488-428f4d285a3f" style="text-align: left;">Identifier</p></td><td colspan="1" rowspan="1"><p data-id="c0304f1f-e1be-4f8b-8094-97d9a32e2551" style="text-align: left;">The numeric gift card number (the identifier of the row).</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="119357d7-83c9-41b3-b0ed-3c5d3ba281ea" style="text-align: left;">RemainingAmount</p></td><td colspan="1" rowspan="1"><p data-id="62f4ff93-9ae4-421e-9bab-f3677540d9b6" style="text-align: left;">The amount still left on the gift card; a withdrawal is created for any already-spent part.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="e2569cfd-6310-4645-9aa0-9cdaffa6d0b0" style="text-align: left;">SoldAt</p></td><td colspan="1" rowspan="1"><p data-id="7a09b1e2-9913-472e-90a1-9f3052b59a92" style="text-align: left;">The date the gift card was sold; when set the card is marked as sold.</p></td></tr></tbody></table>

* * *

See also the overview [SyncTool – actions](https://support.sapera.io/en/articles/547-synctool-handlinger.md).

* * *

**Want to know more?**

Read more in these related articles:

[

Standard parameters for all actions

The general parameters available on most SyncTool actions: step control, error handling, timeout, etc.

](https://support.sapera.io/en/articles/648.md)
