Importing Gift Cards into NX

Importing Gift Cards into NX

NX makes it easy to bring in your existing gift card balances. By importing a simple CSV file, you can quickly load card numbers and balances so your customers can continue using their cards seamlessly.

Required Fields

Each row in your CSV must contain the following:

• cardNumber — the full gift card number exactly as issued
• balance — the amount currently loaded on the card

CSV Format Requirements

• File type: CSV (comma-separated values)
• Encoding: UTF-8
• Header row: required (card_number,balance)
• Balances must be numbers with two decimals (e.g. 25.00)
• Card numbers must be digits only (no spaces, dashes, or special characters)
• If using Excel/Sheets, format the card_number column as Text to preserve leading zeros

⚠️ Heads-up: NX does not allow currency symbols in balances (e.g., $100 ❌ → 100.00 ✅).

Example CSV File

card_number,balance
6045710000000123,25.00
0000456789012345,100.00
8899776655443322,0.00
6045710000000999,12.50

Example Preview

Steps to Import

1. Create a spreadsheet with two columns: card_number and balance.
2. Enter your gift card data.
3. Export the file as CSV (UTF-8).
4. In NX Portal, be sure you're at the Enterprise level.
5. Go to Configuration > Import
6. Select Gift Card Import from the Type selection
7. Upload your CSV file via the Choose File selector.
8. Once ready, click Import.

Best Practices

✅ Keep your gift card list clean and free of duplicates.

✅ Double-check balances before importing. 

✅ Test with a small file first if you have a large list.

✨ With just a few steps, your customers’ gift cards will be ready to use in NX—making their experience smooth and your setup stress-free.