For the complete documentation index, see llms.txt. This page is also available as Markdown.

Stripe Revenue Attribution

Connect Stripe once, then choose how Humblytics links each payment to the visit that led to it.

Setup has two parts: connect your Stripe account, then tell Humblytics which visit each payment came from.

Step 1: Connect Stripe

  1. In Humblytics, go to Connect → Connectors.

  2. Under Revenue, click Connect next to Stripe.

  3. Paste a Stripe API key (see the next section).

  4. Click Test Connection, then Save Changes.

Connecting Stripe in Humblytics Connectors

A restricted key gives Humblytics read-only access to exactly what it needs, and nothing more.

  1. In Stripe, go to Developers → API keys and click Create restricted key.

  2. Name it something like Humblytics.

  3. Set Read access for Payment Intents, Invoices, Subscriptions, Customers, Charges, and Account.

  4. Click Create key and copy it into Humblytics.

Restricted keys start with rk_. A full secret key (sk_) also works, but it gives more access than Humblytics needs. Humblytics reads your charges to attribute revenue and never stores card data.

Pick the method that matches how you take payments:

You take payments with…
Use
Code needed?

Stripe Payment Links

No. Change one redirect URL.

Your own checkout that calls the Stripe API (Checkout Sessions, Payment Intents, Subscriptions)

Yes. Pass one ID to Stripe.

Stripe Elements, a third-party tool built on Stripe, or anything else

Yes. One line with the buyer's email.

Not sure which one you use? If your buy button links to buy.stripe.com, you use Payment Links.

Step 3: Check that it works

Make a test purchase in a private window, then check Observe → Attribution → Recent Attributed Transactions.

Revenue shows but isn't attributed? The connection works, but the payment wasn't linked to a visit. Recheck Step 2 for your method.

Last updated