Rewards Shop

The following is a quickstart guide to creating contracts, minting assets, and listing assets on your marketplace frontend as a mint or auction.

Overview

Our asset creation tab in the admin tool consists of three separate flows that comprise the entire contract set and minting & auction page creation process:

1. Contract set up
2. Metadata configuration / asset creation
3. Listing or auction creation

Step by step

Contract set up:

1. Access the Asset Creation tab in the menu on the left and hit the create new contract button in the top right.

1. Hit the ‘Create New Contract’ button on the next modal to confirm you’ll be the owner on the contract. On the next tab you’ll:

   1. Input the collection name, symbol, and image along with optional description and external link.

   2. Choose the token type. Only one token type can exist on the NFT smart contract.

   3. Choose chain

   4. Optional: enable meta transaction if you plan to enable gasless transactions in the future via Stratus relayers

      .

   5. Choose the wallet address for mint and royalty payouts

Add Assets to Contract

1. The next step is to configure metadata to the contract as individual assets. We support individual asset creation to start, with .CSV upload and other multi-asset upload capabilities coming soon.
   1. Add asset name, description, info about the artist, media, and optional trait info
   2. Optional fields
      1. Add quantity limit: maximum amount mintable/wallet
      2. Add minimum: minimum amount to mint/transaction
      3. Burn to redeem: if you want users to burn the NFT to redeem it. You can add a field they need to fill in, show a blank text or collect shipping details(needs API integration).
   3. Click ‘Finish’ when you’re done or ‘Duplicate’ / ‘New Asset’ to add more

Listing

1. You can now hit ‘List Assets’ on the contract modal in the assets creation tab when ready to either list, create an auction or create a sweepstakes.

List assets for purchase

1. Choose the currency you’d like to list in (native currency or loyalty points if enabled)
2. Choose the price and the assets you’d like to list - to see which assets remain unlisted toggle over the ‘Unlisted Assets’ text in the modal’s topline.
   1. Note: you can either set the assets you want by asset ID either by comma separation or - (ie. 1,2,3,4 and 1-4 do the same thing)
3. Choose listing duration start and (optional) end time

List assets for auction

1. Add an auction name, description, duration, and currency
2. Note: Auctions can be tied to one or more than one onchain asset, so please add sufficient description to explain to the user what they’re bidding on
3. Choose your auction mechanics:
   1. Minimum Bid: The minimum amount any bidder can start the auction with
   2. Minimum Bid Increment: The minimum increase on any bid from the previous highest bid
   3. Reserve Price: The minimum bid that is valid to win the auction, this is the most important of these three inputs
4. Multi-Winner Auctions Only: By default, multi-winner auctions charge each bidder the amount they bid, if ‘Reverse Dutch Auction’ is toggled we’ll instead refund all winners the difference of their bid and the lowest price winning bid
5. Blind Auctions Only: If toggled on, users can only see their own bids. All other bids are hidden
6. Choose the prize!

List assets for sweepstakes

1. Add the sweepstakes name, description, duration, and entry token purchase currency
2. Choose the entry ticket and specify the total number of available tickets.
3. Choose the prize(s).

1. You’re live! View these listings as part of your marketplace!

Hide a collection from template pages

To prevent a collection from appearing on template pages (for example, the Loyalty page), you can hide it from the Rewards Shop.

1. Click the ‘Edit Rewards page’ button in the top right of the Rewards Shop.

2. In the Edit Rewards page settings, use the visibility control to hide or unhide the collection so it does not show on template pages (e.g., Loyalty).

Troubleshooting

NFTs not showing on your frontend (e.g., https://example.com/loyalty)

If some NFTs created in the admin are not visible on your public frontend, walk through the checks below.

These steps apply when your site consumes listings/collections configured in the admin. If your frontend uses a custom integration, ensure it queries the same contracts, networks, and listing types you configure here.

1. Ensure the collection is visible on template pages

   Open the Rewards Shop and click ‘Edit Rewards page’ in the top right, then make sure the collection is set to Visible so it can appear on template pages (e.g., Loyalty).

   After saving, the collection becomes eligible to render on template-driven pages.

2. Verify the assets are actually listed and currently active

   Creating assets alone will not show them to users. Confirm you used ‘List Assets’ and that:

   • The assets are included in the listing (IDs/ranges set correctly)
   • The listing start time is in the past and the end time (if any) has not passed
   • The listing status is active

   On the listing modal, toggle to ‘Unlisted Assets’ to find items you may have missed.

3. Match the page filters and currency type

   Template pages may filter by collection, category, or currency. For example, a Loyalty page typically shows listings priced in loyalty points. If you listed in a different currency (e.g., native token), those items may not appear on that page.

   If your page is configured to only show loyalty listings, standard crypto-priced listings won’t display there.

4. Confirm the correct chain/network

   Ensure your contract and listings are on the same chain your frontend is reading from. If your site points to a different network (e.g., testnet vs mainnet), listings will not appear.

5. Allow indexing time and hard refresh the page

   After creating or updating listings, allow a few minutes for indexing and caching to update, then hard refresh your frontend.

   If you use server-side caching or a CDN, purge the cache for the affected pages.

Still not seeing certain items?

• Collection not attached to the page: In ‘Edit Rewards page’, verify the targeted collection is included in the page layout/sections.
• Incorrect ID ranges: If you used ranges (e.g., 1-10), make sure all intended IDs fall within those ranges.
• Missing media or required metadata: Some templates hide items with incomplete media/fields; confirm each asset has the required fields and media URLs.
• Frontend filters: Check user-facing filters (collection, price type, availability) on the site aren’t excluding your items.