value: req.body.total en un pedido de PayPal permite a un comprador pagar 0.01 por cualquier cosa, y una ruta de webhook que marca pedidos como pagados sin llamar a verify-webhook-signature permite a cualquiera enviar un PAYMENT.CAPTURE.COMPLETED falso. Este skill encuentra esos errores y otros diez errores de integración de PayPal antes de que aceptes pagos reales, y te explica cómo corregir cada uno.

Tu agente ejecuta un escáner sobre tu código de servidor (JavaScript y TypeScript, Python, PHP, Ruby, Java, C#, Go), páginas y componentes (plantillas HTML, JSX/TSX, Vue, Svelte), archivos .env, configuración de la app y manifiestos de dependencias que mencionen PayPal, tipos de eventos de webhook de PayPal o campos de IPN. Sigue los valores de la solicitud a través de asignaciones, desestructuración, envoltorios simples y parámetros de funciones auxiliares, de modo que un precio buscado en el servidor con un ID enviado por el cliente no se reporta, cuenta la última asignación antes de un uso y un importe de donación comprobado contra tus valores predefinidos o límites se da por bueno. Evalúa cada ruta de webhook por separado (cuentan los middleware, guards y llamadas de verificación), distingue el código del navegador del código del servidor y revisa todo el proyecto antes de considerar de confianza una captura en el navegador. Conoce los modelos del PayPal Server SDK, el cuerpo REST de Orders v2, los helpers actions del JavaScript SDK y checkout.js. Nunca ejecuta tu código ni llama a PayPal. Devuelve BLOCK, REVIEW o NOT FLAGGED, con el archivo, la línea, el motivo y un enfoque más seguro. Los secretos nunca se muestran.

Qué comprueba

BLOCK (corregir antes de publicar)

• P01: el secreto de cliente en una variable de entorno pública (NEXT_PUBLIC_, VITE_, REACT_APP_ y similares), un bloque env de Next.js, un define del bundler, la configuración pública de runtime de Nuxt o código del navegador, o una solicitud de token OAuth desde el navegador
• P02: secretos de cliente de PayPal, contraseñas o firmas de la API NVP/SOAP, tokens de acceso, credenciales Basic o tokens de producción de Braintree escritos en el código o en configuración confirmada en el repositorio, incluidos valores literales de respaldo y .env.example
• P03: importe, moneda o purchase units del pedido tomados de la solicitud sin una comprobación de lista permitida o de límite, sumados a partir de precios enviados por el cliente, o todo el cuerpo de la solicitud pasado a PayPal
• P04: actions.order.capture() en el navegador cuyo resultado se envía a tu servidor o a una página de éxito, sin código de servidor que consulte el pedido a PayPal o verifique un webhook
• P05: rutas de webhook sin verificación de firma (Express, Next.js, NestJS, Flask, Django, Laravel, Rails, Go) y listeners de IPN sin la confirmación cmd=_notify-validate

REVIEW (revisar antes del lanzamiento)

• P11: hosts de sandbox o modo sandbox en la configuración de producción, o modo live apuntando a un host de sandbox
• P12: SDK de PayPal obsoletos o abandonados (paypal-rest-sdk, @paypal/checkout-server-sdk, paypalrestsdk, los antiguos SDK de PHP, Ruby, .NET y Java, checkout.js)
• P13: capturas en el servidor que marcan pedidos como pagados o hacen la entrega sin comprobar COMPLETED
• P14: pedidos creados en el navegador con actions.order.create()
• P15: listeners de IPN que omiten las comprobaciones de payment_status, receiver y mc_gross
• P16: comprobación de certificados TLS desactivada en código que se comunica con PayPal
• P17: registro del PayPal Server SDK con cabeceras sensibles sin enmascarar, lo que escribe el token de acceso en los logs

Qué incluye

• El escáner (Python 3.9+, solo biblioteca estándar)
• Una guía de reglas con el motivo, el enfoque más seguro y el enlace a la documentación oficial de PayPal para cada regla
• Un proyecto de ejemplo arriesgado y otro seguro, y el informe real que el escáner genera sobre el arriesgado

Limitaciones

Lee cada archivo tal como está escrito. No sigue los valores que pasan por otros módulos, bases de datos o mecanismos internos del framework, los valores de la solicitud en Java, C# y Go solo se siguen a través de parámetros @RequestBody y [FromBody], y los ajustes del panel (suscripciones a webhooks, credenciales live, preferencias de cobro) no son visibles. P04 solo ve los archivos que escaneas, así que escanea todo el proyecto. El almacenamiento seguro de métodos de pago (vaulting), los pagos a terceros y la lógica de suscripciones no se comprueban más allá de las reglas anteriores. NOT FLAGGED no es una garantía.

Contenido

Un archivo ZIP con 22 archivos: SKILL.md, el escáner en scripts/ (7 archivos de Python), references/rules.md (cada regla con su motivo y enfoque más seguro) y examples/ (12 archivos de ejemplo más report.md, la salida real del escáner sobre el ejemplo arriesgado).

Cómo usarlo: Es un skill para agentes: una carpeta con un archivo SKILL.md y scripts de Python que un agente de programación con IA como Claude Code, Cursor o Codex CLI puede ejecutar. Descomprímelo en la carpeta de skills de tu agente (para Claude Code: ~/.claude/skills/) y luego pide a tu agente que revise tu proyecto. Los scripts también funcionan por sí solos con Python 3.9 o posterior, sin nada que instalar. Solo leen tus archivos: sin acceso a la red y sin enviar nada a ninguna parte.