Skip to main content

Connect Ko-fi

This guide is for streamers who collect through Ko-fi (great for international audiences — no PromptPay). Connecting has two parts: generate a Webhook URL in the app and paste it into Ko-fi, then copy the Verification Token from Ko-fi back into the app — you need both before donations come through.

What you'll need​

  • A working Ko-fi account (ko-fi.com)
  • Donari open, with access to the Settings page
  • A browser to log into Ko-fi → More → API

Step 1 — Generate the Webhook URL in the app​

  1. In the app, go to Settings (sidebar) → Connections tab
  2. Find the ☕ Ko-fi section
  3. Click Generate Webhook URL
  4. The app shows the URL — click Copy

:::warning The URL is shown only once The full Webhook URL appears just once — copy it before leaving this page. If you lose it, click Regenerate (the old one is revoked immediately — you'll need to paste the new one into Ko-fi). :::

Step 2 — Paste the URL into Ko-fi​

  1. Log into ko-fi.com → go to More → API
  2. Paste the copied Webhook URL into the Webhook URL field → Save

Step 3 — Copy the Verification Token back into the app​

  1. Still on Ko-fi → More → API, click "Advanced"
  2. Copy the Verification Token (a UUID like 00000000-1111-2222-3333-444444444444)
  3. Back in the app, paste it into the Verification Token field → Save

:::danger The Verification Token is required Without the Verification Token, donations are rejected immediately and Ko-fi does not retry — that donation is lost. Finish this step before going live. :::

Step 4 — Test and check the status​

  1. On Ko-fi → More → API, click Send Test to fire a test event
  2. Back in the app, watch the status dot next to Ko-fi and the "Last received: â€Ļ" line
  • đŸŸĸ Green = Connected — both Webhook URL and Verification Token are set and events are coming through
  • 🔴 Red = not complete — confirm the URL is pasted in Ko-fi and the Verification Token is pasted in the app

Tips & Troubleshooting​

  • Send Test says unverified / rejected: the Verification Token doesn't match — copy it again from Ko-fi → API → Advanced and paste it over the old one in Donari.
  • Some donation types don't fire: Ko-fi has several event types — the app only fires on Tip / Donation / Subscription; Commission / Shop Order are skipped.
  • THB amount looks off: Ko-fi supports multiple currencies; the app converts to THB at the current rate.
  • Change the URL / suspect it leaked: click Regenerate in the app, then paste the new URL over the old one in Ko-fi (the old one stops working instantly).

See also​