Stripe
What Paperbeam reads from Stripe, the read-only access it asks for and why, filters, and the beats it feeds.
Billing & finance
Read-only API key
New subscriptions, upgrades, downgrades and cancellations, annualized.
What we read
- Subscription events (created, updated, deleted) in the window, annualized into new business, upgrades, downgrades and cancellations.
- The customer name for each subscription.
Only the reporting window of each edition is read. Paperbeam stores derived facts and short excerpts, not copies of your Stripe data, and keeps raw evidence only for your retention period.
Access we ask for, and why
| Scope | Why |
|---|---|
rak_event_read | Read subscription events |
rak_subscription_read | Annualize subscription amounts |
rak_customer_read | Name the customer |
All access is read-only. You can revoke it from Stripe at any time, or disconnect the source in Paperbeam.
Connect Stripe
- Go to Sources and choose Stripe.
- Create a restricted key. Stripe Dashboard → Developers → API keys → Create restricted key. Open Stripe settings.
- Fill in Restricted API key, then click Test connection. Paperbeam makes one read-only call and shows the account it reached, or exactly what went wrong.
- Click Connect. The credential is encrypted before it is stored and never shown again. Use Sync now on the source’s page to see what it collects from the last 24 hours, and set filters there.
You need the admin or owner role in Paperbeam, and enough permission in Stripe to grant read access to the data listed above.
Filters
Set on the source’s page at Sources›Stripe. Filtered-out data is never collected.
| Filter | Effect |
|---|---|
| Products | Only subscriptions that include these products (names or prod_ ids). Leave empty for all. |
To keep specific people, channels or topics out of the paper across all sources, use exclusion rules and the never-mention list in House style.
Beats
Stripe is a source for:
Stories land in whichever of your sections fits them best.
Good to know
- Create a restricted key in Stripe (Developers → API keys → Create restricted key) with read access to Events, Subscriptions and Customers, and paste it when connecting.
- Stripe keeps events for 30 days, so backfill of Stripe-only revenue history is limited to the last month.