Readiness Checklist

Track your integration progress. Check off each item as you complete it. Your progress is saved in your browser.

Your progress is saved locally in your browser

0/14

0% complete

0/3

Stripe account connected to Sumo

Complete the Stripe Connect OAuth flow via Partner Portal

Webhook endpoint configured in Stripe

Add your webhook URL in Stripe Dashboard > Developers > Webhooks

Environment variables configured

STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET are set

0/8

Webhook signature verification

Verify stripe-signature header before processing events

Handle checkout.session.completed

Process the main webhook event for successful purchases

Detect Sumo purchases via campaign_id

Check for campaign_id in session.metadata

User creation/lookup logic

Find or create user accounts by email address

Subscription linking

Associate Stripe subscription with user record

Access provisioning

Grant features based on product_tier_id and quantity

Idempotency handling

Safely handle duplicate webhook deliveries

Error handling and logging

Log events and return appropriate HTTP status codes

0/3

Local testing with Stripe CLI

Use stripe listen --forward-to for local development

Test purchase completed

Complete an end-to-end test purchase flow

Welcome email sent

Verify new users receive onboarding email

Need Help?

Code Examples

Reference implementations

Best Practices

Edge cases & testing

AI Assistant Prompt

For Claude Code, Cursor