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
You might also like
Get a professional evaluation of your nonfiction proposal and discover your unique market position. This skill analyzes your manuscript concept, competitive landscape, and target audience to identify what makes your book distinct. You'll receive actionable feedback on strengthening your proposal and strategic recommendations for positioning your work to agents, editors, and readers.
by mapleoao
Extract and analyze subsidiary rights from publishing contracts to identify licensing opportunities and forecast potential revenue. The skill automatically maps territories, durations, and restrictions while flagging conflicts and ambiguities. You'll get structured documentation, market-based revenue projections, and actionable licensing recommendations to maximize your subsidiary rights portfolio.
by mapleoao
Generate comprehensive production specifications, automated quality assurance checklists, and platform-specific requirements for your e-book publishing workflow. This toolkit creates standardized documentation that accelerates production, reduces formatting errors, and ensures compliance across Kindle, Apple Books, IngramSpark, and other platforms.
by mapleoao
Evaluate the visual hierarchy, design consistency, readability, and design compliance of your publication layouts. You'll receive detailed assessments of spacing, typography, color usage, alignment, and element positioning, along with actionable recommendations to enhance user experience and design coherence.
by mapleoao
You'll receive comprehensive proofreading feedback covering grammar, spelling, punctuation, syntax, and consistency issues. This skill evaluates your writing against industry-standard style guides (AP, Chicago, MLA, APA) and provides corrected passages with explanations. You'll also get actionable suggestions for tone, clarity, and readability improvements tailored to your document type.
by mapleoao
You can submit your nonfiction manuscript or proposal and receive a comprehensive editorial evaluation that assesses market viability, identifies structural gaps, and pinpoints what needs development before querying agents or publishers. The skill analyzes your work against current market trends, competitive titles, and publishing standards—then generates actionable feedback in minutes instead of waiting weeks for professional editors.
by mapleoao
Accelerate your Shopify app development from conception to deployment. You'll get step-by-step workflows for scaffolding new apps, integrating REST and GraphQL APIs, setting up webhooks, and managing authentication. This skill also helps you diagnose and fix common Shopify issues quickly, including API errors, webhook failures, and performance bottlenecks.
by mapleoao
You can architect secure, scalable payment flows that handle subscriptions, one-time charges, webhooks, and complex billing scenarios. This skill guides you through designing idempotent payment patterns, implementing robust error handling, and debugging production Stripe issues with confidence—from initial design through deployment.
by mapleoao