/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