# Integrar con ayuda de una IA

Esta documentación está hecha para que la lea una persona **y** para que la lea un modelo. Si usas Claude, ChatGPT, Cursor o Copilot para escribir tu integración, dale estas direcciones en vez de pedirle que adivine.

## Lo que puedes darle a tu asistente

| Dirección                 | Qué es                                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| `https://docs.evetev.com/llms.txt`      | El índice: qué hay y dónde, en texto plano. Es por donde debería empezar.                              |
| `https://docs.evetev.com/llms-full.txt` | Toda la documentación en un solo archivo. Para pegarlo en el contexto de una vez.                      |
| `https://docs.evetev.com/cobros.md`     | Cualquier página, en Markdown crudo. Vale para todas: `https://docs.evetev.com/empezar.md`, `https://docs.evetev.com/webhooks.md`… |
| `https://docs.evetev.com/openapi.json`  | La especificación de la API, generada desde el mismo contrato que valida las peticiones.               |

Van con el dominio completo a propósito: una ruta suelta, pegada en un chat, no apunta a ninguna parte y el asistente se inventa el resto.

## Para pegarle de una vez

Si no quieres pensarlo, esto le sirve a cualquier asistente:

```text
Voy a integrar pagos con EvePay. La documentación está en https://docs.evetev.com/llms.txt
y toda junta en https://docs.evetev.com/llms-full.txt. Léela antes de escribir código: tiene
tres reglas que contradicen lo que hacen otras pasarelas.
```

Cada página del sitio tiene además un botón para copiarla en Markdown.

## Por qué no es lo mismo que darle la página web

Una página HTML lleva navegación, estilos y estructura que el modelo tiene que descartar, y en el camino se pierden cosas: una tabla se aplana, un bloque de código se mezcla con el texto. El Markdown es lo mismo que lee la persona, sin el ruido.

Y hay una diferencia que importa más: **estos archivos salen de la misma fuente que el sitio**. No son una copia que alguien actualiza cuando se acuerda. Si cambian, cambian los dos.

## Lo que conviene decirle

Tres cosas que un modelo acierta mal si nadie se las dice, porque son contrarias a lo que se ve en otras pasarelas:

- **En pesos colombianos no hay centavos.** `monto: 89000` son $ 89.000. Un modelo entrenado con Stripe multiplica por cien.
- **La llave va en el servidor.** No hay snippet de JavaScript para el navegador. Si tu asistente te propone uno, está inventando.
- **El pedido se despacha con el webhook**, no cuando el comprador vuelve a tu página.

## Comprueba lo que te escribió

Antes de mandar la primera petición de verdad, pásala por el ambiente de pruebas. Un cobro mal formado responde `400` con el detalle por campo, y eso es más rápido que leer el código generado línea por línea.