Guide · Agent skill
How to use the Stripe Integration agent skill: setup and examples
Updated · written with AI from the project's own documentation and checked against our catalogue data
The stripe-integration skill is a set of written instructions that teaches an AI coding agent how to add Stripe payments to an app. Once it is installed, you can ask your agent for help with checkout, subscriptions or webhooks, and it will follow the skill's guidance when writing code. This guide covers what the skill does, how to install it, how to ask for it, and what to check before you trust the output.
Stripe Payment Integrationwshobson/agents · MIT Download the skill Quick start
- 1Download the ZIP. Download the stripe-integration skill ZIP from this page.
- 2Install the skill. Unzip it into ~/.claude/skills/ for personal use, into a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 3Prepare Python and Stripe. Install Python and the stripe Python library, then create a Stripe account and copy your test-mode key that starts with sk_test_.
- 4Ask for the task in plain language. Describe the payment flow you want, such as a monthly subscription or a webhook handler, and let the agent apply the skill.
- 5Review and test. Read the generated code, run the tests with test card numbers, and confirm the webhook handling matches your app before going live.
What does the stripe-integration skill make the agent do?
The skill is guidance, not a payment system. It helps the agent choose between Stripe Checkout Sessions and Payment Intents, set up subscriptions using products and prices, handle webhook events such as successful payments and cancellations, and write Python test code using Stripe's test card numbers.
The agent writes code for your project. The skill itself does not process any payments.
- Choosing between Checkout Sessions (recommended for most integrations) and Payment Intents (bespoke control)
- Setting up subscriptions with Product, Price, Subscription and Invoice concepts
- Handling webhook events such as payment_intent.succeeded and customer.subscription.deleted
- Writing Python tests that use Stripe test mode and test card numbers
How do you install the stripe-integration skill?
Download the ZIP file for the skill from this page. Then choose one of the two install routes below.
For a personal setup available to all your projects, unzip the download into ~/.claude/skills/. To limit the skill to one project, unzip it into that project's .claude/skills/ folder.
If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.
- Personal: unzip into ~/.claude/skills/
- Project only: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload
What do you need before you use it?
The examples in the skill use Python and the stripe Python library, so you need both installed. You also need a Stripe account with test-mode API keys, which start with sk_test_. Use test keys while you learn and build; the skill's examples are written for test mode.
- Python and the stripe Python library
- A Stripe account with test-mode API keys (sk_test_...)
How do you trigger the skill with a natural request?
You do not need a special command. Describe the payment task in plain language and mention what you are building. The skill's description covers integrating Stripe payments, building subscription systems and implementing secure checkout flows, so requests like these tend to match it.
Be specific about the flow you want. Naming subscriptions, webhooks or checkout makes it more likely the agent uses the right part of the guidance.
- "Add a monthly subscription with Stripe Checkout to my Flask app."
- "Set up Stripe webhooks to mark an order paid when payment succeeds."
- "Write Python tests for a one-time Stripe payment using test cards."
- "Help me choose between Checkout Sessions and Payment Intents for my store."
What does the basic Stripe example look like?
The skill's quick start shows an agent creating a Checkout Session in subscription mode with a monthly price, then redirecting the user to the session URL. The key values are the currency, the amount in cents, the interval and the success and cancel URLs. Treat this as a starting shape for the agent to adapt, not finished code.
The testing section shows a test that creates a customer, creates a PaymentIntent, confirms it with the test payment method pm_card_visa and checks that the status is succeeded.
import stripe
stripe.api_key = "sk_test_..."
session = stripe.checkout.Session.create(
line_items=[{
'price_data': {
'currency': 'usd',
'product_data': {'name': 'Premium Subscription'},
'unit_amount': 2000,
'recurring': {'interval': 'month'},
},
'quantity': 1,
}],
mode='subscription',
success_url='https://yourdomain.com/success?session_id={CHECKOUT_SESSION_ID}',
cancel_url='https://yourdomain.com/cancel'
)
print(session.url)What about the test cards and detailed patterns?
The skill lists test card numbers for a successful payment, a declined payment, a 3D Secure flow and insufficient funds. Use these only in test mode.
Longer worked examples live in a reference file, references/details.md, which includes a one-time payment with hosted checkout. The agent reads that file when the main guidance is not enough.
- success: 4242424242424242
- declined: 4000000000000002
- 3d_secure: 4000002500003155
- insufficient_funds: 4000000000009995
What safety points should you know?
The skill does not run scripts, but it does use the network, because the code it helps write calls Stripe. Payment bugs can cost money or expose card data, so review every change before it goes live. The skill's guidance is static text and may drift from current Stripe API details, so check the code against Stripe's current documentation.
Keep secret keys out of source code and never use live keys while you are still testing.
- The skill runs no scripts; its examples make network calls to Stripe when you run them
- Review all generated payment code before deploying
- Verify API details against current Stripe documentation
- Use sk_test_ keys until you are ready to go live
What people use it for
- Adding a monthly subscription with Stripe Checkout to a web app
- Setting up webhook handlers that mark orders paid or cancel access when subscriptions end
- Writing Python tests that simulate successful, declined and 3D Secure payments in test mode
- Comparing Checkout Sessions with Payment Intents before choosing an approach for a project
Frequently asked questions
Is the stripe-integration skill free?
The skill is published under the MIT licence, as listed on this page. Stripe itself is a separate service with its own account and fees, which the skill does not cover.
What do I need to use the stripe-integration skill?
You need Python and the stripe Python library, because the examples use them. You also need a Stripe account with test-mode API keys that start with sk_test_.
How do I install the stripe-integration skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder. In the Claude apps, you can upload it under Settings → Capabilities → Skills.
Does the skill process payments for my app?
No. The skill only guides the agent in writing code. You still need to review, test and maintain the payment code yourself.
Does the skill run scripts on my computer?
No, the skill does not run scripts. It does use the network, since the code it helps write calls Stripe's API.
Should I use this skill or read Stripe's documentation directly?
The skill gives a checklist of concepts and example patterns that an agent can apply quickly. Because its guidance is static text, use Stripe's official documentation to confirm current API details before shipping.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Developers adding subscriptions or one-time payments to a web or mobile app, or teams setting up webhooks and test-mode flows, will get a useful checklist and starter code from this skill. Non-developers who expect a finished payment system, and teams that need current Stripe API details or in-depth Stripe Connect marketplace setup, should look elsewhere or consult Stripe's documentation directly.
Download the skill