In this scenario, we'll explore the process of attaching multiple links to the backside of a Wallet Template (Member Card), as illustrated in the image below:

📘

NOTE

In this example, every generated Pass will attach unique links, meaning each end user will receive a pass with personalized links.

Before beginning, it is essential to take into account the following prerequisites.

• You already have access to the Digital Engagement Platform.
• Get API Key: From the Digital Engagement Platform, copy the API Key located in Preferences section > API tab.

Create Wallet Template

As a suggestion, we advise creating and sending a wallet template to allow you to visualize the pass design through the Digital Engagement Platform. Therefore, the first step is creating a Member Card Campaign.

📘

NOTE

In this instance, every end user will receive a unique special discount for March and April 2024. To discover the discount type, end users need to click on the links situated on the backside of the pass.

🚧

WARNING

For testing purposes, send the member card to a single team member. The aim of creating this campaign is to preview the design of the member card.

From the Backside Fields dropdown while setting up the Content step, during the creation of the member card campaign, we set a couple of backside fields to be used for personalized URLs:

• Type: Unique.

  The Unique Fields are personalized for each member card that is generated, which means they are used to display personalized and variable fields for each user.

• Format: Text.

• Label: A Field Label that accompanies the text content on a member card.

  In this example, the labels will be: March Promotion, April Promotion.

• Value: Select any column of type string.

  In this example the set the name as value.

Get Wallet Template ID

Once the member card campaign has been created and sent to one member of the team. The next step is getting the unique identifier of the wallet template (“serial” parameter) via API through the following endpoint:

HTTP Request: GET /v2/wallet/templates

📘

NOTE

To retrieve only the wallet template that has been created recently, enter the next filter from the Query Params:

• limit: 1

curl -X GET "https://elastic.messangi.me/ironbank/v2/wallet/templates?limit=1&sort=-creationDate%2C%2Bname&select=name%2Cdescription" -H  "accept: application/json" -H  "Authorization: Bearer <YOUR_API_KEY>"

{
   "meta":{
      "timestamp":1706906992963,
      "transactionId":"ee9c461a-6215-4bc3-8747-836f55cde4e6"
   },
   "pagination":{
      "limit":1,
      "page":1,
      "pages":501,
      "total":501
   },
   "items":[
      {
         "serial":"65bd53d21dd",
         "name":"Member Card",
         "description":"New Promotion",
         "googlePayCompatible":false
      }
   ]
}

Response Body Parameters

1. Copy the request body and paste it in your terminal command.
2. Press Enter key
3. From the response body, copy the unique identifier of the wallet template (“serial”) parameter.

Set URLs & Create Wallet Pass

Once the unique identifier (“serial”) of the wallet template has been obtained the next step is setting the URLs while creating the pass via API.

HTTP Request : POST /v2/wallet/templates/{serial}/passes/batch

Before beginning, in this API call you need to provide the unique identifier (“serial”) of the Wallet Template previously created.

📘

NOTE

When creating one or more wallet passes, the request body contains the unique values you specified during the creation of the wallet template.

When creating the wallet template, it was included only two unique values located on the backside of the Wallet Template:

{
    "fields": [
        {
            "place": "BACK",
            "label": "March Promotion",
            "fixed": false,
            "value": "name"
        },
        {
            "place": "BACK",
            "label": "April Promotion",
            "fixed": false,
            "value": "name"
        }
    ]
}

📘

NOTE

In this request body, we will replace the "name" value in both "value" parameters with URLs that include HTML code for the href (hyperlink's destination):

"For more information, <a href=\"https://google.com/\">Click here</a>"

curl -X POST "https://elastic.messangi.me/ironbank/v2/wallet/templates/<Wallet_Template_ID>/passes/batch" -H  "accept: application/json" -H "Authorization: Bearer <YOUR_API_KEY>" -H  "Content-Type: application/json;charset=UTF-8" -d '{
  "items": [
     {
         "recipientId": "121314",
         "uniqueValues": {
             "fields": [
                 {
                     "place": "BACK",
                     "label": "March Promotion",
                     "fixed": false,
                     "value": "For more information, <a href=\"https://google.com/\">Click here</a>"
                 },
                 {
                     "place": "BACK",
                     "label": "April Promotion",
                     "fixed": false,
                     "value": "For more information, <a href=\"https://google.com/\">Click here</a>"
                 }
             ]
         }
     }
  ]
}'

Request Body Parameters

{
  "meta": {
    "timestamp": 1707107201954,
    "transactionId": "47402dda-dc94-496c-9aad-45504432d679"
  },
  "items": [
    {
      "recipientId": "121314",
      "url": "https://elastic-tyrion.messangi.me/R1214z"
    }
  ]
}

Response Body Parameters

Copy the value of the “url” parameter and paste it into your browser to download the wallet pass that has been created.

"Click here" is now clickable and redirects to the original URL.