Donation

Tips give you a public donation page wired to several payment providers. A completed payment can fire an on-screen alert, add marathon time and count towards a goal, with leaderboards and records to review afterwards.

What it solves

Every tipping platform has its own page and its own notifications, which makes stitching them together messy. This connects taking the payment to what happens next: one tip can pop an alert, add time and push a progress bar, while viewers only ever see a single page. For the supporter, seeing something happen on screen is what makes the money feel like it arrived.

Getting started

1. Choose your payment providers and enter that merchant's integration details.
2. Paste the return URL the system gives you into the provider's dashboard.
3. Set your notification threshold and monthly caps.
4. Share the public donation page with your viewers.

Monthly caps: why you'd want one

You can set an overall monthly cap, and optionally a separate cap per payment provider (an advanced option). When a provider hits its cap for the month it's hidden from the public donation page automatically and comes back next month — no manual toggling.

This isn't only about "receiving too much". Two things tend to show up once the amount crosses a line:

• The provider's contract threshold. Above a certain volume, a payment provider may require you to move to a paid plan or sign a formal commercial agreement.
• Tax registration. In Taiwan, selling services online (ad revenue share, subscriptions, tips) with monthly sales reaching NT$50,000 requires registering for tax purposes.

What makes this awkward is that it's assessed per month. It's entirely possible for only one month all year — a birthday stream, an anniversary — to cross the line, and still leave you dealing with the registration and filing that follows. Setting the monthly cap below the threshold keeps takings inside the line on their own, instead of scrambling mid-month to ask people to stop.

The figures and rules above are given for context only; what actually applies depends on the authorities' current announcements and the regulations in your own jurisdiction.

Common misconceptions

• Keys are stored encrypted and never returned. Fields like HashKey / HashIV are write-only — leaving them blank keeps the existing value rather than clearing it. Not being able to see them is expected.
• Without the return URL, payments may not credit automatically. The provider's official callback is the most reliable source of truth — paste the system's URL into their dashboard so payment results are reported back.
• PayPal needs no keys. Click "connect PayPal", authorise, and you're done; funds (USD) go straight to your PayPal account.
• The AlertBox URL is a stopgap, not an official channel. It can receive tips before official integration is set up, but it's an unofficial route and may stop working. Configuring proper integration disables it automatically (the URL is kept). One URL can only be bound to one channel.
• At the monthly cap, that provider is hidden from the public page automatically. It comes back next month — no manual toggling needed.

Settings

The text below is taken from the in-app help, so it stays in sync with the actual interface.

Other notes

• Enter your Merchant ID, HashKey and HashIV to complete official integration; official notifications are the most reliable way to record payments.
• 🔒 HashKey / HashIV are encrypted at rest and never returned. Leave blank to keep the current value; you can only overwrite, not read them back.
• The total monthly cap already covers most reporting thresholds; per-gateway caps are an advanced option. When a gateway hits its cap, it's automatically hidden from the public tip page and restored automatically next month.
• A stopgap donation channel before official integration is complete: paste the "donation success animation URL" to start receiving donations. This is an unofficial channel and may stop working in the future; it's automatically disabled once "Integration info" is configured (the URL is kept and resumes automatically if you clear the integration info). Each URL can only be linked to one channel.
• Enter this URL in the vendor portal so payment results are automatically reported back to this system to complete the payment record.
• UUID format (36 characters, e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
• Add the URL below to the "Callback URL" setting in your Unifi merchant console. Without it, order creation fails and viewers cannot donate.
• Deleting a record rolls back any linked goal progress.
• Fetches matching orders in batches and combines them into one CSV file.
• You've accepted the service fee terms. Once your payment method and content are ready, come back and turn on the switch above so the public page goes live.
• Share this link with your viewers or add it to your stream info panel.
• Drag to reorder the pay buttons on your public page. Providers you turn off are hidden there but keep their spot, so switching one back on won't shuffle the rest.
• Comma-separated, up to 6 (positive integers).
• The minimum amount is also the floor for estimated video tip amounts.
• Estimated amount = playback seconds × price per second (floored at the minimum amount).
• The public tip page is disabled over a service fee bill. Check its status on the Service fee tab.
• You must accept the service fee terms before you can view or adjust the tip page settings.
• This is the service fee ChiwaBots charges you, not a transaction fee from your payment provider (ECPay/OPay/PayPal, etc.) — the provider fee is just one line already deducted in the calculation below.
• Pay the overdue bill below and the public tip page will unlock automatically.
• Fee = (revenue − provider fees − exemption) × rate. Settled monthly; balances below the billing threshold carry over to the next month indefinitely.
• Below the billing threshold, so nothing is billed this period and the balance carries over indefinitely.
• The USD amount was converted when the bill was issued and is not affected by later rate changes.

Other settings

These settings have no additional help text in the dashboard; only their names are listed here.

• Manage your donation credentials, records, leaderboard and goals.
• Orders
• Records
• Tip page
• Service fee
• Payment
• Manual
• ECPay
• OPay
• PAYUNi
• NewebPay
• PayPal
• Unifi Pay
• Integration info
• Enter your Merchant ID, Hash Key and IV Key to complete official integration; official notifications are the most reliable way to record payments.
• Enter your Merchant ID, HashKey and HashIV to complete official integration; official notifications are the most reliable way to record payments.
• Merchant ID
• HashKey
• HashIV
• Hash Key
• IV Key
• HashKey
• HashIV
• Must be exactly 32 characters
• Must be exactly 16 characters
• Configured
• Not set
• Clear
• 🔒 Hash Key / IV Key are encrypted at rest and never returned. Leave blank to keep the current value; you can only overwrite, not read them back.
• 🔒 HashKey / HashIV are encrypted at rest and never returned. Leave blank to keep the current value; you can only overwrite, not read them back.
• Invalid merchant ID (must be 10 alphanumeric characters).
• Invalid merchant ID format (must be 5–15 alphanumeric characters).
• Monthly receiving cap
• Monthly cap (TWD)
• Monthly cap (USD)
• Unlimited
• Monthly cap saved
• Linked
• Pending
• Connect with PayPal
• Refresh status
• Unlink
• Merchant ID
• PayPal linking is not available yet on this platform.
• Privacy notice: with a personal PayPal account, your legal name is shown to viewers during checkout and on receipts. We strongly recommend a PayPal business account with your channel/brand name as the business name. PayPal will also show you each donor's real name and email (PayPal behavior that cannot be hidden); this site only ever displays the nickname entered on the tip form.
• Streamer donations
• Donation success animation URL
• Format: https://payment.ecpay.com.tw/Broadcaster/AlertBox/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
• Format: https://payment.opay.tw/Broadcaster/AlertBox/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
• Go to streamer payment setup
• Scraping active
• Scraping disabled (official integration takes priority)
• Streamer donation settings saved
• Payment completion notification return URL
• Donation payment success notification URL
• Reminder: the integration info must also be configured so the system can verify incoming notifications; until then, payment notifications cannot be recorded.
• Copy
• URL copied
• Copy failed — copy the URL manually
• Open vendor portal
• Step-by-step guide
• Get your ECPay integration info
• Go to the ECPay vendor portal, then click "System Settings → System Integration Settings" (系統設定 → 系統介接設定).
• In the "Integration info" (介接資訊) section, find your Merchant ID, and the integration HashKey and HashIV on the "Payment, MPOS" (金流、MPOS) row.
• Enter all three values into the "Integration info" fields on this page and save.
• Get your OPay integration info
• Go to the OPay vendor management portal, then click "System Development Management → System Integration Settings" (系統開發管理 → 系統介接設定).
• In the "Integration info" (介接資訊) section, find your Merchant ID and the "ALL IN ONE integration HashKey / HashIV" (ALL IN ONE 介接 HashKey / HashIV).
• Enter all three values into the "Integration info" fields on this page and save.
• Get your PAYUNi API credentials
• Sign in to the PAYUNi merchant portal, then open "Member → Shop List" in the sidebar and select your shop.
• Switch to the "API Settings" tab and find the "API Keys" section.
• Copy the Merchant ID, Hash Key and IV Key, then paste them into the credentials fields on this page and save.
• Get your NewebPay API credentials
• Sign in to NewebPay and open "Member Center → Store Management"; the "Merchant ID" column in the store list is your MerchantID (e.g. MS012345678).
• In that store's row, click "Settings" in the "Store Settings" column.
• On the store profile settings page, scroll down to the "API Keys" section and copy the HashKey and HashIV into the fields below.
• Set the payment completion notification return URL
• Go to the ECPay vendor portal, then click "Payment Tools → Streamer Payment" (收款工具 → 實況主收款).
• Paste the return URL from this page into the "Payment completion notification return URL" field.
• Click "Save Settings" to finish; future donation payment results will be reported to this system automatically.
• Set the donation payment success notification URL
• Go to the OPay vendor portal, then click "I want to collect payments → Streamer Payment → Streamer Payment Settings" (我要收款 → 實況主收款 → 實況主收款設定).
• Paste the notification URL from this page into the "Donation payment success notification URL" field.
• Click "Save Settings" to finish; future donation payment results will be reported to this system automatically.
• Get your ECPay donation success animation URL
• Go to the ECPay vendor portal, then click "Payment Tools → Streamer Payment → Donation Success Animation Settings" (收款工具 → 實況主收款 → 贊助成功動畫設定).
• Copy the "donation success animation URL" (starting with https://payment.ecpay.com.tw/Broadcaster/AlertBox/).
• Paste it into the "Donation success animation URL" field on this page and save.
• Get your OPay donation success animation URL
• Go to OPay, then click "I want to collect payments → Streamer Payment → Streamer Payment Settings" (我要收款 → 實況主收款 → 實況主收款設定), and switch to the "Donation Success Animation" tab.
• Copy the "donation success animation URL" (starting with https://payment.opay.tw/Broadcaster/AlertBox/).
• Paste it into the "Donation success animation URL" field on this page and save.
• Unifi Pay integration guide
• Sign in to the Unifi Pay Console, open "Merchant Info" in the left menu, then the "Store Info" tab. Find the store you want to receive donations with (status must be Active) and copy its Store ID.
• Switch to the "Integration Info" tab and click "Reissue" in the "API Key / Secret" section to issue live credentials, then copy both the API KEY and the SECRET KEY right away. ⚠️ The secret is shown only once at issue time and cannot be viewed again. If you lose it you must reissue, which invalidates the previous key.
• On the same page, scroll down to "Callback Domain", paste the callback URL shown on the integration card of this page, and click Save. ⚠️ Do not skip this: Unifi only accepts callback URLs under a domain registered here. Without it, Unifi rejects the order the moment we create it and viewers cannot donate.
• Come back to this page and fill in the Store ID, API Key and API Secret, then save. All three must be provided together. For security the keys are never returned once stored — they can be overwritten but not read back.
• Enter your Store ID, API Key and API Secret to finish the official integration. Unifi Pay settles in crypto and charges in USD.
• Store ID
• Invalid Store ID (1–128 alphanumeric characters, _ and - allowed)
• API Key
• API Secret
• Invalid format — expected a 36-character UUID
• 🔒 API Key / API Secret are stored encrypted and never returned. Leave blank to keep the current value; they can be overwritten but not read back.
• The callback URL is not configured on our side (UNIFI_CALLBACK_URL). Orders cannot be created with this provider for now — please contact the site administrator.
• Official site
• Vendor portal
• Vendor console
• Unifi Pay Console
• Add a record
• Records
• Donor name
• Amount
• Currency
• Message (optional)
• Tip page
• Anonymous
• Link account
• Unlink account
• Link donation to a Twitch account
• Twitch username
• Attributed by the donor's login and cannot be changed
• Details
• Record details
• Time
• Donor
• Amount
• Provider
• Received via
• Order No.
• Message
• (No message)
• Linked account
• Not linked
• Gateway callback
• Tip page
• AlertBox URL scrape
• Manual entry
• Orders
• Orders are kept for 90 days only
• All
• Start date
• End date
• Export orders as CSV
• Start export
• Exporting — please don't leave this page.
• Cancel export
• Export what was fetched
• Export cancelled
• Pending
• Paid
• Failed
• Expired
• Refunded
• Payment code/account:
• Payment due:
• The tip page is currently disabled — viewers can't see the public page. Go to the "Basic" tab, turn on the switch, and save.
• Public page link
• Copy link
• Copied
• Payment providers
• Drag to reorder
• Keep at least one provider on, or nobody can pay on your public page.
• Text tips
• Preset amounts (TWD)
• Minimum amount (TWD)
• Minimum amount (USD)
• Messages & thank-you page
• Video tips
• Price per second (TWD)
• Price per second (USD)
• The song request module is disabled, so tip videos will not appear on the public page.
• Open song request settings
• Service fee overdue — public tip page disabled
• Service fee bill due soon
• Go to service fee
• Invalid preset amounts: enter positive numbers (integers for TWD), comma-separated, up to 6.
• Want viewers to gift you a ChiwaBots paid plan? That’s an account setting —
• enable it under Viewer gifts
• Custom Payout Caps
• Unlimited
• Unpaid orders do not count toward the cap and are still recorded once paid; when several unpaid orders are settled around the same time (convenience-store and ATM payments allow several days to pay), actual receipts can exceed the cap by up to "number of unpaid orders × per-donation cap", bounded only by the system hard cap if no per-donation cap is set.
• This feature only helps manage receipts made through this platform and is not a compliance guarantee; your tax registration obligations are based on the total of all your income sources.
• Tip page service fee terms
• The platform charges a service fee on tip page income, settled monthly: (monthly gross income − payment processing fees − a monthly exemption) × the service fee rate. Amounts below the billing threshold roll over to the next month. The current rate, exemption and billing threshold are as shown on the Service fee page in the dashboard.
• Deducting payment processing fees is a platform benefit and is not guaranteed permanently.
• Overdue fees will suspend the tip page; it is restored automatically once paid.
• The platform may from time to time offer promotions that waive or reduce the service fee (such as an introductory free period at launch). Promotion periods and contents are as shown in the dashboard, and the platform reserves the right to adjust, suspend or terminate any promotion at any time.
• Changes to billing parameters such as the fee rate, exemption or billing threshold will be announced in advance with a stated effective date. Continued use of the feature after the effective date constitutes acceptance of the updated terms, and the new parameters apply automatically from that date. If you do not agree, please disable the tip page before the effective date.
• Agree and continue
• View service fee terms
• Goals have moved to the Progress Goal module.
• Open Progress Goal
• ChiwaBots service fee billing
• Tip page locked — service fee overdue
• Fee holiday — no service fee this period
• Tip page revenue
• Provider fees
• Monthly exemption
• Carried balance
• Provider fees are excluded from the fee base where possible, based on amounts actually reported by the payment provider. This exclusion is a platform courtesy and is not guaranteed.
• No bills yet
• Carrying
• Payment due
• Paid
• Overdue
• Waived
• Details
• Chargeable base
• Fee rate
• Bill amount
• Carried over
• Amount due
• Amount paid
• Carried to next period
• Amount due in USD
• This period falls within a free promotional period, so the fee is fully waived (accrued counts as 0).
• Free promotional period — no fee this period
• This bill was waived by support and the balance was set to 0.
• Bill info
• Issued
• Paid on
• Payment order no.
• USD conversion rate
• Pay
• Pay service fee
• Payment method
• Proceed to payment
• PayPal (USD)
• Failed to create the payment order. Please try again later.