How to use QR Code in MailUp
- Sales operations
The QR Code service is available only for the PLUS, PREMIUM, or ENTERPRISE editions of the MailUp account.
The service cannot be activated for other MailUp editions.
To directly use the QR Code generation system in MailUp, you need to insert the generation link into the body of the email you are writing, either as an image or as a download link. There are different types of QR Codes on the market, both standard and proprietary. MailUp generates only QR Codes of the type QR Code Model 2, also known as the standard basic QR Code. The default version is 5.
The link to generate a QR Code would be the following (this is an example): https://pseapi.servicesmu.com/api/mup/oqrcode/idconsole/[_idoptin]/[_hash]?data=test.
Where:
https://pseapi.servicesmu.com/api/mup/oqrcode and [_idoptin]/[hash] are fixed values,
idconsole is the identifier of the current MailUp console, the number that identifies the MailUp account,
?data=test is the value that will be encoded and can be a fixed value or a dynamic field, as detailed below.
For example, if my MailUp account has the identifier 88993, the link to use will be: https://pseapi.servicesmu.com/api/mup/oqrcode/88993/[_idoptin]/[_hash]?data=test
How to Use a Fixed QR Code (Encoding the Same Value for All Email Recipients)
To send the same QR Code, which encodes the same value, to all contacts receiving an email, the data parameter in the link must contain a fixed value.
For example, if my MailUp account has the identifier 88993:
The link
https://pseapi.servicesmu.com/api/mup/oqrcode/88993/[_idoptin]/[_hash]?data=testwill generate a QR Code that encodes the word "test".The link
https://pseapi.servicesmu.com/api/mup/oqrcode/88993/[_idoptin]/[_hash]?data=000121428will generate a QR Code that encodes the word "000121428".
Link | Coded value | Example of QR Code created |
|---|---|---|
https://pseapi.servicesmu.com/api/mup/oqrcode/88993/[_idoptin]/[_hash]?data=test | test |
|
000121428 |
|
How to Use a Dynamic QR Code (Encoding a Different Value for Each Email Recipient)
To send a personalized QR Code to all contacts receiving an email, the data parameter in the link must be associated with a Dynamic Field. In this way, during the email sending process, MailUp will associate the link with the value of the dynamic field present in the recipient's profile.
For example, if my MailUp account has the identifier 88993 and a field named cod_cli is defined, which indicates the customer code (different for each recipient registered in MailUp):
The link https://pseapi.servicesmu.com/api/mup/oqrcode/88993/[_idoptin]/[_hash]?data=[cod_cli] will generate a different QR Code for each recipient who receives the email. The QR Code will encode the customer code associated with each recipient (which is saved in the cod_cli field).
Link | Recipient | Value of the Dynamic Field cod_cli | Coded value | Example of QR Code created |
|---|---|---|---|---|
AF-123-666 | AF-123-666 |
| ||
721mailup.com721 | 721mailup.com721 |
|
How to Insert the QR Code as an Image in an Email
To insert a QR Code (whether dynamic or static) into an email message using the Drag & Drop editor:
Add an image.
Make the image Dynamic.
In the Dynamic URL of the image, insert the QR Code generation link (whether it is the dynamic or static generation link).
This way, the image specified in the email will be linked to the QR Code generator, and when the recipient receives the email, the QR Code image will appear in the designated position.
Editor Drag&Drop | Received Email |
|---|---|
|
|
If the dynamic field to be encoded for a recipient does not contain any value and the QR Code is inserted in the email as an image, that recipient will receive an email with an empty image.
Editor Drag&Drop | Received Email |
|---|---|
|
|
How to Enable the Download of a QR Code from an Email
To insert the QR Code as a download link (whether dynamic or static) using the Drag & Drop editor:
Add a link.
Insert the QR Code generation link as the URL (whether it is the dynamic or static generation link).
This way, the link in the email will be associated with the QR Code generator, and when the recipient clicks on the link, the QR Code image will be downloaded.
Use Cases
These Use Cases Are for Illustrative Purposes
Email for Sending Customer Code (Business Email Sending)
The use case can be described as follows:
As a Large Retailer, I want every new customer who registers on our website to receive an email message so they can present it at the checkout and receive a discount.
Using MailUp, we can translate this into the following needs:
As a Website, I want to save the "customer_code" field in MailUp's database with the code from our software systems that identifies a customer so that it can be linked to their email address and other personal data.
As a MailUp User, I want to send an email message to our customers containing their customer code so that they can use it directly at the checkout for identification.
As a Cashier, I want to scan the customer code with a reader to verify the customer's status without performing manual operations, reducing errors, and speeding up the checkout process.
My website is integrated with MailUp through REST APIs or a subscription form, allowing it to register recipients in MailUp while also importing the unique "customer_code" identifier. This creates a complete customer record, associating the unique value with an email address and other personal information.
In MailUp, I create a newsletter that includes a QR Code image encoding the customer_code field: https://pseapi.servicesmu.com/api/oqrcode/idconsole/[_idoptin]/[_hash]?data=[customer_code]
Each newly registered contact will receive the email message described above (either through an automated task or manually).
At checkout, the cashier scans the customer code from the email using a dedicated scanner, verifies the customer's status without manual input, reducing errors, speeding up the process, shortening queues, and minimizing wait times while allowing the customer to redeem their discount.
Email as an Entry Ticket (Transactional Email Sending)
The use case can be described as follows:
As an Event Organizer, I want to provide each registrant with a booking code so that they can use it as their event entry ticket.
Using MailUp, we can translate this into the following needs:
As a Booking Software Service, I want to use MailUp to promptly send event booking codes via email so that registrants have them available.
As an Event Attendee, I want to use the confirmation email I received as my entry ticket to avoid queues at the entrance.
As an Event Staff Member, I want to scan the entry code from the email using a reader so that I do not need to perform manual operations and can manage access more efficiently.
In this case, my booking software service is integrated with MailUp via transactional email APIs and uses MailUp as the sending engine to promptly deliver event booking codes via email to registrants.
In MailUp, I create a newsletter that includes a QR Code image encoding the merge tag [reservation]: (https://pseapi.servicesmu.com/api/oqrcode/idconsole/[_idoptin]/[_hash]?data=[reservation])
Where [reservation] is the merge tag containing the booking code provided by the Booking Software Service during the transactional email sending process.Each recipient will receive a booking confirmation email, using the newsletter template mentioned above, which includes a QR Code encoding the reservation code provided in the [reservation] merge tag from the booking software service.
The event attendee will use the automatically received booking confirmation email as an entry ticket, avoiding queues at the entrance.