WHEN YOUR AGENT SHOULD USE IT
USE FOR
- Pay another business by its Stripe Profile handle.
- Find or verify a recipient in the Stripe Directory.
- Check whether an agent can pay a Stripe business.
Documents
This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.
stripe pay
Use stripe pay to send money from the authenticated Stripe business to another Stripe business identified by a Stripe Profile 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. In addition:
- The sender needs a funded financial account.
- The receiver needs an eligible transfer destination linked to their Stripe Profile.
If the user needs details about financial accounts, read Money Management. 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
- Don’t send money unless the user explicitly asks you to make the transfer.
- Before running a command that can send money, show the exact
stripe pay ...command you plan to run and get confirmation. - Use
--agentor--jsonfirst so the user can review the transfer details. - Don’t pass
-yor--yesuntil after the user confirms the reviewed transfer. - 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.
- 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 |
| Review, send, handle approval, resume, or dry-run a transfer | stripe pay CLI reference |
| Create or manage a Stripe Profile, including a recipient’s transfer destination | Stripe Profile |
| Set up or understand an eligible financial account | Money Management |
Handle setup errors
Don’t continue the transfer when stripe pay reports missing setup. Explain what’s missing and give the user the corresponding next step. Before explaining how to resolve the error, read the documentation for the missing requirement in the workflow table:
- If the sender is missing a Stripe Profile, tell the user to create one.
- If the sender is missing an eligible financial account, tell the user to set up Global Payouts with an eligible financial account.
- If the sender is missing both requirements, tell the user to complete both setup steps before trying the transfer again.
- If the recipient doesn’t have an eligible transfer destination linked to their Stripe Profile, tell the user that the recipient must complete that setup before the transfer can proceed. Don’t retry the transfer until the recipient’s setup is corrected.
- If the recipient is missing or invalid, read and follow the Stripe Directory agent workflow. If the user can provide the recipient’s exact Stripe Profile handle or network ID, ask them for it.
For sender setup, direct the user to the relevant Dashboard page:
- To create a Stripe Profile, open https://dashboard.stripe.com/profiles and click Get started.
- To set up Global Payouts with an eligible financial account, open https://dashboard.stripe.com/balance/financial-accounts and click Get started.
Installation
Install as a Claude Code plugin
Run this in a terminal, from your project folder. It installs Stripe's plugin for Claude Code, which brings this skill and Stripe's other skills, sets up the Stripe MCP server and keeps the skills up to date. Stripe's docs also offer an automatic setup: install the Stripe CLI (npm install -g @stripe/cli@latest), then run stripe agent setup. It detects which agents you use (Claude Code, Codex, Cursor, Grok, Kiro, OpenClaw) and sets up the matching plugin for each.
- 01
claude plugin install stripe@claude-plugins-official
BEFORE IT WILL WORK
2 FOR YOU- 01The Stripe CLI
Transfers run through the Stripe CLI's pay command from your Stripe business. Install the CLI before asking for a transfer.
- 02A Stripe Profile and a funded financial account
You and the recipient both need a Stripe Profile, and you need a funded financial account. Set them up from the Profiles and Financial accounts pages of the Stripe Dashboard.
License
Licensed under MIT— you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub →