# Prompt de integración SolintPay (listo para pegar en tu IA)

Copia el bloque de abajo y pégalo en tu asistente de desarrollo (Claude Code,
Cursor, Copilot). Reemplaza lo que está entre `<...>` con tus datos.

---

```
Integra SolintPay (pasarela de pagos venezolana) en este proyecto.

CONTEXTO COMPLETO: descarga y lee https://solintpay.vercel.app/docs/llms-full.txt
— ahí está TODO: auth, endpoints, webhooks, errores y datos de prueba. La fuente
de verdad de la API es https://solintpay.vercel.app/docs/openapi.yaml

DATOS DE MI INTEGRACIÓN:
- Base URL: https://solintpay.vercel.app
- API key sandbox: usa la variable de entorno SOLINTPAY_API_KEY (NUNCA la
  hardcodees; yo la configuraré con el valor sk_test_... que me dio SolintPay)
- Mi stack: <Node/Express | Next.js | PHP | Python | ...>
- Lo que quiero cobrar: <ej. reservas de canchas, productos, suscripciones>

QUÉ CONSTRUIR:
1. Un módulo/servicio SolintPay con: crearCobro(metodo, monto, datosCliente),
   consultarCobro(id) y reversarCobro(id). Métodos: "c2p_bnc" (Pago Móvil,
   requiere cedula/telefono/banco/token del cliente), "vpos_bnc" (tarjeta
   nacional débito/crédito, requiere objeto tarjeta; el número/cvv/pin solo viajan
   a la API, nunca se guardan ni loguean) y "stripe_card" (tarjeta internacional:
   redirigir al checkout_url que devuelve la API).
2. Un endpoint webhook POST /webhooks/solintpay que VERIFIQUE la firma
   HMAC-SHA256 (header X-SolintPay-Signature, formato "sha256=<hex>", secret en
   env SOLINTPAY_WEBHOOK_SECRET, comparación timing-safe sobre el body CRUDO)
   y sea idempotente usando el header X-SolintPay-Delivery-Id.
3. Manejo de errores por código (token_incorrecto, fondos_insuficientes,
   metodo_no_disponible, idempotency_conflict, etc.) con mensajes claros al usuario.
4. Header Idempotency-Key (UUID) en todos los POST.

VERIFICACIÓN (hazla de verdad):
- GET /v1/ping con la API key debe devolver { ok: true }.
- Crea un cobro c2p_bnc de prueba con los fixtures del sandbox (cedula V23000760,
  telefono 584242207524, banco 0191, token 9982783). En sandbox el banco VALIDA
  (no ejecuta), así que debe responder exitoso. Si con esos fixtures devuelve
  token_incorrecto, el comercio probablemente está en modo producción — pídele a
  SolintPay que lo devuelva a sandbox.
- Crea un cobro stripe_card de 5 USD y confirma que la respuesta trae checkout_url.

PASO A PRODUCCIÓN (para después, no ahora): el código NO cambia. Solo se cambia la
API key sk_test_... por sk_live_... en SOLINTPAY_API_KEY y se usan datos reales del
cliente (su token real, no los fixtures). El ambiente lo deciden la key y el modo
del comercio, que SolintPay activa tras aprobar el KYC.

Sigue las convenciones de mi proyecto. No inventes endpoints: usa solo los del
OpenAPI. Cuando termines, dime exactamente qué variables de entorno necesito
configurar y cómo probar cada flujo.
```
