Agent skill

Stripe Payments

by hewi333 in hewi333/Mom-n-Pop-Skills

Create Stripe checkout sessions, payment links, invoices, and customers via Stripe REST API.

MITAuto-check: notesBackend & APIs

Install Stripe Payments

skills CLI
$ npx skills add hewi333/Mom-n-Pop-Skills --skill stripe-payments -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hewi333/Mom-n-Pop-Skills stripe-payments --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hewi333/Mom-n-Pop-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/stripe-payments .claude/skills/stripe-payments && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
stripe-payments
GitHub stars
122
Token cost
~2.1k tokens
SKILL.md length
506 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Create Stripe checkout sessions, payment links, invoices, and customers via Stripe REST API.

  • Works in 3 steps: Get API Key → Store Key in Hermes Environment → Stripe CLI (optional, for local webhooks)
  • Processing payments
  • SKILL.md covers When to Use, Prerequisites, Setup and API Reference, plus 6 more sections
  • Calls curl, python3 and stripe; reaches api.stripe.com and buy.stripe.com; needs STRIPE_SECRET_KEY

What it does

Stripe Payments is an agent skill from hewi333/Mom-n-Pop-Skills. Create Stripe checkout sessions, payment links, invoices, and customers via Stripe REST API. Use when processing payments, sending invoices, or managing customer billing for a service business.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Forms and invoices and REST APIs. It works with Stripe. The repository describes itself as: Collection of skills for small businesses using AI Agents. The licence is MIT.

When your agent uses it

  • Processing payments
  • Sending invoices
  • Managing customer billing for a service business

Example prompts

  • “/stripe-payments”

Requirements

  • Python 3
  • A credential in STRIPE_SECRET_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Get API Key
  2. Store Key in Hermes Environment
  3. Stripe CLI (optional, for local webhooks)

What it can do on your machine

Read from SKILL.md and the folder at commit 70a2273. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3
    • stripe

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.stripe.com
    • buy.stripe.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • STRIPE_SECRET_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Stripe Payments loads about 2.1k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 506 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:37
    Add to `~/.hermes/.env`:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hewi333/Mom-n-Pop-Skills at commit 70a2273, republished under its MIT licence (© hewi333). 506 words, ~2,102 tokens.

Download SKILL.mdSave it as .claude/skills/stripe-payments/SKILL.md (or your agent's skills folder).
name
stripe-payments
description
Create Stripe checkout sessions, payment links, invoices, and customers via Stripe REST API. Use when processing payments, sending invoices, or managing customer billing for a service business.
version
1.0.0
author
Hermes Agent
license
MIT

Stripe Payments Skill

When to Use

  • Customer needs to pay for an estimate/job
  • Creating an invoice for a service
  • Setting up a customer in Stripe for recurring billing
  • Generating a payment link to send to a client
  • Checking payment status for a job
  • Agent needs to pay for its own SaaS subscriptions (hackathon "earn and spend" angle)

Prerequisites

  • Stripe API key (secret key, starts with sk_)
  • Stripe account in test mode for demos
  • Stripe CLI installed for webhook testing (optional)
  • Environment variable: STRIPE_SECRET_KEY

Setup

1. Get API Key
  1. Log in to Stripe Dashboard (dashboard.stripe.com)
  2. Toggle "Test mode" on (top right)
  3. Developers > API Keys > Copy "Secret key" (sk_test_...)
2. Store Key in Hermes Environment

Add to ~/.hermes/.env:

STRIPE_SECRET_KEY=sk_tes...xxxx
3. Stripe CLI (optional, for local webhooks)
bash
# Install
curl -sL https://github.com/stripe/stripe-cli/releases/latest/download/stripe_linux_x86_64.tar.gz | tar xz -C /usr/local/bin/
stripe login
stripe listen --forward-to localhost:8642/v1/stripe/webhook

API Reference

All Stripe API calls use https://api.stripe.com/v1/ with Bearer auth.

Create Customer
bash
curl -s https://api.stripe.com/v1/customers \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d name="John Smith" \
  -d email="john@example.com" \
  -d phone="555-555-1234" \
  -d "metadata[business]=[BUSINESS_NAME]" \
  -d "metadata[source]=Referral" \
  -d "metadata[address]=123 Main St, [CITY], [STATE]"
bash
curl -s https://api.stripe.com/v1/payment_links \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][unit_amount]=250000" \
  -d "line_items[0][price_data][product_data][name]=Service - Residential 2000sqft" \
  -d "line_items[0][quantity]=1" \
  -d "metadata[customer_name]=John Smith" \
  -d "metadata[service_type]=Residential" \
  -d "metadata[sqft]=2000"

Returns a URL like https://buy.stripe.com/... you can send to the customer.

Create Checkout Session (more control)
bash
curl -s https://api.stripe.com/v1/checkout/sessions \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d mode=payment \
  -d "success_url=https://yourdomain.com/success" \
  -d "cancel_url=https://yourdomain.com/cancel" \
  -d "customer_email=customer@example.com" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][unit_amount]=250000" \
  -d "line_items[0][price_data][product_data][name]=Service - Residential" \
  -d "line_items[0][quantity]=1" \
  -d "metadata[job_id]=JOB-0001-001" \
  -d "metadata[estimate_amount]=2500"

Unit amount is in cents: $2,500.00 = 250000.

Create Invoice (for NET-30 billing)
bash
# Step 1: Create invoice
INVOICE=$(curl -s https://api.stripe.com/v1/invoices \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d customer=$CUSTOMER_ID \
  -d "description=Service - Residential")
INVOICE_ID=$(echo "$INVOICE" | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

# Step 2: Add line item
curl -s https://api.stripe.com/v1/invoiceitems \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d customer=$CUSTOMER_ID \
  -d invoice=$INVOICE_ID \
  -d amount=250000 \
  -d currency=usd \
  -d "description=Service - Residential 2000sqft - Standard Region"

# Step 3: Finalize and send
curl -s https://api.stripe.com/v1/invoices/$INVOICE_ID/finalize \
  -H "Authorization: Bearer $STRIP...KEY"
curl -s https://api.stripe.com/v1/invoices/$INVOICE_ID/send \
  -H "Authorization: Bearer $STRIP...KEY"
Check Payment Status
bash
curl -s https://api.stripe.com/v1/checkout/sessions/$SESSION_ID \
  -H "Authorization: Bearer $STRIP...KEY" | python3 -m json.tool
# Look for "payment_status": "paid"
List All Payments
bash
curl -s "https://api.stripe.com/v1/payment_intents?limit=10" \
  -H "Authorization: Bearer $STRIP...KEY" | python3 -m json.tool
Refund (if needed)
bash
curl -s https://api.stripe.com/v1/refunds \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d payment_intent=$PI_ID \
  -d amount=250000  # partial refund amount in cents, omit for full

Integration Patterns

  1. Agent runs estimator-engine skill to calculate price
  2. Agent creates Stripe payment link for that amount
  3. Agent stores payment link URL in CRM (crm-lite)
  4. Agent emails link to customer via email skill
  5. Agent monitors payment status and updates CRM when paid
Pattern 2: Invoice -> Email -> Track (NET-30)
  1. Agent creates Stripe customer
  2. Agent creates invoice with line items
  3. Agent finalizes and sends invoice (Stripe emails customer)
  4. Agent logs invoice ID in CRM
  5. Agent checks payment status daily via cron job
Show full SKILL.md (227 more words)Show less
Pattern 3: Agent Pays for Its Own SaaS (Hackathon Angle)
  1. Agent has Stripe Connected Account
  2. Agent creates payment link for a service
  3. Customer pays -> funds land in business Stripe account
  4. Agent uses Stripe to pay for Base44, Mailchimp, or other SaaS
  5. Demonstrates "agent that earns and spends real money"

Quick Start: Full Estimate-to-Payment Flow

bash
# 1. Get customer info from CRM
CUSTOMER_NAME="John Smith"
CUSTOMER_EMAIL="john@example.com"
SQFT=2000
REGION="Standard"
# Price from estimator: 2000sf * $1.40/sf = $2,800 (example — use your configured rates)
AMOUNT=280000  # $2,800.00 in cents

# 2. Create Stripe customer
CUSTOMER=$(curl -s https://api.stripe.com/v1/customers \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d name="$CUSTOMER_NAME" \
  -d email="$CUSTOMER_EMAIL")
CUSTOMER_ID=$(echo "$CUSTOMER" | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

# 3. Create payment link
LINK=$(curl -s https://api.stripe.com/v1/payment_links \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][unit_amount]=$AMOUNT" \
  -d "line_items[0][price_data][product_data][name]=Service - Residential $SQFT sqft" \
  -d "line_items[0][quantity]=1" \
  -d "metadata[customer_id]=$CUSTOMER_ID" \
  -d "metadata[sqft]=$SQFT" \
  -d "metadata[region]=$REGION")
PAYMENT_URL=$(echo "$LINK" | python3 -c "import sys,json; print(json.load(sys.stdin)['url'])")

echo "Payment link: $PAYMENT_URL"

Webhooks (for automated payment confirmation)

bash
# Create webhook endpoint
curl -s https://api.stripe.com/v1/webhook_endpoints \
  -H "Authorization: Bearer $STRIP...KEY" \
  -d "url=https://yourdomain.com/webhook/stripe" \
  -d "enabled_events[]=checkout.session.completed" \
  -d "enabled_events[]=invoice.paid" \
  -d "enabled_events[]=payment_intent.payment_failed"

Test Cards (for demo)

  • Successful payment: 4242 4242 4242 4242 (Visa)
  • Requires authentication: 4000 0027 6000 3184
  • Declined payment: 4000 0000 0000 0002
  • Any future date for expiry, any CVC, any ZIP

Common Pitfalls

  • Amounts are in cents, not dollars: $2,500 = 250000, not 2500
  • Test mode vs Live mode: Always verify you're using sk_test_ keys for demo
  • Don't store customer card data: Never log full card numbers; Stripe handles PCI compliance
  • Webhook signature verification: For production, verify Stripe-Signature header
  • Rate limits: Stripe allows ~100 read/sec and ~100 write/sec per key
  • Currency must be lowercase: usd not USD
  • Price tiers from estimator: Match the estimator-engine output exactly to avoid billing errors

Verification Checklist

  • STRIPE_SECRET_KEY set in environment
  • Can create customer (test mode)
  • Can create payment link and get URL
  • Can create checkout session
  • Can create and send invoice
  • Can check payment status
  • Test card payment succeeds with 4242 card
  • Payment updates CRM record (integration with crm-lite)
  • Invoice email reaches customer (integration with email skill)

© hewi333, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/stripe-payments of hewi333/Mom-n-Pop-Skills.

Open the folder on GitHubat commit 70a2273

Compare with similar skills

Stripe Payments next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Stripe Payments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stripe Payments this skillhewi333/Mom-n-Pop-Skills122—~2.1kAutomated safety check: NotesMIT
Cashier Stripe Developmentluadotsh/lua3431 repos~1.2kAutomated safety check: PassMIT
Convex HTTP Actionswaynesutton/builder-skills406—~2.6kAutomated safety check: PassApache-2.0
Stripe Patternsbybren-llc/safe-agentic-workflow423—~1.2kAutomated safety check: PassMIT
Billingtrycompai/comp2k—~824Automated safety check: PassAGPL-3.0
Stripeasgeirtj/system_prompts_leaks69k—~557Automated safety check: PassCC0-1.0

Similar skills

  • Handles Laravel Cashier Stripe integration including subscriptions, webhooks, Stripe Checkout, invoices, charges, refunds, trials, coupons, metered billing, and payment failure handling.

    343 GitHub starsUsed in 1 repo~1.2k tokens
    Backend & APIsAuto-check passed
  • Convex HTTP Actions

    waynesutton/builder-skills

    Adds HTTP endpoints in convex/http.ts: webhook receivers with signature checks, REST style routes, CORS, auth headers, streaming responses, and file uploads over HTTP.

    406 GitHub stars~2.6k tokensUpdated 13 days ago
    Backend & APIsAuto-check passed
  • Stripe Patterns

    bybren-llc/safe-agentic-workflow

    Stripe payment integration patterns for checkout flows, webhooks, and subscriptions.

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Billing

    trycompai/comp

    A skill your agent uses when changing Comp AI billing, Stripe products/prices, subscription checkout, org payment methods, entitlements, usage ledgers, invoices, or billing webhooks.

    2k GitHub stars~824 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Stripe

    asgeirtj/system_prompts_leaks

    Manage a merchant's Stripe customers, products, coupons, promotion codes, payments, invoices, and recurring subscriptions.

    69k GitHub stars~557 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Stripe

    CraftOS-dev/CraftBot

    Stripe API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub starsUsed in 1 repo~4.1k tokens
    Backend & APIsAuto-check passed

More from hewi333/Mom-n-Pop-Skills

All 13 skills in this repo
  • Construction Business Agent

    hewi333/Mom-n-Pop-Skills

    Runs a construction company's back office by bridging Gmail, Drive and JobTread: routing email attachments to the PM system, checking project status and sending daily Telegram briefings.

    122 GitHub stars~2.3k tokensUpdated 29 days ago
    Auto-check: notes
  • Lead-to-Payment Sales Flow

    hewi333/Mom-n-Pop-Skills

    Runs a small service business lead from intake through estimate, owner approval over Telegram, Stripe payment link and customer email draft to payment tracking.

    122 GitHub stars~2.8k tokensUpdated 29 days ago
    Auto-check: notes
  • QuickBooks Online Integration

    hewi333/Mom-n-Pop-Skills

    Connects a small business to QuickBooks Online for customers, estimates, invoices and payments, using Intuit OAuth 2.0 with token refresh and sandbox or production setups.

    122 GitHub stars~1.9k tokensUpdated 29 days ago
    Auto-check passed
  • Hermes Production Gateway Operations

    hewi333/Mom-n-Pop-Skills

    Procedures for changing the model, restarting and quietly tuning a live Hermes gateway that serves end-users on messaging platforms such as Telegram.

    122 GitHub stars~2k tokensUpdated 29 days ago
    Auto-check: warnings
  • CRM Lite

    hewi333/Mom-n-Pop-Skills

    A skill your agent uses when tracking customer interactions, managing leads, or building a lightweight CRM for small businesses without dedicated CRM software.

    122 GitHub stars~1.5k tokensUpdated 29 days ago
    Auto-check passed
  • Estimator Engine

    hewi333/Mom-n-Pop-Skills

    A skill your agent uses when calculating service estimates for jobs.

    122 GitHub stars~3.1k tokensUpdated 29 days ago
    Auto-check passed

Works with

Categories

Questions about Stripe Payments

What does Stripe Payments do?

Create Stripe checkout sessions, payment links, invoices, and customers via Stripe REST API. Stripe Payments is an agent skill from hewi333/Mom-n-Pop-Skills. Create Stripe checkout sessions, payment links, invoices, and customers via Stripe REST API.

When should I use Stripe Payments?

Stripe Payments fits situations like: processing payments; sending invoices; managing customer billing for a service business.

How do I install Stripe Payments in Claude Code?

Run `npx skills add hewi333/Mom-n-Pop-Skills --skill stripe-payments -a claude-code`. Or copy the skill folder (skills/stripe-payments in hewi333/Mom-n-Pop-Skills) into .claude/skills/stripe-payments in your project. Claude Code loads it when a task matches its description.

How do I install Stripe Payments in Codex?

Run `npx skills add hewi333/Mom-n-Pop-Skills --skill stripe-payments -a codex`. Or copy the skill folder (skills/stripe-payments in hewi333/Mom-n-Pop-Skills) into .agents/skills/stripe-payments in your project. Codex loads it when a task matches its description.

Can I use Stripe Payments in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hewi333/Mom-n-Pop-Skills --skill stripe-payments -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/stripe-payments, .gemini/skills/stripe-payments, .github/skills/stripe-payments and .opencode/skills/stripe-payments in your project.

What does Stripe Payments need to run?

Going by SKILL.md and its folder, Stripe Payments needs the command-line tools its instructions call (curl, python3 and stripe) and credentials named STRIPE_SECRET_KEY. Our summary lists: Python 3; A credential in STRIPE_SECRET_KEY.

Does Stripe Payments access the network?

SKILL.md names 3 domains. In commands or code: api.stripe.com, buy.stripe.com and github.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Stripe Payments safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Stripe Payments use?

Stripe Payments is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Stripe Payments use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Stripe Payments?

Skills that share tags, products or a category with Stripe Payments: Cashier Stripe Development (luadotsh/lua, 343 stars), Convex HTTP Actions (waynesutton/builder-skills, 406 stars), Stripe Patterns (bybren-llc/safe-agentic-workflow, 423 stars) and Billing (trycompai/comp, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stripe Payments?

hewi333 (a GitHub user) maintains it in hewi333/Mom-n-Pop-Skills, which has 122 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 11, 2026.

Source: hewi333/Mom-n-Pop-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.