paypal-integration
Build PayPal checkout and subscriptions
You need a reliable PayPal payment flow that handles checkout, subscriptions, and refunds. This skill provides clear steps for API calls, IPN verification, and sandbox testing.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "paypal-integration". Provide a PayPal IPN verification checklist.
Expected outcome:
- Receive POST data and preserve all fields
- Add cmd=_notify-validate to the payload
- POST back to the PayPal IPN endpoint
- Accept only VERIFIED responses
- Log and ignore duplicate transaction IDs
Using "paypal-integration". How do I create a subscription plan?
Expected outcome:
- Create a product first via the Products API
- Define a billing plan with pricing and cycle details
- Activate the plan to make it available
- Create a subscription using the plan ID
- Redirect the subscriber to the approval URL
Using "paypal-integration". What are common PayPal checkout mistakes?
Expected outcome:
- Trusting client callbacks without server verification
- Processing IPN messages without checking for duplicates
- Using sandbox credentials in production environment
- Not handling all payment states (completed, refunded, charged back)
- Hardcoding values instead of using configuration
Security Audit
SafeDocumentation-only skill providing PayPal integration guidance. All static findings are false positives: 'C2 keywords' refers to PayPal credential variables (client_id, client_secret); 'weak cryptographic algorithm' are scanner artifacts; 'Ruby/shell backtick execution' are markdown code block delimiters. Network URLs are legitimate PayPal API endpoints expected in payment documentation.
Risk Factors
🌐 Network access (3)
Quality Score
What You Can Build
Add checkout flow
Map client button setup, server order creation, and capture verification.
Plan recurring billing
Define plan creation, subscription approval, and renewal handling.
Handle refunds and disputes
Document refund creation, chargeback handling, and status checks.
Try These Prompts
Create a concise checklist for adding PayPal Smart Buttons and server side capture verification.
Outline the IPN verification flow and idempotency checks for a Flask backend.
List the API steps to create a product, plan, and subscription, and return the approval URL.
Describe the server steps to issue a partial refund and retrieve refund details.
Best Practices
- Verify IPN messages before processing any payment action
- Use sandbox mode for all testing before production deployment
- Make endpoints and credentials configurable via environment variables
Avoid
- Trusting client callbacks without server verification
- Processing IPN messages without idempotency checks
- Mixing sandbox and production credentials
Frequently Asked Questions
Is this compatible with the PayPal REST API?
What are the limits of this skill?
Can I integrate this with my existing backend?
Does it access or store my data?
What should I check if IPN verification fails?
How does this compare to PayPal SDKs?
Developer Details
Author
wshobsonLicense
MIT
Repository
https://github.com/wshobson/agents/tree/main/plugins/payment-processing/skills/paypal-integrationRef
main
File structure
📄 SKILL.md