Paid Tebex Integrator 1.0.0

Requirements​

• ShadowBot - This is an Addon for ShadowBot. All configuration is done through the web interface.
• Tebex API secret (from your Tebex server settings)
• Tebex Plus subscription for gift cards, coupons, and sales features
• Webhook URL configured in Tebex for real-time payment processing (optional but recommended)

Features​

• Automatic Store Sync - Tebex store data syncs automatically on a schedule — payments every 5 minutes, gift cards every 15 minutes, packages every 6 hours. All data cached locally so the dashboard loads instantly. Full sync on first startup.
• Dashboard Overview - Stats cards showing total packages, payments, revenue, active gift cards, coupons, bans, players, and sales. Store info, currency, game type, and sync status with manual trigger buttons.
• Payment Management - Browse transactions with pagination, search by player/email/transaction ID, filter by status. View full payment details, gift packages to players, or update notes.
• Gift Card System - Create, top-up, and void gift cards with configurable balance cap. Link cards to Discord users for reward profiles. Cards with $0 auto-voided unless auto top-up is enabled.
• Auto Top-Up - Automatic gift card top-ups on weekly or monthly schedules. Configure amount and day per player with balance cap enforcement and configurable notifications.
• Loyalty Tiers - Reward top spenders automatically. Define spending thresholds with discount tiers — players receive coupon codes via DM when crossing thresholds. Default tiers: Bronze, Silver, Gold, Diamond. Fully customizable.
• Coupon Management - Create coupons with discount type, scope, usage limits, expiry dates, and minimum basket amounts. All coupons sync from Tebex automatically.
• Sales & Community Goals - View active sales with discount details and time ranges. Track community goal progress with visual indicators. Both sync automatically.
• Webhook Processing - Real-time payment processing with full reward pipeline: duplicate prevention, ban checking, Discord lookup, gift card updates, spending tracking, loyalty checks, DM notifications, and channel announcements. Signature validation and IP whitelisting.
• Message Templates - Fully customizable notifications with template variables. Seven template keys: Manual Top-Up, Auto Top-Up, Loyalty Tier, Purchase DM, Purchase Channel, Payment Issue, Gift Card Created. Supports plain text and Embedder rich embeds.
• Player Profiles - Track linked gift cards, spending totals, auto top-up config, and full reward activity log per player. Search by username or Discord ID.
• Bans & Queue - View banned users with reasons and dates. Monitor the Tebex command queue for pending deliveries.
• Tebex Plus Detection - Automatically detects Tebex Plus features. Gift Cards, Coupons, and Sales tabs only appear when Tebex Plus is active.

Admin Highlights​

• Settings tab with collapsible sections for API key, webhook secret, balance cap, notification channel, loyalty tiers, coupon templates, message templates, and IP whitelist
• Access Control tab to restrict dashboard access by Discord role — separate permissions for payments, gift cards, coupons, bans, players, settings, and more
• Manual sync buttons per data type — force a refresh without waiting for the next scheduled sync
• Embedder Message Library integration — use stored embeds for any notification with plain text or rich embed mode
• Gift card linked player column — see at a glance which cards are assigned and which need linking

Cross-Addon Integration​

• Birthdays - Creates gift cards or coupons as birthday rewards
• Giveaways - Creates gift cards or coupons as prize rewards
• Vote Rewards - Creates gift cards or coupons as vote threshold rewards
• Embedder - Uses stored embeds from the Message Library for rich DM and channel notifications

Availability​

Available on all versions of ShadowBot:

• ShadowBot Discord
• ShadowBot ASA
• ShadowBot ASE

License can be used across all versions

Notes​

• This is an Addon for ShadowBot - all configuration is done through the web interface
• Tebex Plus is required for gift cards, coupons, and sales features
• Webhook configuration is optional but recommended for real-time payment processing

Support/Questions​