Dynamic code generation

A coupon code is a unique code that can be used by a single user (either single or multiple use). The Punchh framework generates coupon codes, which can be processed within a mobile app or at the POS.

Using the Punchh coupon framework and Braze, the following scenarios can be achieved:

1. Generate a coupon code when the guest clicks a coupon generation link in an email: The coupon code will be generated dynamically and shown on a web page.
2. Generate a coupon code when the guest opens an email: The coupon code will be generated dynamically and shown as an image within the email.

How to integrate Punchh dynamic coupon code generation

Step 1: Create a coupon campaign in Punchh

1. Using a Punchh coupon campaign, create a dynamic generation coupon campaign as shown in the following image.
2. The Punchh coupon framework will generate the following parameters to enable dynamic coupon generation:
   • Dynamic coupon generation token: This is a system-generated security token for encryption.
   • Dynamic coupon generation URL: This URL will be embedded in the email as a link or image, as required by the business.

Step 2: Generate signature and construct URL

JWT.IO library is used to decode, verify, and generate JSON web tokens, an open, industry-standard RFC 7519 method for securely representing claims between two parties.

The ClaimType names mentioned below can be used to ensure the uniqueness of guests and coupons.

• email: represents the user’s email address.
• campaign_id: represents the system-generated Punchh campaign ID.
• first_name: captures the user’s first name.
• last_name: captures the user’s last name.

To use the Punchh dynamic coupon code API, a JWT Token must be constructed. The following shows how this can be accomplished using Liquid within Braze:

1
2
3
4
5
6
7
8
9
10
11
{% capture header %}{"typ":"JWT","alg":"HS256"}{% endcapture %}

{% capture payload %} {"email":"{{${email_address}}}","first_name":"{{${first_name}}}","last_name":"{{${last_name}}}","campaign_id":YOUR-CAMPAIGN-ID}{% endcapture %}

{% capture signature_structure %}{{header | base64_encode}}.{{payload | base64_encode}}{% endcapture %}

{% assign secret = "YOUR-DYNAMIC-COUPON-GENERATION-TOKEN" %}

{% assign final_signature = {{signature_structure | hmac_sha256_base64: {{secret}} %}

{% capture jwt %}{{signature_structure}}.{{final_signature | remove: '='}}{% endcapture %}

Step 3: Append coupon code in email content

Link to Punchh web page

On clicking the coupon URL, the user will be redirected to a Punchh-hosted web page, where the generated coupon will be displayed to the user as shown in the following image. For example, https://SERVER_NAME_GOES_HERE.punchh.com/request_coupons/YOUR-DYNAMIC-COUPON-GENERATION-TOKEN?sign=

Link image inside email content

The coupon code will be shown as an image within the email. For example, <img src="https://SERVER_NAME_GOES_HERE.punchh.com/request_coupons/YOUR-DYNAMIC-COUPON-GENERATION-TOKEN.png?sign=">

Associated error messages