# stripe-payments

stripe-payments gives your coding agent a working map of Stripe: hosted Checkout, custom Payment Intents, subscriptions, webhook signature checks, refunds and test cards. Useful once payment code has to leave the sandbox.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 161 installs · ★ 7 repo stars
- Author: eyadsibai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/eyadsibai/ltk/tree/HEAD/plugins/ltk-product/skills/stripe-payments/SKILL.md
- Updated: 2026-01-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/eyadsibai-stripe-payments

## What it does

The skill covers three ways to take money: a hosted Checkout Session, Payment Intents when you want your own UI on top of Stripe.js, and Setup Intents for storing a card for later. Snippets come in Python and JavaScript, from session creation and in-browser confirmation to a subscription built with `default_incomplete`, full and partial refunds, and the billing portal that lets customers cancel themselves.

Webhooks get their own section: building an event with `stripe.Webhook.construct_event`, the events worth wiring up (`payment_intent.succeeded`, `payment_intent.payment_failed`, `customer.subscription.updated`, `customer.subscription.deleted`, `invoice.payment_succeeded`), and a card table for testing. `4242424242424242` succeeds, `4000000000000002` is declined, `4000002500003155` triggers 3D Secure.

Amounts go in the currency's smallest unit, so `unit_amount: 2000` is $20.00, and hardcoding a raw amount sits on the usual-mistakes list. A handler that skips `Stripe-Signature` verification answers 400 and the event is lost. The skill's advice: build on webhooks rather than on the browser's confirmation.

## Requirements
- Works with: Stripe

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill stripe-payments -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/stripe-payments/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/stripe-payments/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill stripe-payments -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/stripe-payments/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill stripe-payments -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/stripe-payments/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install eyadsibai/ltk plugins/ltk-product/skills/stripe-payments
```

2. **Manually: put the files in place**
- File: `.github/skills/stripe-payments/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill stripe-payments -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/eyadsibai/ltk --path plugins/ltk-product/skills/stripe-payments
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/stripe-payments/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill stripe-payments -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/eyadsibai/ltk/tree/HEAD/plugins/ltk-product/skills/stripe-payments/SKILL.md

## When to use it
- Wire up card payments through a hosted Checkout page
- Build a custom payment form on Payment Intents
- Verify webhook signatures before acting on an event
- Set up a monthly subscription with a self-serve cancel portal
- Issue a partial refund on a customer request

## Example prompts
- Add Stripe Checkout for a $20 monthly plan, my `success_url` and `cancel_url` are ready
- My `/webhook` handler throws inside `construct_event`. Walk me through the signature check
- Refund 500 cents on `pi_xxx` with reason `requested_by_customer`

## Similar
- [web-payments](https://affpapa.org/en/nevibecode/skills/web-payments.md) — skill · 302 installs
- [Stripe Payments](https://affpapa.org/en/nevibecode/skills/stripe-payments.md) — skill · 5100 installs
- [payments](https://affpapa.org/en/nevibecode/skills/payments.md) — skill · 5 installs
- [stripe-integration-expert](https://affpapa.org/en/nevibecode/skills/borghei-stripe-integration-expert.md) — skill · 116 installs
- [stripe-expert](https://affpapa.org/en/nevibecode/agents/stripe-expert.md) — subagent · ★ 1029 repo stars
- [stripe-best-practices](https://affpapa.org/en/nevibecode/skills/stripe-best-practices-2.md) — skill · 102700 installs

## Other versions with the same name
- [stripe-payments · jezweb](https://affpapa.org/en/nevibecode/skills/jezweb-stripe-payments.md) — 1100 installs

From the same set: [eyadsibai/ltk](https://affpapa.org/en/nevibecode/by/eyadsibai/ltk.md) — 11 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
