Tipping module

The Tipping module lets your community support you directly. Viewers pay on your own tip page, and the money goes to your bank through Stripe. Each settled tip becomes a catalyst.tip event that travels the same pipeline as your subs and bits: reward rules, analytics, overlays, and a chat shout-out.

StreamerCatalyst takes no cut of your tips. The only deduction is Stripe’s card processing, and you choose whether tippers cover it or it comes out of the tip.

Available on the Free tier and above. See Module access by tier. Tip-triggered reward rules live in the Events module, which needs the Affiliate tier.

At a glance

Page	What it does
Overview	Today / 7-day / 30-day settled totals, your active goal, your public tip-page link, and the five most recent tips
History	The full tip ledger with status filters and CSV export, plus the message-approval queue
Goal	One active donation goal, its progress bar, manual adjustments for off-platform tips, and past goals
Settings	Turn the public page on, and pick your currency, amounts, fee mode, and message and anonymity rules
Payments	Stripe Express onboarding, payout status, recent payouts, and disconnect (broadcaster only)

Who can do what:

• Broadcaster and Lead Mods can change settings, create, edit and archive goals, record adjustments, and approve or reject held messages.
• Regular mods can see every page except Payments, read-only.
• Payments is broadcaster-only, because payouts are your own money. Mods see “Payments are managed by the broadcaster.” The dashboard home’s Tips card is broadcaster-only too.

Setting up

1. Payments → Set up payouts. Choose the country your bank account is in, then complete Stripe’s hosted onboarding: identity and bank account, with Stripe checking you’re 18 or over. StreamerCatalyst never sees or stores your bank details; Stripe holds them. If Stripe still needs something when you return, Payments lists it under Finish setting up payouts. The first-run setup checklist offers the same Connect your payouts step.
2. Settings → Enable public page. It’s off by default. Your page takes tips only once it’s on and Stripe has enabled your account to accept payments.
3. Settings → currency, amounts, fee mode, and message rules. The defaults are USD, a $1.00 minimum, a $1,000.00 maximum, preset buttons of 5 / 10 / 25, Tipper pays the fee, and Hold anonymous messages on.
4. Overview → copy your tip page link and share it in chat, your panels, and your socials.

Supported payout countries: Australia, Canada, Hong Kong, Japan, Mexico, New Zealand, Singapore, the United Kingdom, the United States, all 27 EU countries, Norway, Liechtenstein, and Switzerland. The country picker lists only these. If your Stripe account’s country isn’t supported, Payments shows Payouts unavailable in your country, and you can’t receive tips there until Stripe adds support.

Your public tip page

Your page lives at streamercatalyst.com/tip/<your-twitch-login> and is public, so no login is required to tip. Older tips.streamercatalyst.com/tip/<your-twitch-login> links keep working and redirect to it.

The address uses your current Twitch login. If you change your Twitch username, the link on Overview updates to the new one. Replace the old link wherever you’ve posted it: the old address looks up whoever holds that username now, so it no longer reaches you.

• Tip as yourself or anonymously. Tip as your Twitch name runs a one-click Twitch sign-in that reads nothing but the tipper’s identity. The page then tells them you’ll see their Twitch name and message. That sign-in is good for 10 minutes. Otherwise the tip is anonymous, and the page tells the tipper you see only the amount and their message. Anonymous tips are anonymous by construction: there’s no “type your name” box to spoof, and no payer identity is stored on the tip.
• Amounts. Your preset buttons plus a custom amount, bounded by your minimum and maximum. Zero-decimal currencies such as JPY are handled correctly.
• A price quote before paying. With Tipper pays the fee, the page shows the tip, the processing fee and the total, and says 100% of the tip goes to you. With Fee deducted from tip, it shows the amount the tipper pays.
• Message. Optional, and checked against your configured length when the tipper submits.
• Bot protection and payment. Every submission passes a Cloudflare Turnstile check, then goes to Stripe Checkout for payment. Card details never touch StreamerCatalyst. Tippers’ card statements show a StreamerCatalyst descriptor, never your legal name.
• Your goal. If a goal with a target is active, the page shows its title and progress.
• The fine print. The page footer states that a tip is a voluntary gift, not a purchase, and is non-refundable, and links to the Terms and Privacy Policy.

When the page is off, when Stripe hasn’t enabled payments on your account yet, or after you disconnect payouts, the page shows your name followed by “isn’t accepting tips right now.” Your history, goal, and payouts stay intact.

Fees and payouts

There is no StreamerCatalyst platform fee. The processing fee is calculated at Stripe’s published card rate: 2.9% plus 30 of your currency’s smallest unit (30¢ on a USD tip). The fee mode on the Settings page decides who absorbs it:

Fee mode	On a $5 tip	You receive
Tipper pays the fee (default)	The tipper is charged $5.46	$5.00
Fee deducted from tip	The tipper is charged $5.00	$4.55

The Settings page previews both using your own currency and first preset amount. In deduct mode, a tip too small to cover its own fee is refused.

Money is paid out by Stripe Express on Stripe’s standard schedule for your country, straight to the bank account you connected. The Payments page shows:

• Payout status. Either active with payouts enabled, or waiting on Stripe’s verification.
• Outstanding requirements. Anything Stripe still needs (verification documents and the like), with overdue items marked. If Stripe has disabled the account, a notice says it can’t receive tips until setup is finished.
• Recent payouts. The last five, each with its status, amount and arrival date.
• A currency note. If your payout currency differs from your tip currency, the page says so. Checkout always charges in your tip currency, and Stripe converts on payout.

Disconnect stops all future payouts and takes your tip page offline for new tips. Tips already in flight still settle.

Currency

Your channel has one tip currency, chosen in Settings from USD, EUR, GBP, CAD, AUD, NZD, JPY, CHF, SEK, NOK, DKK, PLN, CZK, HUF, BGN, RON, HKD, SGD, and MXN.

• The currency is locked while a goal is active. Archive the goal first.
• Changing currency converts nothing. In the Events module, Tips-rule thresholds and the per-viewer totals that cumulative Tips rules keep are plain amounts. After a switch, new tips count in the new currency on top of whatever was already there, so review your Tips rules and their progress after a change.

Minimum, maximum, and preset amounts are entered in major units (5, 10, 25). The minimum must be at least one whole unit of the currency (1.00, or ¥1) and no more than the maximum. You can have 1 to 12 presets, each between the minimum and maximum.

Messages, approval, and anonymity

Tip messages reach your overlays and your chat, so they get their own controls on Settings:

• Message length cap: 0 to 500 characters (default 500).
• Strip links (off by default): removes web addresses (http://, https://, www.) from the message.
• Profanity filter (off by default): replaces common profanity with asterisks.
• Hold anonymous messages (on by default) and Hold verified messages (off by default): held messages wait in the approval queue on History.
• Allow anonymous tips (on by default): turn it off to require Twitch sign-in.

The link and profanity filters run when the tip is submitted, so History and the CSV export show the filtered text.

How holding works

Only a tip that carries a message can be held. A held tip is paid and settles normally, so it counts toward your Overview totals and your goal at once. So does anything that reads your goal directly: the tip page, the Goal widget’s tip-goal source, a Subathon Goals ladder synced to your tipping goal, and the Event Page’s Tip goal card.

Nothing announces a held tip until it’s reviewed. There’s no chat shout-out, overlay alert, Events rule, Numbers entry, subathon time or leaderboard credit for it yet.

• Approve sends the tip out at that moment, message included, to everywhere a tip goes.
• Reject suppresses the message, and the tip is never announced. It stays in your Tipping totals and goal, but never reaches chat, overlays, Events, or Numbers.

Only paid tips can be reviewed. A held tip joins Messages awaiting approval on History once its payment settles, and a checkout the tipper abandons never appears there. A held tip that’s refunded or disputed before you review it leaves the list and is never announced. If you act on one from a list you opened before the refund, you’ll see a message saying so, and nothing changes. Regular mods can see the list but can’t act on it.

Goals

A donation goal is a target with a progress bar. It has a title (up to 100 characters), a target amount, an optional starting amount (credit for money raised before the goal existed), and optional start and end dates. Its currency is your channel currency.

One goal is active at a time. To start a new one, Archive current goal first. Archiving freezes the goal’s final total and moves it to Past goals.

Progress isn’t a running tally that can drift. It’s derived every time it’s read, from:

• settled tips in the goal’s currency made inside the goal’s window (from its start date, or from when you created it if there’s no start date, through its end date), plus
• your manual adjustments, plus
• the starting amount.

It never goes below zero. Tips are dated by when they were made, so a tip made before the goal existed doesn’t count even if it settles afterwards. A tip that settles late is picked up automatically, and a refunded or disputed tip drops out of the bar on its own.

The goal appears on:

• Overview and your tip page
• the dashboard home’s Tip goal card
• the Goal progress widget’s tip-goal source and a Subathon Goals ladder set to Sync progress with the active tipping goal
• the Event Page’s Tip goal card
• an imported StreamElements widget’s tip-goal

Overlays update the moment a tip settles or a goal changes.

Manual adjustments

Received something off-platform (PayPal, Ko-fi, cash at a meetup)? Goal → Manual adjustments moves the bar by hand while a goal is active. Pick Direction (add or subtract), the amount, and an optional private Note of up to 200 characters.

When you add, two more fields appear:

• From (Twitch username, optional) credits the money to a name. It shows as Anonymous when left blank. The name is displayed as typed and isn’t looked up on Twitch, so in Events the adjustment counts per tip, never toward a viewer’s cumulative total.
• Announce like a real tip (alerts, chat, rewards) is on by default. An announced adjustment reaches everything a settled tip does, including Numbers’ tip figures and the tippers leaderboard. Untick it to move the bar silently.

Subtractions never announce, and they don’t undo what an earlier announced adjustment already triggered. The note stays private: it never appears in an alert or in chat. Adjustments are listed under the goal on the Goal page. They never appear in History or the Overview totals, and they can’t be reversed by a refund, because there was never a payment behind them.

Recording a tip on the ledger

Adjustments are the dashboard’s way to count off-platform money. An off-platform tip can also be recorded directly on the ledger, where it’s stored as settled, counts in History and your totals, and is announced like any other tip. This is available through the API only (see the endpoint reference); the dashboard has no control for it. A tip recorded this way has no payment behind it, so it can’t be refunded.

History and the ledger

Every tip lands in the ledger with a status:

Status	Meaning
pending	Checkout started, payment not confirmed yet. An abandoned checkout stays pending and never counts
settled	Paid. Counted in totals and goals, and announced (unless its message is held or rejected)
refunded	Refunded. The tip is reversed out of totals and goals
disputed	The cardholder opened a chargeback. The tip is reversed out of totals and goals

• Browsing. Filter by status. The list loads 50 tips at a time; Load more fetches older ones.
• Export CSV saves the rows currently loaded (date, status, amount, currency, tipper, message), so load further back first if you need older tips. Cells that a spreadsheet would read as a formula are escaped.
• Anonymity. Anonymous rows show “Anonymous” and never carry payer identity, in the UI or the export. No payer email or card details are shown anywhere.
• Overview totals. These count settled tips only. Today counts from midnight UTC; the 7- and 30-day figures are rolling.

Settlement

A tip normally settles within seconds of payment. If a payment notification is missed, a backup check runs every five minutes. It picks up tips still pending 10 minutes after checkout (for up to 48 hours) and settles the ones Stripe says are paid, so tips can’t get stuck.

A tip the backup check settles within an hour of checkout is announced as normal. Later than that, it settles quietly: it counts in your totals and goal, but isn’t announced or sent to Events, Numbers, or overlays, so chat doesn’t get a stale shout-out.

Refunds and chargebacks

• Refunds are issued by StreamerCatalyst support. A refund reverses the transfer from your connected Stripe account and marks the tip refunded. Tips recorded without a payment can’t be refunded.
• Chargebacks mark the tip disputed. StreamerCatalyst automatically submits a description of the tip to Stripe as dispute evidence.

Either way, the tip is reversed out of your Overview totals, your goal, Numbers, and the tippers leaderboard. Events rewards it earned stay in your list with a funding reversed badge, so you decide whether to honour them, and the viewer’s cumulative tip total is rolled back. Chat messages and alerts already shown aren’t retracted.

Where tips show up

A settled tip fans out across the platform:

Destination	What you get
Events	The Tips rule trigger: reward rules that fire on tip thresholds, single or cumulative, while an event is active. Cumulative and meta rules need a Twitch identity, so they count tips from signed-in tippers. Anonymous tips and adjustments earn per tip
Numbers	Tips and Tips (amount) as KPI cards and chart metrics, and per stream session
Widgets	Alerts for the Events rewards a tip earns. Goal progress on your tip goal. Leaderboard and Ending credits list top tippers. Subathon timer adds time at Minutes per $1 tipped. Subathon goals counts tips, or syncs with your tipping goal. Wheelspin can spin when a tip crosses a threshold
Chatters	A chat shout-out for each announced tip, set up in Chatters → Bot Setup → Tip Announcements. It’s on by default and needs the Chatters bot enabled. The template can be up to 300 characters, with $(name) (the tipper, or “Anonymous”), $(amount) and $(message). Blank uses the default, $(name) just tipped $(amount)! $(message)
Event Page	A Tip button to your tip page, the Tip goal card, and a Tippers leaderboard
Dashboard home	The Tips card (broadcaster only), the Tip goal card, and tips in the Activity feed
Custom widgets	tip-latest (name, amount in major units, currency, message) and tipping.goal-progress. Imported StreamElements widgets also get tip-goal and tip session counters from your ledger

A revoked tip (refund or chargeback) is corrected in totals, goals, Numbers, and leaderboards. Chat and overlay alerts already shown are not retracted.

Tips & ideas

Idea	How
Subathon funded by tips	Set Minutes per $1 tipped on the Subathon Timer widget, then set the Subathon Goals ladder to Single type → Tips and turn on Sync progress with the active tipping goal
Tip reward ladder	Tip rules at $10 / $50 / $100 in Events; set Unlock Lower Rewards to “Once each” so a big tip doesn’t flood your pending list
Keep chat clean	Leave Hold anonymous messages on and turn on Strip links, since anonymous text is the usual source of trouble
Cover your own fees	Leave fee mode on Tipper pays the fee so a “$25 tip” is $25 in your pocket
Migrate an existing goal	Create the goal with a starting amount equal to what you’ve already raised elsewhere

Troubleshooting

• The tip page says “…isn’t accepting tips right now.” Check that Enable public page is on and that Payments shows your account active. The Event Page’s Tip button always links to your tip page, so it shows this message while tipping is off.
• A tipper sees “Identity verification required for a non-anonymous tip”. Their Twitch sign-in on the tip page expired (it lasts 10 minutes). They can sign in again or tip anonymously.
• A tipper sees “Anonymous tips are not allowed for this channel”. Allow anonymous tips is off, so they need to use Tip as your Twitch name.
• A tipper sees “amount too small after processing fees”. You’re on Fee deducted from tip and the amount wouldn’t cover the fee.
• “Archive the active goal before changing currency” or “Archive the current goal before creating a new one”. Archive the active goal on the Goal page first.
• A tip didn’t announce. Its message may be waiting on History → Messages awaiting approval, or it settled more than an hour after checkout. For chat specifically, check that the Chatters bot and Tip Announcements are on. For Events rules, check that an event is active.
• Tip alerts consistently arrive about ten minutes late. Payment notifications aren’t reaching StreamerCatalyst, and the backup check is settling your tips instead. That’s on StreamerCatalyst’s side, so contact support.

API and endpoint reference

See Tipping — API endpoints for the full list of HTTP endpoints.

Auth reference

See Tipping — Authentication & permissions for the Twitch OAuth scopes and EventSub subscriptions this module uses.