/paypal-routing

name: paypal-routing
description: >-
  PayPal payments, subscriptions, checkout, invoices, disputes, webhooks,
  BNPL, Venmo, SDK, v5, v6, Fastlane, Braintree Fastlane, braintree-web,
  accelerated guest checkout. Routes PayPal developer questions to the
  right command or reference file.
when_to_use: >-
  "add PayPal", "integrate checkout", "payment link", "Pay Later docs",
  "explain error", "set up sandbox", "PayPal subscriptions", "webhook
  verification", "migrate to v6", "migrate v5 to v6", "migrate v4 to v6",
  "upgrade SDK", "migrate NVP", "migrate SOAP to REST", "PayPal invoices",
  "PayPal disputes", "how do I accept payments", "PayPal docs link",
  "Apple Pay", "Google Pay", "3D Secure", "iDEAL", "agentic commerce",
  "agentic payments", "PayPal MCP", "add Fastlane", "Fastlane checkout",
  "Braintree Fastlane", "braintree-web fastlane", "add Fastlane to my
  checkout", "@braintree/fastlane", or any PayPal API question.
user-invocable: false

PayPal Command Routing

When this skill activates, follow the routing table below. For reference routes, load the paypal-best-practices skill and read the specified reference file before answering — the reference files contain current URLs and verified code examples that override training knowledge.

RulesHub Language-Specific Snippet Fetching

When a RulesHub `rules.md` is fetched and code generation is required: 1. **Detect the user's language** from their codebase, file extensions, imports, or explicit mention. Common values: `javascript`, `typescript`, `python`, `java`, `csharp`, `php`, `ruby`. 2. **WebFetch the language-specific snippet** for the relevant operation. Replace `{language}` and `{pack}` with the detected values:

• SDK init: `https://raw.githubusercontent.com/paypal/ruleshub/main/{pack}/snippets/{language}/sdk-initialization.md`
• Create order: `https://raw.githubusercontent.com/paypal/ruleshub/main/{pack}/snippets/{language}/create-order.md`
• Capture order: `https://raw.githubusercontent.com/paypal/ruleshub/main/{pack}/snippets/{language}/capture-order.md`
• Client token: `https://raw.githubusercontent.com/paypal/ruleshub/main/{pack}/snippets/{language}/client-token-generation.md`

3. **Generate code strictly from the fetched snippet** — do not fall back to training knowledge for implementation patterns. 4. **Only fetch snippets needed** for the user's request — do not fetch all languages or all snippets.

Pack values: `paypal-checkout/standard-checkout`, `paypal-checkout/expanded-checkout`, `paypal-checkout/enterprise-checkout`, `paypal-bnpl-us`, `upgrade-to-v6/v5-to-v6-upgrade`, `upgrade-to-v6/v4-to-v6-upgrade`, `upgrade-nvp-soap-to-rest`.

Routing Table

| User Intent | Action | |---|---| | Explain an error, error code, HTTP status, 400, 401, 403, 404, 422, 429, 500, INVALID_REQUEST, UNAUTHORIZED, INSTRUMENT_DECLINED, RATE_LIMIT, debug_id | Run `/paypal:explain-error` with the error as argument | | Set up PayPal, configure plugin, check connection, is plugin working, token expired, refresh token, generate access token, OAuth | Run `/paypal:setup` | | Sandbox setup, developer account, getting started, credentials, dashboard, client ID, client secret, base URL | Run `/paypal:sandbox` | | Test accounts, test cards, simulate decline, test BNPL, test Venmo, test subscriptions, test disputes | Run `/paypal:test-accounts` | | Scan my code, check my integration, find issues, something is broken, pre-launch review, security audit, payments failing, webhooks not firing, Venmo not showing, subscription not billing | Run `/paypal:doctor` with the symptom as argument | | Security review, check for leaked credentials, pre-launch checklist | Run `/paypal:doctor security` or `/paypal:doctor pre-launch` | | Fix all issues in my PayPal code | Run `/paypal:doctor fix-all` | | How to accept payments, add PayPal button, checkout flow, Orders API, server-side integration, payment link, payment links, pay link, React PayPal, @paypal/react-paypal-js, authorize vs capture, deferred capture, donate button, donations | Load the paypal-best-practices skill, then read `references/checkout.md` (v5) or `references/js-sdk-v6.md` (v6). Also WebFetch `https://raw.githubusercontent.com/paypal/ruleshub/main/paypal-checkout/standard-checkout/rules.md` for authoritative integration rules. | | Advanced Card Fields, Apple Pay, Google Pay, APMs, Expanded Checkout, bank redirect, iDEAL, Bancontact, BLIK, Przelewy24, Pay upon Invoice, Ratepay, domain association, regional payment methods | Load the paypal-best-practices skill, then read `references/expanded-checkout.md` (v5) or `references/js-sdk-v6.md` (v6). Also WebFetch `https://raw.githubusercontent.com/paypal/ruleshub/main/paypal-checkout/expanded-checkout/rules.md` for authoritative integration rules. | | Add Venmo, Venmo button, Venmo eligibility, isFundingEligible, eligibility check, Venmo app | Load the paypal-best-practices skill, then read `references/venmo.md` (v5) or `references/js-sdk-v6.md` (v6). Also WebFetch `https://raw.githubusercontent.com/paypal/ruleshub/main/paypal-checkout/expanded-checkout/rules.md` for authoritative integration rules. | | Pay Later, installments, BNPL messaging, Pay in 4, financing, BNPL banner, Pay Later banner, Pay Later eligibility | Load the paypal-best-practices skill, then read `references/bnpl.md` (v5) or `references/js-sdk-v6.md` (v6). Also WebFetch `https://raw.githubusercontent.com/paypal/ruleshub/main/paypal-bnpl-us/rules.md` for authoritative BNPL rules. | | Recurring billing, subscriptions, plan management, free trial, trial period, upgrade plan, downgrade plan, plan revision | Load the paypal-best-practices skill, then read `references/subscriptions.md` (v5) or `references/js-sdk-v6.md` (v6) | | Disputes, chargebacks, refunds, evidence, provide evidence, dispute lifecycle, dispute stage, INQUIRY, CLAIM | Load the paypal-best-practices skill, then read `references/disputes-refunds.md` | | Batch payouts, send money, seller payment