Rewards represent incentives given to users for completing quests or other achievements. They are the tangible benefits users earn through platform engagement.Reward Types#
1.
Contains multiple unique coupon codes
Each code can only be redeemed once
Requires a CSV file with line-seperated codes
2.
Single reusable coupon code
All users get the same code
Good for general discounts
3.
Digital passes for events/venues
Includes expiration tracking
Key Features#
Flexible Distribution: Can be airdropped to collections
Redemption Tracking: Monitor which users redeemed which rewards
Multi-format Support: Digital coupons, access passes, etc.
Verification System: Entry codes can be validated via API
Data Structures#
Endpoints#
Method | Endpoint | Description |
---|
GET | /reward | Retrieve all rewards |
POST | /reward | Create new reward |
DELETE | /reward/{id} | Delete reward |
GET | /reward/{id}/redeem | Redeem already claimed reward |
PUT | /reward/{id}/airdrop | Airdrop reward to collection |
POST | /reward/entry-code | Generate entry pass code |
GET | /reward/entry-code/{code} | Validate entry code |
Modified at 2025-03-27 15:48:29