Stripe analytics: revenue by channel

Setup steps

1. In Stripe, open Developers → API keys and create a restricted key with Read on Customers, Subscriptions, Charges, Refunds and Balance transactions.
2. In ProductLense, open Settings → Billing connections → Stripe and paste the key. ProductLense makes one read call to check it.
3. In Stripe → Developers → Webhooks, add a webhook endpoint with the URL ProductLense shows after you save the connection (pattern https://api.productlense.app/api/webhooks/{provider}/{connection_id}).
4. Select the events listed below, save, and paste the signing secret into ProductLense.
5. ProductLense backfills the last 12 months, then keeps up through webhooks and a nightly reconcile.

Credentials and permissions

Webhook

URL pattern, shown with your connection id after you save:

https://api.productlense.app/api/webhooks/stripe/{connection_id}

Events: charge.succeeded, charge.refunded, charge.dispute.created, customer.created, customer.updated, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.paid

Verification: Stripe-Signature header: timestamp plus HMAC-SHA256, rejected after 5 minutes.

What ProductLense reads

Customers

Customers, including email and metadata such as pl_user_id.

Subscriptions

Subscriptions with plan, interval and status.

Payments

Charges and paid invoices.

Refunds

Refunds, plus disputes recorded as chargebacks.

Fees

The fee on each balance transaction, and the dispute fee on chargebacks.

What ProductLense never touches

• Never creates, changes, refunds or cancels anything: read-only API calls and incoming webhooks only.
• Never moves money, issues payouts, or reads bank account details.
• Never sees full card numbers; providers do not expose them.
• Never sends your customer data to the AI model: Ask and the daily insight see aggregates only.

Match payments to your users

Set metadata.pl_user_id on Stripe customers to the same id you pass to identify for the strongest match. Without it, ProductLense matches by customer email.

const customer = await stripe.customers.create({
  email: user.email,
  metadata: { pl_user_id: user.id },
});