PlugWiki

paypal-integration skill for Claude Code: add PayPal checkout

Teaches Claude to add PayPal payments to your app, from checkout buttons to subscriptions and refunds, for developers building a store or billing flow.

Installs
11.2K
on skills.sh
Stars
42.1K
on GitHub
Files
1
besides SKILL.md
Updated
Oct 2026
last repo commit

The skill gives Claude a PayPal playbook for one-time checkout, subscriptions, refunds and payment notifications. SKILL.md has the core concepts and a quick start with a JavaScript Smart Buttons front end and a Python back end. A second file, references/details.md, has worked examples for order creation, IPN handling, subscription plans, refunds and error handling.

It triggers when you build PayPal payments, process online transactions or set up an e-commerce checkout. It bundles no scripts and runs nothing itself. The code it writes calls PayPal's REST API with your client ID and secret, so test in sandbox mode first.

Good for

  • Developers adding PayPal as a payment option to a web app
  • Teams building subscriptions or recurring billing on PayPal
  • Engineers who handle PayPal refunds and payment notifications

Install paypal-integration

Claude Code

  1. 1

    Copy this prompt.

    Install the paypal-integration skill in Claude Code. Run this command:

npx skills add wshobson/agents --skill paypal-integration

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Pick the skills CLI if you only want this skill. The plugin also installs 3 other payment skills and 1 payment-integration agent. You need PayPal developer sandbox credentials to test what Claude writes.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Integrate PayPal payment processing with support for express checkout, subscriptions, and refund management. Use when implementing PayPal payments, processing online transactions, or building e-commerce checkout flows.

Sections in SKILL.md

  1. When to Use This Skill
  2. Core Concepts
  3. 1. Payment Products
  4. 2. Integration Methods
  5. 3. IPN (Instant Payment Notification)
  6. Quick Start
  7. Detailed patterns and worked examples
  8. Testing

Key facts

Author
Seth Hobson (wshobson)
Repository
wshobson/agents
Installs on skills.sh
11,156 as of 2026-11-02
GitHub stars
42,081 for the whole wshobson/agents repo
License
MIT (repo LICENSE and plugin.json)
Last repo commit
2026-10-30
What is inside
2 files including SKILL.md: SKILL.md and references/details.md. It bundles no scripts.
Part of
The payment-processing plugin: 4 skills and 1 agent, with no hooks or .mcp.json in its folder
Needs
A PayPal developer account with sandbox credentials (client ID and secret) to run the sample code

What it includes

  • One-time payments with the express checkout flow

    The quick start shows Smart Payment Buttons in the browser and an order capture on the server. Guests and PayPal account holders can pay.

    Try: “Add a PayPal checkout button to my Flask store.”

    Write · PayPal Checkout

  • Recurring billing with plans and automatic renewals

    references/details.md shows how to create a billing plan through the REST API.

    Try: “Set up a monthly PayPal subscription plan for my app.”

    Write · PayPal Subscriptions

  • Create a refund for a captured payment and look up refund details

    The example sends the refund request to PayPal, either for the full amount or a part of it.

    Try: “Write a function that refunds part of a PayPal capture.”

    Write · Refund workflows

  • Verify and process Instant Payment Notifications

    The example sends the notification back to PayPal to verify it, then handles statuses such as Refunded.

    Try: “Handle PayPal payment notifications safely in my backend.”

    Network · IPN handling

  • A wrapper that turns network and API errors into one error type

    Error handling

  • Test with sandbox credentials and test buyer and seller accounts

    SKILL.md says to create the test accounts at developer.paypal.com.

    Testing in sandbox

From the official docs

Permissions

Medium risk

The skill writes code that can create PayPal orders, subscriptions and refunds with your credentials. Test in sandbox, keep secrets out of chat, and review the code before you go live.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • The code it writes can take payments and send refunds

    The sample code switches between sandbox and live with one setting. Live mode charges real buyers and live refunds return real money, so test in sandbox and review the code before you switch. github.com

  • It works with your PayPal client secret

    The examples take a client ID and secret. Our advice: keep them in environment variables or a secrets manager, and do not paste live credentials into a chat. github.com

  • Sample code is a starting point

    The quick start uses the paypalrestsdk Python package in one place and plain requests calls in references/details.md. Check both against the current PayPal docs before you ship. github.com

Technical details
Turning on read-onlyThe skill defines no read-only switch. It bundles no scripts.
Talks toapi-m.sandbox.paypal.com and api-m.paypal.com (REST API in the sample code). www.paypal.com (JavaScript SDK in the quick start). ipnpb.sandbox.paypal.com (IPN verification in the sample code)
Scopes

  • Writes payment code in your project when you ask for it

  • The code it writes uses your PayPal client ID and client secret

  • The sample code can create orders, subscription plans and refunds through the PayPal REST API

Questions

What does the paypal-integration skill do?

It gives Claude PayPal guidance and sample code for one-time checkout, subscriptions, refunds and payment notifications. Claude uses it when you build PayPal payments or an e-commerce checkout.

How do I install paypal-integration?

Use the install box at the top of this page. The skills CLI installs just this skill. The payment-processing plugin installs it with 3 other payment skills and 1 agent.

Does it need an API key?

The skill itself needs no key. The PayPal code it writes needs a client ID and secret from your PayPal developer account, and SKILL.md says to test with sandbox credentials and test buyer and seller accounts.

Is it safe to install?

It is two guidance files and bundles no scripts. The risk is in the code Claude writes: it can create payments and refunds with your PayPal credentials. Start in sandbox, keep secrets out of chat and read the code before you go live.

Can it move real money?

Only if you run the code it writes against your live PayPal credentials. The sample code defaults to sandbox, and a mode setting selects the live API, where orders charge buyers and refunds pay them back.

Does it handle webhooks?

SKILL.md lists "Handling PayPal webhooks (IPN)" and covers IPN, the payment notification system. references/details.md shows how to verify a notification with PayPal before acting on it.

Does it work in the Claude app or Codex?

The install box has a Claude app upload and a Codex route. Claude can write the code in chat, but you run and test it in your own project.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/payment-processing/skills/paypal-integration

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5
  1. wshobson/agents README · github.com
  2. wshobson/agents marketplace.json · github.com
  3. payment-processing plugin.json · github.com
  4. paypal-integration SKILL.md · github.com
  5. paypal-integration references/details.md · github.com

Updated Nov 2, 2026.