Skip to main content
Prepare a file in the correct format and upload it to add gift cards to your project in bulk. Use import for the initial load of cards, topping up a pool with new numbers, or migrating data from another system.
Before you import gift cards, the pools that will store them must already exist on the project. Every card in the file must reference an existing pool.
Imports run from Settings → Import. Click New import to open the setup.

​
In this article

​
Step 1. Choose the action

  1. Select the import type — Loyalty → Gift cards.
  2. Select the action — Add gift cards.
Each row in the file creates a new gift card in the specified pool. The import does not change or delete existing cards.

​
Step 2. Prepare and upload the file

  1. Decide which fields you need to load. The file must contain every required field.
Allowed card statuses:
  • CanBeUsed — activated. The card can be used to pay for an order. Cards in this status cannot be sold.
  • Inactive — not activated. The card can be sold. Once sold, the card becomes activated and can be used to pay for an order.
  • Blocked — blocked. The card cannot be sold or used for payment.
To record that a card was issued in the past, pass all three at once: the point of contact, the purchase date, and the CanBeUsed status.
  1. Export the data from the external system and prepare the file for upload. Put any column names you like in the first row.
    • Format — .csv or .txt.
    • Recommended encoding — UTF-8.
    • Check that the values match the allowed formats.
  2. Upload the file and click Continue.

​
Step 3. Map the file fields

The system automatically maps the file’s columns to project fields. Adjust the mapping if needed:
  1. In the Import column, check the fields you want to load. Unchecked columns are skipped.
  2. In the Maestra field column, match each file column to the corresponding project field. Optional fields without a mapping are skipped.
  3. Click Continue.

​
Step 4. Review and launch the import

Before launching, the system shows the first rows of the file with the mapping already applied. Make sure the data looks the way you expect — that the right values landed in the right fields. If everything looks good, click Launch import.

​
How to track an import

Once started, the import appears in the list on the Import page. Each job shows:
  • the launch date,
  • the import type,
  • who launched it.
If errors occurred during the import, some rows were skipped. Open the import details to see which rows caused problems and why. Fix the errors in the file and run the import again.

​
Import result

After the job finishes successfully, the gift cards appear in their pools and become available for sale, activation, and use in orders.