
PayPal Integration Architect
Design PayPal payment flows, debug integration issues, and implement webhooks
What You Can Do
You can architect robust PayPal payment systems from scratch, including designing complete payment flows, implementing secure webhook handlers, and debugging integration issues. Claude provides step-by-step guidance on API authentication, error handling, and edge cases. You'll also get best practices for sandbox testing, production deployment, and transaction reconciliation.
Features
Design complete payment workflows from checkout to settlement with decision trees
Identify and fix common PayPal API errors, authentication issues, and configuration problems
Build secure, idempotent webhook handlers for payment notifications and event processing
Implement comprehensive error handling for declined payments, timeouts, and edge cases
Create validation checklists and credential management for safe production deployment
Apply authentication, signature verification, and encryption standards for payment processing
Design workflows to match PayPal transactions with database records and detect discrepancies
Example Output
Example 1: Payment Flow Architecture
Checkout Flow:
1. Create order via PayPal API
2. Redirect user to PayPal
3. Capture payment on return
4. Verify webhook notification
5. Fulfill order
Error Handling:
- Declined payment → Retry logic
- Timeout → Status polling
- Missing webhook → Recovery from DB
Example 2: Webhook Handler Debugging
Issue: Webhooks not being received
✓ Check signature verification (validate PayPal cert)
✓ Verify webhook URL is publicly accessible
✓ Review firewall/security group rules
✓ Test with PayPal webhook simulator
Example 3: Common Issues & Fixes
✓ INVALID_REQUEST_BODY → Validate JSON schema
✓ AUTHENTICATION_FAILURE → Verify API credentials
✓ PERMISSION_DENIED → Check seller account config
✓ RESOURCE_NOT_FOUND → Verify order ID format
What's Included
- SKILL.md: Full PayPal integration architecture guide with decision trees
- Payment flow templates: Ready-to-adapt checkout, subscription, and recurring billing flows
- Webhook handler boilerplate: Secure handler with signature verification and idempotency keys
- Error handling checklist: 25+ common PayPal errors with recovery strategies
- Debugging guide: Step-by-step troubleshooting for API and webhook issues
- Security checklist: API key management, webhook validation, and PCI compliance tips
- Testing worksheet: Sandbox test scenarios and production validation steps
- API reference quick links: Common endpoints and authentication patterns
Who It's For
- E-commerce developers building payment systems
- Backend engineers integrating PayPal into platforms
- Fintech engineers designing payment workflows
- DevOps engineers troubleshooting payment infrastructure
- Payment systems architects designing scalable solutions
Best For
- Architecting new PayPal payment flows
- Debugging integration and webhook issues
- Migrating from sandbox to production
- Implementing error handling and retries
- Setting up transaction reconciliation







