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.
FieldRequiredDescription
Card numberYesUnique number of the gift card.
Pool system nameYesSystem name of the pool the card belongs to. The pool must already exist on the project.
Gift card CVVNoRequired for pools that have CVV transfer enabled.
Card balanceYesFor cards with a fixed face value, the balance must equal the pool’s face value.
Point of contact external IDNoThe point of contact where the card was issued. Used when registering cards that were sold in the past.
Card purchase date (UTC)NoDate and time the card was issued, in UTC. Used when registering cards that were sold in the past. For pools with a fixed validity period, the expiration date is counted from this date.
Gift card statusNoCurrent status of the card. If the field is omitted, the card is assigned the “Inactive” status.
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.