Managing coupons and gift cards
Once you have created coupons and gift cards in a campaign, you can filter, edit, export, and delete them in the Coupons page. You can also import new codes directly from a CSV file.
Redeeming a code
Use the coupon code is valid condition in your rules to redeem your codes.
You can then add any required effects. For example, you can create a rule to issue a discount on the session total when a customer uses a valid coupon code in their order. Learn more about it in the coupon tutorial.
If you cancel a session where a code was redeemed, the code can be used again. Learn more in our Developer docs.
Searching for a code by name
You can use this option to find an individual code whose name you know.
On the left-side menu of the campaign where the code was created, click Coupons.
In the search bar at the top of the page, type the code.
noteYou can use uppercase or lowercase.
You see the table row containing your code.
Filtering codes
You can filter and sort your codes in different ways so that you find those that match certain characteristics, such as the creation date or current redemption status.
On the left-side menu of the campaign where the code was created, click Coupons.
At the top of the page, click Filter to display the filtering options:
- Use Batch ID (exact match) to find all the codes from the same batch.
- Use Creation date to select dates and find codes created within a certain time range.
- Use Customer ID to find codes linked to a certain Customer integration ID. It must match, and the filter is case-sensitive.
- Use Validity to find codes that are valid either now or in the future, or that have already expired.
- Use Redemption to find codes that have already been redeemed or those that are still usable.
noteYou can use more than one filter at the same time. The filters used appear at the top of the page, and you can edit them by clicking on the box with their name. You can also remove them individually by clicking the X to the right of their name.
You see the codes that match the filters you have set.
At the top of the page, click Clear Filters to see all the codes in the campaign again.
Editing a code
You can modify some characteristics of a code after it has been created. For example, you can add an expiration date.
On the left-side menu of the campaign where the code was created, click Coupons.
Select the checkbox to the left of the code you want to edit.
At the top of the page, click Edit Coupon.
Edit the required information and click Update Coupon to save your changes.
noteYou cannot edit the code itself for security reasons.
At the top of the page, click Clear Filters to see all the codes in the campaign again.
Editing a code batch
You can modify some characteristics of all the codes from a given batch at the same time. For example, you can add an expiration date.
- On the left-side menu of the campaign where the batch was created, click Coupons.
- Select the checkbox to the left of a code from the batch you want to edit.
- At the top of the page, click Edit Coupon Batch.
- Edit the required information and click Update Batch to save your changes.
- In the confirmation window that appears, click Update <Batch ID>.
At the top of the page, click Clear Filters to see all the codes in the campaign again.
Deleting individual codes
You can delete codes to free up space in your database in order to create new codes.
On the left-side menu of the campaign where the code was created, click Coupons.
Select the checkbox to the left of the code you want to delete.
noteYou can select as many codes as you want at once. In case you want to delete all the codes displayed on the same page, select the Code checkbox at the top of the list of codes.
At the top of the page, click Delete 1 Coupon.
In the confirmation window that appears, click Delete Selected Coupons.
The coupons are deleted immediately.
Deleting all the codes in the same campaign
You can use this option to free up all the space in your database at once in order to create new coupons.
- On the left-side menu of the campaign where you want to delete the codes, click Coupons.
- Click the arrow to the right of the Create Coupons button to display the dropdown menu.
- Click Delete All Coupons.
- In the confirmation window that appears, click Delete All Coupons.
The coupons are deleted immediately.
Importing codes
You can use this feature to import coupons and gift cards from any marketing tool in Talon.One.
On the left-side menu of the campaign where you want to import your codes, click Coupons.
Click the arrow to the right of the Create Coupons button to display the dropdown menu.
Click Import Coupons.
Click Upload a CSV file to select a CSV file with codes from your computer.
tipA sample file is available for download.
If your codes have custom attributes, see the Importing codes with custom attributes.
Click Import Coupons.
If no limit is set for an imported code, the default is single-use.
Importing codes with custom attributes
This section requires knowledge about the JSON notation. See Introduction to JSON for more information.
To import codes with custom attributes:
Ensure you know each attribute's API name, type, and value.
Include in your CSV file a column called
attributes
.Insert a JSON object listing the key-value pairs in the
attributes
column.The pattern is as follows:
{"api_name_1": my_integer_value, "api_name_2": "my_string_value", ...}
TroubleshootingIf you have use a text editor to edit your CSV file, you will get an
Import Error: Read CSV error parse error on line 2
error message. To solve it, duplicate all double-quotes.The pattern is as follows:
"{""api_name_1"": my_integer_value, ""api_name_2"": ""my_string_value"", ...}"
The format of the attribute value depends on the attribute type according to the following table:
Attribute type | Attribute value format |
---|---|
String | "value" |
Number | 1 |
Boolean | true or false |
Time | "2022-03-15T00:00:00Z" |
Location | "{\"name\":\"geofence_name\",\"format\":\"geojson-base64\",\"object\":\"geofence_data\"}" |
List of strings | ["value1", "value2", "value3"] |
List of numbers | [1, 2, 3] |
List of dates | ["2022-02-15T00:00:00+02:00", "2022-10-15T00:00:00+02:00", "2022-03-16T00:00:00+02:00"] |
List of locations | ["{\"name\":\"geofence_name1\",\"format\":\"geojson-base64\",\"object\":\"geofence_data1\"}", "{\"name\":\"geofence_name2\",\"format\":\"geojson-base64\",\"object\":\"geofence_data2\"}", "{\"name\":\"geofence_name3\",\"format\":\"geojson-base64\",\"object\":\"geofence_data3\"}"] |
Location attribute data must be managed by a technical user.
Imagine that we want to import a coupon that has 3 custom attributes:
- a string attribute called
type
. - a boolean attribute called
flexible_cancellation
. - a time attribute called
reservation_coupon_date
.
The content of the attributes
column in our CSV file looks as follows:
{"type": "premium", "flexible_cancelation": true, "reservation_coupon_date": "2021-01-25T09:54:03Z"}
Exporting codes
You can use this feature to obtain a CSV file with codes from your campaign. For example, you can use it to import the coupons and gift cards in another marketing tool (like a mailing tool) or print them out and spread them across magazines.
On the left-side menu of the campaign from which you want to export codes, click Coupons.
Click the arrow to the right of the Create Coupons button to display the dropdown menu.
Click Export Coupons.
In Date format, select the date format of your choice.
noteData is exported in UTC.
Use the tabs to choose which codes you want to export:
- Click After a Specific Date to export all the codes created after a date you select in Created after.
- Click Specific Batch to export all the codes from the same batch.
- Click After Recent Export to select all the codes created after one of your previous exports. You can choose the specific export by using the Created after dropdown menu. This option is available only if you have exported codes.
tipTo filter your coupons in a different way, use your spreadsheet software.
Click Export Data.