# payments-stinger

payments-stinger — a skill for building a custom checkout with Stripe Elements instead of redirecting to Stripe's hosted page. Handles trial, payment, and access state, enforces entitlements on the server, and prepares support actions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/skills/payments-stinger/SKILL.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/payments-stinger

## What it does

payments-stinger provides checkout built with Stripe Elements (Payment Element, Address Element, Contact Details Element, Express Checkout Element) and theming via Appearance API. It replaces hosted Checkout for full UI control and requires SvelteKit on Vercel with Stripe SDK version 2025-09-30 or later.

The skill separates trial, payment, and access state; enforces entitlements via server-side Stripe events, never client claims. Webhooks deduplicate on `event.id`; outbound operations carry `Idempotency-Key`. Secret keys `sk_*` and `whsec_*` stay in private server code only.

Each task has a guide: choosing custom vs. hosted, mounting Elements, payment intents, saving cards, subscriptions, webhook handling, theming, testing, security, production failures, and preparing approved support actions like refunds, disputes, and cancellations. Core principle: never trust the client for amounts, prices, or access grants.

## Requirements
- Works with: Stripe

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install platform-and-release-tools@wasp-nest
```
This installs the whole platform-and-release-tools plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill payments-stinger -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill payments-stinger -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill payments-stinger -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install legioncodeinc/vibe-coding-tools plugins/platform-and-release-tools/skills/payments-stinger
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill payments-stinger -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/legioncodeinc/vibe-coding-tools --path plugins/platform-and-release-tools/skills/payments-stinger
```

### Windsurf (Devin Desktop)

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

### 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/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/skills/payments-stinger/SKILL.md

## When to use it
- build a custom checkout with Stripe Elements instead of a Checkout redirect
- separate trial, active payment, and feature access state in the database
- verify user entitlements on the server after a Stripe webhook
- prepare a list of approved support actions (refunds, reissues, cancellations)
- set up payment method storage for off-session charges

## Example prompts
- Help me build a checkout with Stripe Elements that fits our product interface
- How do we separate trial, active subscription, and lapsed access in our state model
- Set up webhook handling so access is only granted after server-side verification

## Similar
- [web-payments](https://affpapa.org/en/nevibecode/skills/web-payments.md) — skill · 302 installs
- [payments](https://affpapa.org/en/nevibecode/skills/payments.md) — skill · 5 installs
- [stripe-payments](https://affpapa.org/en/nevibecode/skills/eyadsibai-stripe-payments.md) — skill · 161 installs
- [Stripe Payments](https://affpapa.org/en/nevibecode/skills/stripe-payments.md) — skill · 5100 installs
- [e-commerce](https://affpapa.org/en/nevibecode/skills/e-commerce.md) — skill · 377 installs
- [payment-processing](https://affpapa.org/en/nevibecode/plugins/payment-processing.md) — plugin · ★ 42780 repo stars

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 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
