Stripe Testing

Overview

This skill helps you test and debug Stripe payment integrations end-to-end. It covers webhook verification, payment flow simulation using Stripe CLI and test mode, charge failure diagnosis, and subscription lifecycle validation.

Instructions

Setting Up the Test Environment

1. Verify Stripe CLI is installed: stripe --version
2. Check for a test API key in environment variables (STRIPE_SECRET_KEY starting with sk_test_)
3. If no key is found, instruct the user to set one from the Stripe Dashboard → Developers → API keys
4. Run stripe listen --forward-to localhost:<port>/webhooks/stripe to forward webhooks locally

Debugging Failed Charges

1. Ask for the payment intent ID or charge ID (starts with pi_ or ch_)
2. Retrieve details: stripe payment_intents retrieve <id> --api-key $STRIPE_SECRET_KEY