์Šคํ‚ฌ stripe-agent
๐Ÿ“ฆ

stripe-agent

๋‚ฎ์€ ์œ„ํ—˜ ๐ŸŒ ๋„คํŠธ์›Œํฌ ์ ‘๊ทผ๐Ÿ”‘ ํ™˜๊ฒฝ ๋ณ€์ˆ˜

Automate Stripe Billing and Subscription Management

Managing Stripe billing manually is time-consuming and error-prone. This skill automates product setup, subscription lifecycle management, checkout sessions, and webhook processing with support for dual test and live environments.

์ง€์›: Claude Codex Code(CC)
โš ๏ธ 66 ๋‚˜์จ
1

์Šคํ‚ฌ ZIP ๋‹ค์šด๋กœ๋“œ

2

Claude์—์„œ ์—…๋กœ๋“œ

์„ค์ • โ†’ ๊ธฐ๋Šฅ โ†’ ์Šคํ‚ฌ โ†’ ์Šคํ‚ฌ ์—…๋กœ๋“œ๋กœ ์ด๋™

3

ํ† ๊ธ€์„ ์ผœ๊ณ  ์‚ฌ์šฉ ์‹œ์ž‘

ํ…Œ์ŠคํŠธํ•ด ๋ณด๊ธฐ

"stripe-agent" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Audit the Stripe configuration and check if all required environment variables are present

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Stripe Configuration Audit Results:
  • Status: Healthy
  • Environment Variables: All 12 required variables present
  • Products: 3 products found (Starter, Professional, Elite)
  • Prices: 6 prices configured (monthly and annual for each tier)
  • Webhooks: Test webhook configured, Live webhook pending setup
  • Recommendation: Add STRIPE_LIVE_WEBHOOK_SECRET to production environment

"stripe-agent" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Create a checkout session for john@example.com subscribing to Professional tier monthly

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Checkout session created successfully
  • Customer: cus_ABC123 (john@example.com)
  • Price: Professional Monthly - $895.00 AUD
  • Checkout URL: https://checkout.stripe.com/c/pay/cs_test_xyz789
  • Session expires in 24 hours
  • Workspace will be upgraded upon successful payment

"stripe-agent" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. List all active subscriptions for customer cus_ABC123

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Active Subscriptions for cus_ABC123:
  • Subscription ID: sub_123456
  • Tier: Professional
  • Billing: Monthly ($895.00 AUD)
  • Status: Active
  • Current period: 2026-01-15 to 2026-02-15
  • Next invoice: 2026-02-15

๋ณด์•ˆ ๊ฐ์‚ฌ

๋‚ฎ์€ ์œ„ํ—˜
v6 โ€ข 1/21/2026

This skill provides legitimate Stripe payment integration functionality. Static analyzer flagged 102 potential issues, but manual review confirms these are false positives from documentation patterns and markdown code blocks. The skill properly uses environment variables for API credentials and follows Stripe integration best practices. Network access is legitimate for Stripe API communication.

2
์Šค์บ”๋œ ํŒŒ์ผ
1,550
๋ถ„์„๋œ ์ค„ ์ˆ˜
4
๋ฐœ๊ฒฌ ์‚ฌํ•ญ
6
์ด ๊ฐ์‚ฌ ์ˆ˜
๋‚ฎ์€ ์œ„ํ—˜ ๋ฌธ์ œ (2)
Environment Variable Access for API Credentials
The skill documentation references Stripe API keys stored in environment variables (STRIPE_TEST_SECRET_KEY, STRIPE_LIVE_SECRET_KEY). This is the proper security practice for managing API credentials. Users should ensure these variables are properly secured in their deployment environment.
Network Communication with Stripe API
The skill makes network requests to Stripe API endpoints using the @stripe/mcp server. This is expected behavior for a Stripe billing integration. All communication is with legitimate Stripe services.

์œ„ํ—˜ ์š”์ธ

๐ŸŒ ๋„คํŠธ์›Œํฌ ์ ‘๊ทผ (2)
๐Ÿ”‘ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ (1)

ํ’ˆ์งˆ ์ ์ˆ˜

38
์•„ํ‚คํ…์ฒ˜
100
์œ ์ง€๋ณด์ˆ˜์„ฑ
87
์ฝ˜ํ…์ธ 
21
์ปค๋ฎค๋‹ˆํ‹ฐ
86
๋ณด์•ˆ
83
์‚ฌ์–‘ ์ค€์ˆ˜

๋งŒ๋“ค ์ˆ˜ ์žˆ๋Š” ๊ฒƒ

SaaS Subscription Setup

Set up complete subscription billing for a SaaS product with multiple pricing tiers, automated checkout, and webhook-driven subscription activation.

Billing System Audit

Audit existing Stripe configuration to verify all products, prices, and webhooks are properly configured across test and live environments.

Subscription Lifecycle Management

Handle customer subscription upgrades, downgrades, and cancellations with proper proration and database synchronization.

์ด ํ”„๋กฌํ”„ํŠธ๋ฅผ ์‚ฌ์šฉํ•ด ๋ณด์„ธ์š”

Setup Stripe Products
Create three Stripe products: Starter at $495/month, Professional at $895/month, and Elite at $1,295/month. Include both monthly and annual pricing with annual discount.
Create Checkout Session
Create a Stripe checkout session for user email@example.com subscribing to the Professional tier with monthly billing. Use workspace ID ws_123 and redirect to /dashboard on success.
Process Subscription Upgrade
Upgrade subscription sub_abc123 from Starter to Professional tier with proration. Update the workspace tier in the database after successful upgrade.
Generate Billing Report
Generate a billing report for the current month showing total revenue, revenue by tier, active subscriptions, new subscriptions, churned subscriptions, and MRR.

๋ชจ๋ฒ” ์‚ฌ๋ก€

  • Always use separate test and live API keys and configure them properly in environment variables to avoid mixing test and production data
  • Implement webhook signature verification using webhook secrets to ensure incoming webhook events are genuine Stripe requests
  • Store subscription and customer data in your database synchronized with Stripe to enable fast queries without repeated API calls

ํ”ผํ•˜๊ธฐ

  • Avoid hardcoding API keys or price IDs directly in code instead of using environment variables and configuration management
  • Do not process subscription changes without webhook confirmation as payments may fail or require additional authentication steps
  • Never skip webhook signature verification as this exposes your billing system to forged webhook attacks and data manipulation

์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ

What Stripe API credentials do I need to configure?
You need to set up test and live secret keys, webhook secrets, publishable keys, and price IDs for each tier in your environment variables. The skill documentation lists all 12 required variables.
How does the dual-mode billing system work?
The skill automatically routes staff users with specific roles or internal email domains to test mode, while real customers use live mode. This prevents test charges from mixing with production billing.
Can this skill handle subscription upgrades and downgrades?
Yes, the skill can process subscription changes with proration calculations and update your database to reflect the new tier. Users are charged or credited based on time remaining in the billing period.
What webhook events does this skill handle?
The skill processes checkout completion, subscription creation, updates and deletion, invoice paid and payment failed events. Each event triggers appropriate actions like activating subscriptions or sending notifications.
Do I need the @stripe/mcp server installed?
Yes, this skill depends on the official Stripe MCP server to communicate with the Stripe API. You need to install and configure it before using this skill.
How can I test the billing flow without real payments?
Use Stripe test mode with test card numbers provided in the documentation. The skill supports separate test webhooks and products for safe testing without affecting production data.

๊ฐœ๋ฐœ์ž ์„ธ๋ถ€ ์ •๋ณด

์ž‘์„ฑ์ž

CleanExpo

๋ผ์ด์„ ์Šค

MIT

์ฐธ์กฐ

main

ํŒŒ์ผ ๊ตฌ์กฐ

๐Ÿ“„ SKILL.md