Tebex

Configure Tebex store integration, webhooks, and purchase notifications

Introduction

The Tebex configuration file (tebex.json) integrates your Tebex store with Discord for purchase notifications, coupon management, and payment event logging.

---

Tebex Secret Key

Type: String

Your Tebex API secret key.

tebex_secret_key: "your_secret_key_here"

Required for:

• Creating/modifying/deleting gift cards

• Creating/modifying/deleting coupons

• Banning users from your store

How to find it: https://docs.tebex.io/store/faq#how-can-i-find-my-secret-key

Security Warning: Never share this key with untrusted individuals. This key grants full access to your Tebex store management.

---

Tebex Webhook Secret

Type: String

Webhook secret for verifying Tebex requests.

tebex_webhook_secret: "your_webhook_secret_here"

Setup Instructions:

1. Visit https://creator.tebex.io/webhooks/endpoints

2. Create a new webhook endpoint

3. Set URL to: http://<web_api_baseip>:<web_api_port>/api/tebex

4. Select webhook type: "All events" (enable all checkboxes)

5. Copy the webhook secret to this config

Required for:

• Purchase notifications

• Admin and player logs

• All store event tracking

---

Tebex Logs

Type: Object

Configure which store events should be logged to Discord.

tebex_logs: {
    purchase_public: true,
    purchase_private: true,
    payment_declined: true,
    payment_refunded: true,
    payment_dispute_opened: true,
    payment_dispute_closed: true,
    payment_dispute_won: true,
    payment_dispute_lost: true,
}

purchase_public

Type: Boolean

Public purchase announcement for your community.

When true: Sends a community-friendly purchase notification (no sensitive info like price) When false: No public announcement

---

purchase_private

Type: Boolean

Detailed purchase log for admins.

When true: Sends detailed purchase information to admin channel When false: No private admin log

Contains more detailed information than public announcements.

---

payment_declined

Type: Boolean

Log when payments are declined.

payment_declined: true

---

payment_refunded

Type: Boolean

Log when payments are refunded.

payment_refunded: true

---

payment_dispute_opened

Type: Boolean

Log when payment disputes/chargebacks are opened.

payment_dispute_opened: true

---

payment_dispute_closed

Type: Boolean

Log when payment disputes are closed.

payment_dispute_closed: true

---

payment_dispute_won

Type: Boolean

Log when payment disputes are won in your favor.

payment_dispute_won: true

---

payment_dispute_lost

Type: Boolean

Log when payment disputes are lost.

payment_dispute_lost: true

---

Store Link

Type: String

Your Tebex store URL.

store_link: "https://yourstore.tebex.io"

When configured: A "Visit Store" button is added to public purchase announcements When empty: No button is displayed

---

Complete Configuration Example

Here's a production-ready Tebex configuration:

{
    config: {
        tebex_secret_key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",

        tebex_webhook_secret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",

        tebex_logs: {
            purchase_public: true,
            purchase_private: true,
            payment_declined: true,
            payment_refunded: true,
            payment_dispute_opened: true,
            payment_dispute_closed: true,
            payment_dispute_won: true,
            payment_dispute_lost: true,
        },

        store_link: "https://yourstore.tebex.io",
    },
}