Stripe Agent Skill
Stripe Checkout, webhooks, subscriptions, and idempotency patterns.
The Skill
Full content, every format. Copy it, download it, or install with one command.
---
description: Stripe Checkout, webhooks, subscriptions, and idempotency patterns.
homepage: https://yepapi.com/skills/stripe
metadata:
tags: [stripe, payments, webhooks, subscriptions]
---
# Stripe
## Rules
- Webhook-first architecture — never trust client-side payment confirmation
- Verify webhook signatures: `stripe.webhooks.constructEvent(body, sig, secret)`
- Idempotency keys on all create/update operations: `{ idempotencyKey: uuid }`
- Checkout Sessions for payments — not direct charges
- Customer Portal for subscription management — don't build custom billing UI
- Test mode for development — use `sk_test_` keys, `4242424242424242` test card
- Price IDs from dashboard — don't hardcode amounts in code
- Metadata on objects for internal reference: `{ metadata: { userId, planId } }`
## Avoid
- Trusting client-side success redirects without webhook confirmation
- Hardcoding prices in code — use Stripe Price objects
- Creating customers without linking to your user model
- Missing webhook signature verification — this is a security issueInstall
Why Use the Stripe Skill?
Without this skill, your AI guesses at stripe patterns. It might hallucinate deprecated APIs, use outdated conventions, or miss best practices entirely. With it, your AI follows a proven ruleset — every suggestion aligns with current standards.
Drop this skill into your project and your AI instantly knows the rules. Better code suggestions, fewer errors, faster shipping.
Try These Prompts
These prompts work better with the Stripe skill installed. Your AI knows the context and writes code that fits.
"Integrate Stripe Checkout with webhooks, subscription handling, and idempotency"
"Create a payment flow with Stripe Elements, 3D Secure, and receipt emails"
"Build a Stripe webhook handler that processes payment, subscription, and invoice events"
Works Great With
Stripe skill — FAQ
It provides Stripe Checkout, webhook handling, subscription patterns, and idempotency rules. Your AI integrates Stripe correctly with proper webhook verification and error handling.
Run `npx skills add YepAPI/skills --skill stripe` in your project root. This copies the skill file into your repo where your AI coding tool can read it automatically.
The skill includes idempotency keys, webhook signature verification, and retry-safe event processing. It stores processed event IDs to prevent duplicate handling and uses proper HTTP status codes.