Skip to content

PayPal Integration

Guides an agent through adding PayPal checkout, subscriptions, IPN webhooks and refunds to a site or app.

Repository
wshobson/agents
Stars
42,095
Licence
MIT
Files
2 files

What it does

When installed, the agent gets a playbook for adding PayPal as a payment option to a website or app. It covers the main PayPal product types (one-time checkout, recurring subscriptions, payouts), the two integration styles (a JavaScript button on the front end, or direct REST API calls on the server), and how to handle asynchronous payment notifications (IPN). It includes sample frontend and Python backend code and a sandbox test outline, so the agent can write checkout code more reliably.

Great for

  • Developers adding PayPal checkout to an e-commerce site
  • Teams setting up PayPal subscriptions or recurring billing
  • Engineers who need a starting point for PayPal webhook or refund handling

Skip it if

  • Non-developers who want a finished payment setup with no code review, since the examples are partial and must be verified against current PayPal documentation
  • Projects that must follow PCI compliance or handle live card or account credentials without security review, because the sample code hardcodes placeholder client IDs and secrets and the agent may reproduce that pattern

Try asking

  • “Add a PayPal Smart Payment Button to my checkout page for a $25 product”
  • “Set up PayPal subscriptions for a monthly plan in my Node app”
  • “Write a backend endpoint that captures a PayPal order and records the transaction ID”
  • “Explain how to verify PayPal IPN notifications before fulfilling orders”
Step-by-step guide: how to use PayPal IntegrationInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    paypal-integration.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip paypal-integration.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip paypal-integration.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Always test with sandbox credentials and sandbox buyer accounts before switching to live mode
  • Verify payment status on the server (capture or webhook) rather than trusting the browser callback, and check the current PayPal docs since paypalrestsdk is legacy
  • Keep client secrets in environment variables or a secrets manager, never in frontend code or committed files

What's inside

  • references/details.md
  • SKILL.md

Redistributed unmodified from wshobson/agents under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.