Connect Stripe
You need the owner or admin role and a verified MFA session.1
Create the webhook endpoint
In Settings, Integrations, Stripe, click Create webhook endpoint.
2
Register it in Stripe
In the Stripe Dashboard, add a webhook endpoint with the URL from Manalens. Select the supported events.
3
Save the signing secret
Paste the Stripe webhook signing secret into Webhook signing secret and click Save signing secret. Revenue ingestion starts.
4
Import history (optional)
Enter a restricted Read API key with read access to invoices, refunds, subscriptions and Checkout Sessions, then import. Without Checkout Sessions access, one-time Checkout payments are skipped. Imports resume automatically and are reconciled daily.
Supported events
invoice.paid, checkout.session.completed, checkout.session.async_payment_succeeded, charge.refunded and customer.subscription.*.
Each webhook is verified against its signature. Other event types are ignored.
One-time Checkout payments
A one-time Checkout Session (modepayment, also from a Payment Link) is recorded from checkout.session.completed when paid, or from checkout.session.async_payment_succeeded for a delayed method such as a bank debit. The record ID is the payment intent (pi_…), so refunds link to it.
A sale counts once. Sessions with an invoice or a subscription are counted by their invoices instead.
Link payments to players
Use one of these:- A
user_idin the Stripemetadata. For a Checkout Session, the sessionmetadata.user_id, else itsclient_reference_id. - An identify trait
stripe_customer_id: