๐Ÿ“ขA๐—ฏ๐—ถ๐—น๐—ถ๐˜๐˜† ๐˜๐—ผ ๐—–๐—ฅ๐—˜๐—”๐—ง๐—˜ ๐——๐—ถ๐—ณ๐—ณ๐—ฒ๐—ฟ๐—ฒ๐—ป๐˜ ๐—•๐—ฎ๐—ฑ๐—ด๐—ฒ๐˜€/ ๐—ฆ๐˜๐—ฎ๐—บ๐—ฝ๐˜€ ๐—ณ๐—ผ๐—ฟ ๐˜€๐—ฎ๐—บ๐—ฒ ๐—ฆ๐—ง๐—”๐— ๐—ฃ ๐—ฐ๐—ฎ๐—ฟ๐—ฑ๐Ÿ“ข
Each StampType has: name, icon/image, color, description, optional location_scope, earn_rules, limits.
๐—ฆ๐—ฐ๐—ฒ๐—ป๐—ฎ๐—ฟ๐—ถ๐—ผ: Clients are motivated by triggering an action and what better action is there than to acquire different types of badges for different actions taken. For example a business has several different outlets in various parts of the country. A client acquires the various different STAMPS as they frequent the different outlets getting the ultimate award for visiting each outlet. For example a member visits a pub/ bar in Texas and its sister company in Florida then another in Las Vegas acquiring the various stamps at each location.
A client buys membership to a museum group visits the art museum and collects the art stamp, visits the science expo and collects a different stamp, visits the car museum another and so and so on, once acquiring all the stamps gets the ultimate reward.
Different stamps can be as simple as purchasing a coffee, stamp 1, purchasing a croissant = different stamp. Stamps can be based on day of the week time of day ect. Therefore the system must be configured that when trigger is met STAMP is issued. Creating hype and motivating purchases where they are required.... diversity drives engagement.
๐—ฅ๐—˜๐—ค๐—จ๐—œ๐—ฅ๐—˜๐— ๐—˜๐—ก๐—ง: Enable multiple distinct stamp/badge types on a single Boomerangme stamp card and allow merchants to define a Collection (set of stamp types) with completion rules (All-of, Any-N, or Sequence) that, when met, auto-issues a configured reward. Each stamp type must support its own trigger(s) (e.g., geofence, dynamic QR/NFC, POS spend/item, staff PIN, day/time) and limits/validation (rate-limit, GPS/SSID, POS checksum). Provide minimal APIs/webhooks to issue a specific stamp_type_id and notify on collection completion. Member UI shows collection progress; Admin UI configures stamp types, rules, triggers, and reward.
๐—–๐—ผ๐—น๐—น๐—ฒ๐—ฐ๐˜๐—ถ๐—ผ๐—ป๐˜€
Ability to group selected StampTypes into a Collection on the card.
Completion rules: ALL, ANY-N-of-M, or SEQUENCE.
Collection has: name, rule, N (if Any-N), optional expiry_window, assigned Completion Reward.
๐—˜๐—ฎ๐—ฟ๐—ป ๐—ฅ๐˜‚๐—น๐—ฒ๐˜€ (๐—ฝ๐—ฒ๐—ฟ ๐—ฆ๐˜๐—ฎ๐—บ๐—ฝ๐—ง๐˜†๐—ฝ๐—ฒ)
Supported triggers (configurable, any combo): Geofence, Dynamic QR/NFC, Wi-Fi SSID match, Staff PIN,
POS: min_spend, POS: item/category, Temporal: daypart/date, Streak.
Limits: per_member_rate_limit (e.g., 1/24h), per_day_cap, per_location_cap.
๐—ง๐—ฟ๐—ถ๐—ด๐—ด๐—ฒ๐—ฟ๐˜€ (๐—ต๐—ผ๐˜„ ๐˜€๐˜๐—ฎ๐—บ๐—ฝ๐˜€ ๐—ฎ๐—ฟ๐—ฒ ๐—ฒ๐—ฎ๐—ฟ๐—ป๐—ฒ๐—ฑ)
๐—˜๐—ฎ๐—ฐ๐—ต ๐—ฆ๐˜๐—ฎ๐—บ๐—ฝ๐—ง๐˜†๐—ฝ๐—ฒ ๐—บ๐˜‚๐˜€๐˜ ๐—ต๐—ฎ๐˜ƒ๐—ฒ ๐—ถ๐˜๐˜€ ๐—ผ๐˜„๐—ป ๐˜๐—ฟ๐—ถ๐—ด๐—ด๐—ฒ๐—ฟ(๐˜€):
๐™‘๐™ž๐™จ๐™ž๐™ฉ / ๐™‹๐™ง๐™š๐™จ๐™š๐™ฃ๐™˜๐™š
โœ… Geofence (GPS radius)
โœ… Dynamic QR/NFC at store
โœ… Number of visits within a period
๐™๐™ง๐™–๐™ฃ๐™จ๐™–๐™˜๐™ฉ๐™ž๐™ค๐™ฃ-๐™—๐™–๐™จ๐™š๐™™
โœ… Minimum spend
โœ… Product/category purchased
๐™๐™š๐™ข๐™ฅ๐™ค๐™ง๐™–๐™ก
โœ… Daypart (e.g., weekday mornings only)
โœ… Event day(s)
โœ… Streaks (e.g., 3 Fridays in a row)
๐™€๐™ฃ๐™œ๐™–๐™œ๐™š๐™ข๐™š๐™ฃ๐™ฉ
โœ… Scavenger hunt clues (scan codes in-venue)
โœ… Workshop/class attendance
โœ… Account milestone (birthday, anniversary)
๐—ช๐—ต๐˜† (๐—•๐—จ๐—ฆ๐—œ๐—ก๐—˜๐—ฆ๐—ฆ ๐—ฅ๐—”๐—ง๐—œ๐—ข๐—ก๐—”๐—Ÿ๐—˜)
๐——๐—ฟ๐—ถ๐˜ƒ๐—ฒ ๐—ฐ๐—ฟ๐—ผ๐˜€๐˜€-๐—น๐—ผ๐—ฐ๐—ฎ๐˜๐—ถ๐—ผ๐—ป/๐—ฐ๐—ฎ๐˜๐—ฒ๐—ด๐—ผ๐—ฟ๐˜† ๐—น๐—ถ๐—ณ๐˜: Turns one card into a โ€œpassport,โ€ incentivizing visits across outlets or experiences; increases breadth of spend.
๐—›๐—ถ๐—ด๐—ต๐—ฒ๐—ฟ ๐—ฐ๐—ผ๐—บ๐—ฝ๐—น๐—ฒ๐˜๐—ถ๐—ผ๐—ป ๐—บ๐—ผ๐˜๐—ถ๐˜ƒ๐—ฎ๐˜๐—ถ๐—ผ๐—ป: Collection mechanics (All/Any-N/Sequence) meaningfully boost repeat visits vs. identical stamps.
๐—–๐—น๐—ฒ๐—ฎ๐—ป๐—ฒ๐—ฟ ๐—ผ๐—ฝ๐˜€ & ๐—จ๐—ซ: One card replaces many; less card sprawl, simpler messaging, clearer progress = higher adoption.
๐—ง๐—ฎ๐—ฟ๐—ด๐—ฒ๐˜๐—ฒ๐—ฑ ๐—ฝ๐—ฟ๐—ผ๐—บ๐—ผ๐˜๐—ถ๐—ผ๐—ป๐˜€: Per-stamp triggers let merchants nudge specific behaviors (off-peak, product trials, events).
๐—”๐˜๐˜๐—ฟ๐—ถ๐—ฏ๐˜‚๐˜๐—ถ๐—ผ๐—ป & ๐—ถ๐—ป๐˜€๐—ถ๐—ด๐—ต๐˜๐˜€: Per-type analytics and completion webhooks tie campaigns to revenue and reveal drop-offs.