Table of contents
Step 1: Getting Started With an NFT Redemption Campaign

To begin using the redemption feature, you must first create a campaign. Follow the steps below:
- Click “Create Campaign”.
- You will be directed to the Create Campaign page.
- Enter your campaign name in the text field provided.
- This should be a unique and recognizable name for your promotion (e.g., Free Coffee August).
- Set your campaign duration:
- Select the start date under “From”.
- If you want the campaign to run indefinitely, check the “No end date” box.
- If the campaign has a specific end date, uncheck the box and select your desired end date under “To”.
- Once all fields are completed, click “Create Campaign” to proceed.

Step 2: Configure Merchant App Credentials
After creating your campaign, the next step is to configure your Merchant App settings. This ensures your store is properly set up to redeem NFTs.
- Set App Credentials:
- Username: Select an existing user from the dropdown or add a new one.
- Password: Enter a secure password for accessing the merchant app.
- Optionally, you can click “Change password” to update the password later.
- Define Your Store URL (App Slug):
Under the “Slug” field, enter your store name. This will generate your unique store link in the format: https://[yourstorename].shop.mintology.app
Make sure your slug is simple, recognizable, and URL-friendly (no spaces or special characters).
Once done, click “Save Configuration” to complete this step.

Step 3: Configure Your QR Code
Now it’s time to generate and personalize the QR code that your customers will scan to redeem their perks.
- Upload Your Logo (Optional):
- Click “Browse” to upload a logo file.
- Supported formats: .png, .jpeg, .jpg.
- The logo will be embedded into the center of your QR code.
- Customize QR Code Colors:
- Background Color: Set your preferred background color using the HEX code input or color picker.
- Toggle “Transparent background” if you want no background color.
- Dots & Marker Color: Customize the QR dots and corner markers to match your brand.
- You can also toggle “Gradient” for more styling options.
- Background Color: Set your preferred background color using the HEX code input or color picker.
- Preview Your QR Code:
- On the right panel, a live preview will update as you make changes.
- Ensure the QR remains clear and scannable, especially if using custom colors or logos.
- Once you’re satisfied, click “Save & Continue” to finalize the QR code setup.

Step 4: Configure the Success Page
This is what your customer will see when their NFT is successfully redeemed.
Enter Success Message:
- In the field labeled “Enter success message,” type the confirmation message you’d like your customers to see.
- Example: NFT Redeemed Successfully!
This message will appear prominently on the confirmation screen once redemption is complete.
Preview:
- A live mobile preview on the right shows how the message will appear to your users.
- This gives you a chance to adjust the wording for tone, branding, or clarity before going live.
Optional: Add More Sections
- You can click “+ Add new section” to enhance the success page with:
- Thank-you notes
- Instructions for next steps
- Promo codes
- Social media buttons
- Store links or customer service info
Once everything looks good, click “Done” to finalize your success page.

Step 5: Add Redeemables
Now that your campaign is live, it’s time to define what customers can actually redeem. This could be a discount, a product, or a service—known as a redeemable.
Add a Redeemable
- From your campaign dashboard, click the “Add redeemable” button.
- Fill in the Redeemable Name Example: Free Coffee, 20% Off Merch, or VIP Access Pass.
Redemption Criteria
- Choose Project Select the project associated with the NFTs you’re allowing to redeem this reward.
- Add Attribute (optional) Apply conditions based on specific NFT traits or metadata (e.g., only NFTs with a “Gold” tag).
Redemption Rules
- What is your customer redeeming? Enter the reward or offer they’ll receive, such as 10% off all accessories.
- How many times can each NFT be redeemed? Choose a redemption limit (e.g., once per NFT).
- Select Scan Type Choose how redemptions are verified:
- QR Code / Barcode (upload your code image)
- Coupon Code
- You can also add multiple rules if needed using the “Add new rule” button.
NFT Image Update (Optional)
You can visually update the NFT after full redemption:
- Update original image
- Add a layer on existing image
This helps signify a reward has been used or is now upgraded.
Once everything is configured, click “Add redeemable” to save.
Tip: Be descriptive but concise in the reward naming and criteria to avoid confusion at redemption time.

Step 6: Share the QR Code for Redemption
Once your campaign and redeemables are fully set up, you’re ready to distribute the redemption link to your customers.
Access Your QR Code
- From the campaign dashboard, locate the “Shareable QR code” section.
- Click the download icon to save the QR code to your device.
This QR code links directly to your merchant redemption interface.
How to Share
- Print the QR Code on flyers, posters, table tents, packaging, or product tags.
- Send Digitally via email, messaging apps, or embed it in your website or social media.
- Display In-Store on a tablet or poster for customers to scan and redeem on-site.
Related articles
What are redeemable digital products (NFTs)?
Gasless NFT claiming & redemption for customer rewards
FAQ on Creating Redemption Campaigns
An NFT redemption campaign links on-chain ownership to real world rewards or digital perks. It increases holder engagement, drives offline conversions, creates measurable utility for NFTs, and strengthens brand loyalty.
Create a campaign from the Mintology dashboard, name it, set the date range, configure Merchant App credentials and store slug, customize and test the QR code, build the success page, add redeemables and rules, then publish and distribute the QR code. For full step-by-step instructions see the setup section of this article.
When adding a redeemable, select the project that contains eligible NFTs and use the Attribute filter to define trait-based eligibility. This allows you to limit redemptions to NFTs with specific metadata, such as rarity level or token attributes.
Maintain high contrast between QR foreground and background, avoid overly large logos that obstruct detection, use the live preview and test on multiple consumer devices, set a minimum printed size for physical placements, host the store on HTTPS, and limit redemptions per NFT to reduce fraud and operational risk.
Verify that the redeemable is linked to the correct project, confirm attribute filters are not excluding tokens, check the Merchant App slug and configuration, review redemption rules and per-NFT limits, test with a known eligible token, and examine server logs or audit entries for errors. If the issue persists, collect an example token ID, timestamp, and a screenshot and contact Mintology support for assistance.
