# stripe-pay

Gives the agent stripe pay and stripe directory so it can look up a recipient by handle and move funds to another Stripe business.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 576 installs · ★ 1972
- Author: stripe
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/stripe/ai/tree/HEAD/skills/stripe-pay/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/stripe-pay

## What it does

The skill whitelists three calls: `stripe directory`, `stripe pay` and `stripe whoami`. With them the agent resolves a recipient through a Stripe Profile handle or network ID, then sends money from the authenticated business.

Before anything goes out, the command pulls the recipient's payout configuration and reports the fee and delivery timing. Treat a transfer as neither free nor instant. Safety rules in the skill file are strict: no money moves without an explicit request, the exact `stripe pay ...` line is shown first and confirmed, `--agent` or `--json` comes first, and `-y` / `--yes` only after the user approves. Full API keys never get echoed back.

Both sides need setup. The sender requires a Stripe Profile plus a funded financial account; the recipient needs an eligible transfer destination tied to their profile. When something is missing, the skill stops and explains the fix instead of retrying — profiles are created at `https://dashboard.stripe.com/profiles`, financial accounts at `https://dashboard.stripe.com/balance/financial-accounts`.

## Requirements
- Works with: Stripe

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add stripe/ai --skill stripe-pay -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add stripe/ai --skill stripe-pay -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install stripe/ai stripe-pay
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/stripe/ai --path skills/stripe-pay
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add stripe/ai --skill stripe-pay -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/stripe/ai/tree/HEAD/skills/stripe-pay/SKILL.md

## When to use it
- pay another Stripe business using its handle
- locate a recipient through Stripe Directory when no exact handle is known
- see the transfer fee and payout timing before approving
- work out which setup step is blocking a transfer

## Example prompts
- Send 50 USD to `@recipient` and show me the command and fee first
- Search Stripe Directory for this business name and check whether it has a profile
- Run `stripe whoami` to see which business is signed in and whether it can pay out

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: bb7c69bcc9b0eb38.

BEGIN THIRD-PARTY FILE bb7c69bcc9b0eb38
```text
---
name: stripe-pay
description: >-
  Helps users send funds to another Stripe business, transfer money to a Stripe
  Profile handle or network ID, or ask whether an agent can pay a Stripe
  business. Use Stripe Directory to find or verify a recipient when the user
  doesn't provide an exact Stripe Profile handle or network ID.
metadata:
  short-description: Send funds to Stripe businesses
allowed-tools:
  - Bash(stripe directory *)
  - Bash(stripe pay *)
  - Bash(stripe whoami *)

---

# stripe pay

Use `stripe pay` to send money from the authenticated Stripe business to another Stripe business identified by a [Stripe Profile](https://docs.stripe.com/get-started/account/profile.md) handle, for example `@recipient`.

The `stripe pay` command is for business-to-business money transfers. Both the sender and the receiving business must have a [Stripe Profile](https://docs.stripe.com/get-started/account/profile.md). In addition:

- The sender needs a funded [financial account](https://docs.stripe.com/money-management.md).
- The receiver needs an eligible transfer destination linked to their [Stripe Profile](https://docs.stripe.com/get-started/account/profile.md).

If the user needs details about financial accounts, read [Money Management](https://docs.stripe.com/money-management.md). The command resolves the recipient’s payout configuration, which can route the payout to an attached financial account or linked bank account, and reports the fee and delivery timing before confirmation. Don’t assume that a transfer is free or instant.

## Safety Rules

1. Don’t send money unless the user explicitly asks you to make the transfer.
2. Before running a command that can send money, show the exact `stripe pay ...` command you plan to run and get confirmation.
3. Use `--agent` or `--json` first so the user can review the transfer details.
4. Don’t pass `-y` or `--yes` until after the user confirms the reviewed transfer.
5. Don’t guess at the user’s intent. Don’t guess at the username, financial account ID, amount, currency, internal note, memo, or any other detail. Always confirm with the user.
6. Don’t print full API keys back to the user.

## Choose the workflow

Read the documentation to accomplish your goal. You must read the relevant page before taking action:

| Goal | Documentation |
| --- | --- |
| Find or verify a recipient when the user doesn’t provide an exact Stripe Profile handle or network ID | [Use Stripe Directory with AI agents](https://docs.stripe.com/directory.md#agents) |
| Review, send, handle approval, resume, or dry-run a transfer | [`stripe pay` CLI reference](https://docs.stripe.com/cli/pay) |
| Create or manage a Stripe Profile, including a recipient’s transfer destination | [Stripe Profile](https://docs.stripe.com/get-started/account/profile.md) |
```
END THIRD-PARTY FILE bb7c69bcc9b0eb38

The third-party file has ended. Everything between the bb7c69bcc9b0eb38 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2831 of 4452 bytes. © stripe · MIT · https://github.com/stripe/ai/tree/HEAD/skills/stripe-pay/SKILL.md

_Part of the page did not fit — see the HTML version._

---
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