Generate Gift Codes in Bulk

There are certain scenarios in which you may want to generate a lot of gift codes and purchasing individually isn't ideal.

We have a way for you to import a file with pre-generated gift codes to facilitate that task.

To get started

• First you'll need to generate a CSV file with the list of gift codes and other attributes defined below

  • Check if there are maximum character and regular expression restrictions defined in your redemption flow before generating the codes

• Request access from Limio to access the CSV ingestion bucket

Prepping the file

1. **Check the file size to upload **For reliability and performance we recommend that a file has no more than 5,000 records. Bigger files can cause data loss.

2. **Check the file structure **Make sure the headers match as these are case sensitive. NB: the table below describes which fields are mandatory

3. **Name the file correctly **Files to be uploaded for the general migration process need to have the following prefix: Limio_gift_code_.

Processing the file

• Upload the file into the right CSV bucket (ie: SHARD.csv-ingestion.limio.com)

  • You can get this information from your Limio contact.

• Limio splits the file into batches of 1,000 and if your original file had 5,000 records for example, you'll see multiple files in the bucket being processed.

• Once the process is finished they'll be moved to the processed folder.

Checking the outcome

• You can check progress by going into your Subscriptions page in the Limio Commerce app () which will show the orders that have been processed.

• Once the files have finished processing you'll see events for the associated events in the Events section in the Limio Commerce app.

  • Any errors will also appear in the Events section.

CSV file structure

string	yes	Subscription unique identifier - can be the source (legacy) value. It will also be used as Order Number to prevent duplicates if importing again same record. IMPORTANT: it needs to be the subscriptionNumber field exported to Zuora since is going to work as link for the integration
string	yes	Zuora account id, used to link to an existing customer uploaded (it could be in Limio or uploaded via other migration file)
string	yes	It’s the code that the redeemer will use to get the subscription
string	yes	Defines the path of the Limio offer to be mapped into the subscription. Example: “/offers/digital/annual”
string (int)		The original quantity for the gift code. If not specified 1 is assumed
string (int)		The already used quantity for the gift code. If not specified 0 is assumed
string (isodate)		Expiry date for the gift code/voucher, format: YYYYMMDD. If not specified there will be no expiry