Integrations
Connect your Tebex store to look up payments and subscriptions from a ticket, refund or pause them, and create hosted checkouts — with paid confirmations through your store's webhook.

The Tebex integration brings your store into the ticket. A member who hands you a transaction ID gets their payment shown as a card the moment the ticket opens; your team can look up payments and subscriptions with /tebex, refund a transaction, pause, reactivate or cancel a subscription, and create a hosted checkout the customer pays from a link. When Tebex reports the payment, the checkout card flips to Paid.

You connect with your store's Checkout API keys plus a webhook, all pasted once and stored encrypted. Integrations cost no feature token.

Find it under Integrations → Tebex in the dashboard. Saving and testing require administrator rights on the Discord server.

Connect your Tebex store

Keys from creator.tebex.io → Developers. Set the webhook up in this order: add the endpoint in Tebex using the URL shown on the Tebex page in your dashboard, paste its signing secret here and save — then run the endpoint validation in Tebex. Validation can only succeed once the secret is saved.

projectId
text
Your Checkout API project ID — the API "username". Encrypted at rest.
privateKey
secret
The Checkout API private key — the API "password". Never shown again; when editing later, leave it blank to keep the saved value.
webhookSecret
secret
The signing secret of the webhook endpoint you created in Tebex (Developers → Webhooks). Clarify uses it to verify that events really come from Tebex. Leave blank to keep the saved value.
accountLabel
text
An optional store label for your own reference.

The Tebex page also shows your Webhook URL with a copy button — it is unique to your server — and a Test connection button that checks the project ID and private key against Tebex.

How should lookups work?

currency
select
The currency for checkouts your team creates — EUR, USD, GBP, CAD or AUD. Default: EUR. Lookup cards show the currency Tebex reports.
autoLookupOnCreate
toggle
Auto-post order details when a ticket collects a Tebex ID through one of the ready-made inputs. Default: on.
enabledLookups
checkbox
Which kinds of lookup your team may run — Payments, Subscriptions, Baskets. None checked = all allowed. Unchecked kinds disappear from the /tebex picker and are skipped on ticket creation.

Info cards

cardBlueprint
blueprint
The three cards Clarify posts — Payment, Subscription and Checkout — are blueprints you can restyle. Placeholders fill with live data when a card is posted.
PlaceholderBecomes
%txn_id% · %reference% · %ident%Transaction ID, subscription reference, basket ident
%status%Payment or subscription status
%amount%Amount and currency
%created% · %next_payment%Creation date, next charge
%customer% · %email%The buyer
%products%The purchased packages
%recurring_reference% · %interval%Subscription details
%checkout_url% · %dashboard_url%Links; a button whose link is unavailable is hidden

Using it in a ticket

Automatic lookups

Enable one of the ready-made Tebex inputs in a category — Tebex Transaction ID (tbx-…), Tebex Subscription Reference (tbx-r-…) or Tebex Basket ID (see Ticket inputs). The matching card is posted with the ticket's opening message; an ID that cannot be found leaves a short notice.

/tebex

Any support member can run /tebex in your server. It opens a picker:

ActionWhat happens
Look up paymentEnter a transaction ID — the payment card is shown to you only.
Look up subscriptionEnter a subscription reference.
Refund paymentRefund a completed transaction by its ID.
Pause subscriptionPause a subscription until a date (YYYY-MM-DD).
Reactivate subscription · Cancel subscriptionResume, or permanently cancel, a recurring payment.
Create checkoutInside a ticket: product, unit price, quantity and (optionally) the customer's e-mail. Clarify creates a hosted Tebex checkout.

Creating a checkout posts a Tebex Checkout status card for your team — Awaiting payment, with Update status and Pay — and sends the customer a card with the Pay link. A ticket has one active checkout at a time. When Tebex sends the payment.completed event to your webhook, the card flips to Paid.

Hosted checkouts need Tebex's approval for the Checkout API on your store. Refunds and subscription actions are available to every support member; there is no separate permission for them.

Frequently asked

Ticket inputs

Enable the Tebex inputs in the categories that need them.

Cards & placeholders

How blueprints and placeholders work.

All integrations

Stripe, PayPal, Patreon, GitHub and webhooks.